Функция GetFileNameFromBrowse (shlobj.h)
[Эта функция доступна в Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. Он может быть изменен или недоступен в последующих версиях Windows.]
Создает диалоговое окно Открыть , чтобы пользователь смог указать диск, каталог и имя открываемого файла.
Синтаксис
BOOL GetFileNameFromBrowse(
[in, optional] HWND hwnd,
[in, out] PWSTR pszFilePath,
UINT cchFilePath,
[in, optional] PCWSTR pszWorkingDir,
[in] PCWSTR pszDefExt,
[in, optional] PCWSTR pszFilters,
[in, optional] PCWSTR pszTitle
);
Параметры
[in, optional] hwnd
Тип: HWND
Дескриптор окна, которому принадлежит диалоговое окно. Это может быть любой допустимый дескриптор окна или значение NULL , если у диалогового окна нет владельца.
[in, out] pszFilePath
Тип: PWSTR
Строка Юникода, завершающаяся нулевым значением, которая содержит имя файла, используемое для инициализации элемента управления изменением имени файла. Эта строка соответствует члену lpstrFile в структуре OPENFILENAME и используется точно так же.
cchFilePath
Тип: UINT
Количество символов в pszFilePath, включая завершающий символ NULL.
[in, optional] pszWorkingDir
Тип: PCWSTR
Полный путь к файлу исходного каталога. Эта строка соответствует члену lpstrInitialDir структуры OPENFILENAME и используется точно так же.
[in] pszDefExt
Тип: PCWSTR
Строка Юникода, заканчивающаяся нулевым значением, которая содержит расширение имени файла по умолчанию. Это расширение добавляется в pszFilePath , если пользователь не указывает расширение. Строка не должна содержать символы ".". Если эта строка имеет значение NULL и пользователю не удается ввести расширение, расширение не добавляется.
[in, optional] pszFilters
Тип: PCWSTR
Строка Юникода, завершающаяся нулевым значением, которая определяет фильтр. Эта строка соответствует члену lpstrFilter структуры OPENFILENAME и используется точно так же.
[in, optional] pszTitle
Тип: PCWSTR
Строка Юникода, завершающаяся нулевым значением, которая помещается в строку заголовка диалогового окна. Если это значение равно NULL, система использует заголовок по умолчанию.
Возвращаемое значение
Тип: BOOL
Если пользователь указывает имя файла и нажимает кнопку ОК, возвращается значение TRUE. Буфер, на который указывает pszFilePath , содержит полный путь и имя файла, указанное пользователем. Если пользователь отменяет или закрывает диалоговое окно Открыть или возникает ошибка, возвращается значение FALSE.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj.h (включая Shlobj.h) |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 5.0 или более поздняя) |