CFileDialog клас інкапсулює Windows загальних файлу діалогове вікно. Загальні файл діалогових вікнах забезпечити легкий спосіб реалізації відкрити файл і зберегти як діалогове вікно коробки (а також інші діалогові вікна вибору файлів) у відповідності до стандартів Windows.
Ви можете використовувати CFileDialog "як є", з Конструктор, за умови, або ви можете отримати свій власний клас діалогове вікно з CFileDialog і писати конструктора відповідно до ваших потреб. У будь-якому випадку цих діалогових вікнах буде вести себе як стандартний Microsoft фонду клас діалогових вікон тому, що вони походять з класом CCommonDialog.
Використовувати CFileDialog об'єкта, спочатку створіть об'єкт за допомогою CFileDialog Конструктор. Після того, як побудували діалоговому вікні, можна настроїти або змінити будь-які значення в m_ofn структурі ініціалізувати значень або держави діалоговому вікні елементів керування. M_ofn структура є типу OPENFILENAME. Докладніше, перегляньте статтю на OPENFILENAME структури в документації Win32 SDK.
Після ініціалізації діалоговому вікні керування, викличте функцію член DoModal для відображення діалогового вікна і дозволяє користувачеві вводити шлях та ім'я файлу. DoModal повертає чи користувач вибрано ОК (IDOK), або кнопку "Скасувати" (IDCANCEL).
Якщо DoModal IDOK, використайте один з CFileDialogгромадських методи отримання відомостей, введених користувачем.
CFileDialog включає кілька захищених членів, які дозволять вам зробити власні обробки частка порушень, ім'я файлу, перевірка і список із сповіщення про зміни. Ці захищений члени, функції зворотного виклику, що більшість програм не потрібно використовувати, оскільки за замовчуванням обробки здійснюється автоматично. Повідомлення карта записи для цих функцій не є необхідним, оскільки вони є стандартним віртуальних функцій.
Щоб визначити, чи сталася помилка під час ініціалізації діалогового вікна та дізнатися більше про помилку можна використовувати функцію Windows CommDlgExtendedError.
Знищення об'єктів, CFileDialog обробляються автоматично. Це не є необхідним для виклику CDialog::EndDialog.
Щоб дозволити користувачеві вибрати кілька файлів, встановити прапор OFN_ALLOWMULTISELECT перед викликом DoModal. Потрібно вказати власні ім'я файлу буфер для розміщення повернулися список кілька імен файлів. Це можна зробити шляхом заміни m_ofn.lpstrFile вказівником в буфер, які ви виділяли, після того, будівництво CFileDialog, але перед викликом DoModal. Крім того, ви повинні встановити m_ofn.nMaxFile і кількість символів у буфері, вказав на m_ofn.lpstrFile.
CFileDialog спирається на в COMMDLG.DLL-файлом, який поставляється з Windows версії 3.1 і пізніше.
Якщо отримати новий клас з CFileDialogмапі повідомлення можна використовувати для обробки будь-яких повідомлень. Продовжити повідомлення за промовчанням, обробки, отримати класу з CWnd, додавання карти повідомлення до нового класу і забезпечити функцій-членів для нових повідомлень. Вам не потрібно надати гачок функція настроювання діалогового вікна.
Настроювання діалогового вікна, отримати класу з CFileDialog, надати діалоговому шаблон і додати повідомлення карти для обробки повідомлень повідомлення з розширеного керування. Будь-які необробленої повідомлення передається до базового класу.
Настроювання гачок функція не є обов'язковим.
Щоб отримати додаткові відомості про використання CFileDialog, перегляньте Загальних класів діалогове вікно в Visual C++ програміста керівництво.
# включити lt;afxdlgs.h>
|&Nbsp членів класу ; Базовий клас | Ієрархічна діаграма