On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

GetOpenFileName

The GetOpenFileName function creates an Open common dialog box that lets the user specify the drive, directory, and the name of a file or set of files to open.

BOOL GetOpenFileName(

LPOPENFILENAME lpofn // address of structure with initialization data
);

Parameters

lpofn

Pointer to an OPENFILENAME structure that contains information used to initialize the dialog box. When GetOpenFileName returns, this structure contains information about the user's file selection.

Return Values

If the user specifies a filename and clicks the OK button, the return value is nonzero. The buffer pointed to by the lpstrFile member of the OPENFILENAME structure contains the full path and filename specified by the user.
If the user cancels or closes the Open dialog box or an error occurs, the return value is zero. To get extended error information, call the CommDlgExtendedError function, which can return one of the following values:

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

Remarks

By default, Windows 95 and Windows NT version 4.0 display a new version of the Open dialog box that provides user-interface features that are similar to the Windows Explorer. You can provide an OFNHookProc hook procedure for an Explorer-style Open dialog box. To enable the hook procedure, set the OFN_EXPLORER and OFN_ENABLEHOOK flags in the Flags member of the OPENFILENAME structure and specify the address of the hook procedure in the lpfnHook member.

Windows 95 and Windows NT 4.0 continue to support the old-style Open dialog box for applications that want to maintain a user-interface consistent with the Windows 3.1 or Windows NT 3.51 user-interface. To display the old-style Open dialog box, enable an OFNHookProcOldStyle hook procedure and ensure that the OFN_EXPLORER flag is not set.

See Also

CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetOpenFileName

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

BOOL GetOpenFileName(

LPOPENFILENAME lpofn // АДРЕС структуры с данными инициализации
);

Параметры

lpofn

Указатель в структуру OPENFILENAME, которая содержит информацию использованное, чтобы инициализировать диалогового блока. Когда возврат GetOpenFileName, эта структура содержит информацию о файловом выборе пользователя.

Обратные Величины

Если пользователь определяет filename и щелкает кнопку OK, обратная величина ненулевая. Буфер указанный, чтобы элементом lpstrFile структуры OPENFILENAME содержит полный путь и filename определенное пользователем.
Если пользователь отменяет или закрывает Открытого диалогового блока или ошибка происходит, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите функцию 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 Explorer. Вы можете обеспечить процедуру захвата OFNHookProc для Открытого диалогового блока стиля Explorer-. Для того, чтобы приспосабливаться рычажную процедуру, установите OFN_EXPLORER и флаги OFN_ENABLEHOOK в элементе Флагов структуры OPENFILENAME и определяют адрес рычажной процедуры в элементе lpfnHook.

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

Смотри Также

CommDlgExtendedError, GetSaveFileName, OFNHookProc , OFNHookProcOldStyle, OPENFILENAME

Используются технологии uCoz