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 в стиле проводника Открыть диалоговое окно "". Чтобы включить процедуру подключения, установите флаги 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