GetOpenFileName

Функція GetOpenFileName створює на Відкрити загальні діалоговому вікні, яке дає змогу вказувати на диск, каталог та ім'я файлу або набір файлів для відкриття.

(BOOL GetOpenFileName LPOPENFILENAME  lpofn / / адреса структури з ініціалізації / / даних);
 

Параметри

lpofn
Вказівник на структуру OPENFILENAME , що містить інформацію, що використовується для ініціалізації діалогового вікна. Коли GetOpenFileName повертається, ця структура містить інформацію про вибір користувача файл.

Повернення значень

Якщо користувач визначає ім'я файлу і натискання кнопки ОК , значення, що повертається, є ненульовим. Буфер, вказав на lpstrFile членом OPENFILENAME структура містить повний шлях та ім'я файлу, вказані користувачем.

Якщо користувач скасував або закриття відкритого діалогового вікна або виникає помилка, значення дорівнює нулю. Щоб отримати розширених відомостей помилку, зателефонуйте функцію CommDlgExtendedError , яка може повертати одне з таких значень:

CDERR_FINDRESFAILURE CDERR_NOHINSTANCE
CDERR_INITIALIZATION CDERR_NOHOOK
CDERR_LOCKRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADRESFAILURE CDERR_STRUCTSIZE
CDERR_LOADSTRFAILURE FNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILURE FNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILURE FNERR_SUBCLASSFAILURE

Зауваження

Починаючи з Windows 95 і Windows NT версії 4.0, за промовчанням відкрито діалогове вікно надає інтерфейс користувача функцій, які схожі на провідник Windows. Ви можете надати гачок процедуру OFNHookProc для Explorer стиль відкритого діалогового. Щоб дозволити процедури гачок, встановити позначки OFN_EXPLORER і OFN_ENABLEHOOK в OPENFILENAME структурі, член прапори і вказати адресу процедура гачок у lpfnHook член.

Windows 95 і Windows NT і надалі надавати підтримку старого стилю відкрито діалогове вікно для додатків, які хочуть зберегти інтерфейс користувача відповідно до Windows 3.1 або інтерфейсу користувача Windows NT 3.51. Щоб відобразити старого стилю відкрито діалогове вікно, включити процедуру гачок OFNHookProcOldStyle і переконатися, що OFN_EXPLORER прапор не налаштовано.

Щоб відобразити діалогове вікно, що дозволяє користувачеві вибрати каталог замість того, щоб файл, зателефонуйте в SHBrowseForFolder функції.

Windows CE: Не всі члени OPENFILENAME структури визначаються Windows CE. Докладніші відомості про визначене членам бачити посилання теми для OPENFILENAME структури.

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в commdlg.h.
Імпортувати бібліотеки:Використання comdlg32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії на Windows NT.

Дивіться також

Загальний огляд бібліотеки діалогового вікна, Загальні діалогового вікна функції, CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME, SHBrowseForFolder

Index