Win32 API. Справочник по стандартному диалоговому окну - Функция GetSaveFileName
ОГЛАВЛЕНИЕ
Функция GetSaveFileName
(ПолучитьСохраненноеИмяФайла)
Функция GetSaveFileName создает стандартное диалоговое окно Сохранить (Save), которое позволяет пользователю определить диск, каталог и имя файла, которое нужно сохранить.
Синтаксис
BOOL GetSaveFileName
(
LPOPENFILENAME lpofn // адрес структуры данными инициализации
);
Параметры
lpofn
Указатель на структуру OPENFILENAME, которая содержит информацию, используемую, чтобы инициализировать диалоговое окно. Когда GetSaveFileName возвращает значение, эта структура содержит информацию о выбранном пользователем файле.
Возвращаемые значения
Если пользователь определяет имя файла и щелкает мышью по кнопке OK, возвращаемое значение не нуль. Буфер, указанный в элементе lpstrFile структуры OPENFILENAME содержит полный путь и имя файла, определенного пользователем.
Если пользователь прерывает работу или закрывает диалоговое окно Сохранить (Save) или происходит ошибка, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите функцию 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 показывают новую версию диалогового окна Сохранить (Save), чтобы обеспечить пользовательский интерфейс со свойствами, которые похожи на Проводник Windows. Вы можете обеспечить диалоговое окно Сохранить (Save) в стиле Проводника фильтр - процедурой OFNHookProc. Чтобы разрешить работу фильтр - процедуры, установите флажки OFN_EXPLORER и OFN_ENABLEHOOK в элементе Flags структуры OPENFILENAME и установить ее адрес в элементе lpfnHook.
Windows 95 и Windows NT 4.0 продолжает поддерживать диалоговое окно Сохранить (Save) старого стиля для прикладных программ, которые хотят поддерживать пользовательский интерфейс совместимый с пользовательским интерфейсом Windows 3.1 или Windows NT 3.51. Чтобы показать диалоговое окно Сохранить (Save) в старом стиле, разрешите работу фильтр - процедуре OFNHookProcOldStyle и гарантируйте, что флажок OFN_EXPLORER не установлен.
Смотри также
CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME
Размещение и совместимость GetSaveFileName
Windows NT Да
Win95 Да
Win32s Да
Импортируемая библиотека comdlg32.lib
Заголовочный файл commdlg.h
Уникод WinNT
Замечания по платформе Не имеется