|
Страница 7 из 59
Функция GetOpenFileName (ПолучитьИмяОткрытогоФайла) Функция GetOpenFileName создает стандартное диалоговое окно Открыть (Open), которое дает возможность пользователю определить диск, каталог и имя файла или ряд файлов, чтобы открыть. Синтаксис BOOL GetOpenFileName
(
LPOPENFILENAME lpofn // адрес структуры с данными инициализации
);
Параметры
lpofn
Указатель на структуру OPENFILENAME, которая содержит информацию, используемую для инициализации диалогового окна. Когда GetOpenFileName возвращает значение, эта структура содержит информацию о файле, выбранном пользователем.
Возвращаемые значения
Если пользователь определяет имя файла и щелкает по кнопке ОК, возвращаемое значение не нуль. Буфер, указанный элементом lpstrFile структуры OPENFILENAME содержит полный путь и имя файла, которые определил пользователь.
Если пользователь прервал работу или закрыл диалоговое окно Открыть (Open) или произошла ошибка, возвращаемое значение - ноль. Чтобы получить расширенную информацию об ошибке, вызовите функцию CommDlgExtendedError, которая может возвратить одно из ниже перечисленных значений: CDERR_FINDRESFAILURECDERR_NOHINSTANCE
CDERR_INITIALIZATIONCDERR_NOHOOK
CDERR_LOCKRESFAILURECDERR_NOTEMPLATE
CDERR_LOADRESFAILURECDERR_STRUCTSIZE
CDERR_LOADSTRFAILUREFNERR_BUFFERTOOSMALL
CDERR_MEMALLOCFAILUREFNERR_INVALIDFILENAME
CDERR_MEMLOCKFAILUREFNERR_SUBCLASSFAILURE
Замечания
По умолчанию Windows 95 и Windows NT версии 4.0 показывают новую версию диалогового окна Открыть, которое обеспечивает пользовательский интерфейс со свойствами, которые похожи на Проводник Windows. Вы можете предоставить диалоговому окну Открыть в стиле Проводника фильтр - процедуру OFNHookProc. Чтобы разрешить работу фильтр - процедуре, установите флажки OFN_EXPLORER и OFN_ENABLEHOOK в элементе Flags структуры OPENFILENAME и определите ее адрес в элементе lpfnHook.
Windows 95 и Windows NT 4.0 продолжают поддерживать диалоговое окно Открыть для приложений, которые хотят поддерживать пользовательский интерфейс совместимый с пользовательским интерфейсом Windows 3.1 или Windows NT 3.51. Чтобы показать диалоговое окно Открыть старого стиля, разрешите работу фильтр - процедуре OFNHookProcOldStyle и гарантируйте, что флажок OFN_EXPLORER не установлен.
Смотри также
CommDlgExtendedError, GetSaveFileName, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME
Размещение и совместимость GetOpenFileName Windows NTДа
Win95Да
Win32sДа
Импортируемая библиотекаcomdlg32.lib
Заголовочный файлcommdlg.h
УникодWinNT
Замечания по платформеНе имеется |