GetOpenFileName

BOOL GetOpenFileName( LPOPENFILENAME lpofn );

Возвращаемое значение

Если пользователь ввёл имя файла и нажал клавишу OK, возвращается ненулевое значение. Буфер, на который указывает переменная lpstrFile объекта структуры OPENFILENAME, содержит полный путь и имя файла, выделенного пользователем.

Если пользователь нажимает кнопку Отмена, закрывает диалоговое окно Открытие файла или в процессе выполнения данной функции возникает ошибка, возвращается нулевое значение. Для получения расширенной информации об ошибке вызывается функция CommDlgExtendedError, возвращающая одно из следующих значений: CDERR_FINDRESFAILURE, CDERR_INITIALIZATION, CDERR_LOCKRESFAILURE, CDERR_LOADRESFAILURE, CDERR_LOADSTRFAILURE, CDERR_MEMALLOCFAILURE, CDERR_MEMLOCKFAILURE, CDERR_NOHINSTANCE, CDERR_NOHOOK, CDERR_NOTEMPLATE, CDERR_STRUCTSIZE, FNERR_BUFFERTOOSMALL, FNERR_INVALIDFILENAME и FNERR_SUBCLASSFAILURE.

Аргументы

0. lpofn — указатель на объект структуры OPENFILENAME, содержащий информацию, используемую при инициализации диалогового окна. После завершения работы функции GetOpenFileName данный объект структуры хранит информацию о выделенных пользователем файлах.

Примечание

Функция GetOpenFileName создаёт стандартное диалоговое окно Открытие файла, позволяющее пользователю задать диск, директорий и имя одного или нескольких открываемых файлов.

Начиная с Windows 95 и Windows NT версии 4.0, используемое по умолчанию диалоговое окно Открытие файла имеет стиль Windows Explorer. Для данного стиля окон используется функция обратного вызова формата OFNHookProc. Для использования функции обратного вызова следует установить флаги OFN_EXPLORER и OFN_ENABLEHOOK в переменной Flags объекта структуры OPENFILENAME и занести в переменную lpfnHook указатель на функцию обратного вызова.

Windows 95 и Windows NT позволяют использовать стандартный стиль диалогового окна Открытие файла, обеспечивая единый стиль с приложениями, написанными под Windows 3.1 или Windows NT 3.51. При работе с данным стилем окон используется функция обратного вызова формата OFNHookProcOldStyle и не устанавливается флаг OFN_EXPLORER.

Для вывода диалогового окна, позволяющего пользователю выбирать директорий, а не файл, используется функция SHBrowseForFolder.

Описание данной функции содержится в файле заголовка comdlg.h. При работе с данной функцией следует включить в проект библиотеку comdlg32.lib.

GetOpenFileNamePreview

BOOL GetOpenFileNamePreview( LPOPENFILENAME lpofn );

Возвращаемое значение

Возвращает дескриптор выбранного файла.

Аргументы

0. lpofn — указатель на объект структуры OPENFILENAME, используемый для инициализации диалогового окна. При успешном завершении функции в данном объекте структуры содержится информация о выбранном пользователем файле.

Примечание

Функция GetOpenFileNamePreview позволяет пользователю выбрать файл в диалоговом окне Открытие файла. Данное диалоговое окно позволяет пользователю осуществить предварительный просмотр выделенного файла с расширением .avi. Данная функция позволяет расширить возможности функции GetOpenFileName.

Описание данной функции содержится в файле заголовка vfw.h. При работе с данной функцией следует включить в проект библиотеку vfw32.lib.