Функция GetOpenFileName создает Открыть общее диалоговое, позволяет пользователю указать диск, каталог и имя файла или набора файлов чтобы открыть.
(BOOL GetOpenFileName LPOPENFILENAME lpofn / / адрес структуры с инициализации / / данные);
Если пользователь указывает имя файла и нажимает кнопку « ОК », возвращается ненулевое значение. Буфер, который указывает член 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 в стиле проводника Открыть диалоговое окно "". Чтобы включить процедуру подключения, установите флаги 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 структуры.
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