Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Раздел "MSDN по-русски": http://www.bcbdev.ru/msdn/index.php
Обновления на сайте
В раздел Примеры кода добавился пример "Изменение картинки на рабочем столе".
Перевод
Сегодня вашему вниманию представлен перевод структуры BROWSEINFO.
BROWSEINFO
Содержит параметры для функции SHBrowseForFolder и получает информацию о выбранной
пользователем папке.
typedef struct _browseinfo {
HWND hwndOwner;
LPCITEMIDLIST pidlRoot;
LPSTR pszDisplayName;
LPCSTR lpszTitle;
UINT ulFlags;
BFFCALLBACK lpfn;
LPARAM lParam;
int iImage;
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO;
Члены
hwndOwner – дескриптор окна-владельца диалогового окна.
pidlRoot – указатель на список идентификаторов элемента (структуру типа ITEMIDLIST),
определяющий местоположение "корневой"
директории, с которой начинается просмотр дерева каталогов. В диалоговом окне
появляются только указанная директория и ее
поддиректории. Значение члена может быть равно NULL, в этом случае используется
корневая директория пространства имен, т. е.
Рабочий стол.
pszDisplayName – указатель на буфер, который получает отображаемое имя папки,
выбранной пользователем. Размер буфера
полагается равным MAX_PATH байт.
lpszTitle – указатель на завершающуюся нулем строку, которая отображается выше
дерева каталогов в диалоговом окне. Строка
может быть использована для отображения инструкций пользователю.
ulFlags – значение, определяющее отображаемые типы папок в диалоговом окне, а
также некоторые другие опции. Может принимать
ноль или более значений из таблицы:
Значение Пояснение
BIF_BROWSEFORCOMPUTER Возвращаются только компьютеры. Если пользователь выбирает
что-либо, отличное от компьютера, кнопка
ОК недоступна.
BIF_BROWSEFORPRINTER Возвращаются только принтеры. Если пользователь выбирает
что-либо, отличное от принтера, кнопка ОК
недоступна.
BIF_DONTGOBELOWDOMAIN Не включаются сетевые папки ниже уровня домена в дереве
каталогов.
BIF_RETURNFSANCESTORS Возвращаются только предки файловой системы. Если пользователь
выбирает что-либо, отличное от предка
файловой системы, кнопка ОК недоступна.
BIF_RETURNONLYFSDIRS Возвращаются только директории файловой системы. Если пользователь
выбирает что-либо, отличное от
директории файловой системы, кнопка ОК недоступна.
BIF_STATUSTEXT В диалоговое окно включается область состояния. Функция обратного
вызова может установить текст этой области,
отправляя сообщения диалоговому окну.
lpfn – адрес определяемой приложением функции, которую вызывает диалоговое окно
в случае возникновения события. Для
дополнительной информации смотрите функцию BrowseCallbackProc. Значение этого
члена может быть равно NULL.
lParam – определяемое приложением значение, которое диалоговое окно передает
в функцию обратного вызова (если таковая
указана).
iImage – получает изображение, связанное с выбранной папкой. Изображение указывается
как индекс в списке изображений.
См. также
BrowseCallbackProc, ITEMIDLIST, SHBrowseForFolder.
Справочник по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
Справочник по WinAPI (zip-версия): http://www.bcbdev.ru/winapi/win32api.zip
Дружественная рассылка "Программирование на WinAPI": http://subscribe.ru/catalog/comp.soft.prog.russianmsdn
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:stathome@rol.ru