Русский справочник по Win32 API
Шрифт:
lpType– определяет тип ресурса. Для дополнительной информации смотрите раздел "Комментарии". Для стандартных типов ресурсов этот параметр может принимать одно из следующих значений:
| Значение | Пояснение |
| RT_ACCELERATOR | Таблица акселераторов. |
| RT_ANICURSOR | Анимированный курсор. |
| RT_ANIICON | Анимированная иконка. |
| RT_BITMAP | Битовое изображение. |
| RT_CURSOR | Зависимый |
| RT_DIALOG | Диалоговое окно. |
| RT_FONT | Шрифт . |
| RT_FONTDIR | Таблица шрифтов . |
| RT_GROUP_CURSOR | Независимый от аппаратного обеспечения курсор. |
| RT_GROUP_ICON | Независимая от аппаратного обеспечения иконка. |
| RT_ICON | Зависимая от аппаратного обеспечения иконка. |
| RT_MENU | Меню . |
| RT_MESSAGETABLE | Элемент таблицы сообщений. |
| RT_RCDATA | Определяемые приложением ресурсы. |
| RT_STRING | Элемент таблицы строк. |
| RT_VERSION | Информация о версии. |
wLanguage– определяет язык ресурса. Если значение этого параметра равно MAKELANGID ( LANG_NEUTRAL, SUBLANG_NEUTRAL ), используется текущий язык, ассоциированный с вызывающим потоком.
Для указания языка, отличного от текущего, используйте макрос MAKELANGID .
Возвращаемые значения
В случае успеха возвращается дескриптор блока с информацией об указанном ресурсе. Для получения дескриптора ресурса передайте этот дескриптор в функцию LoadResource .
В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Если старшее слово значения параметра lpName или lpType равно нулю, младшее слово определяет целочисленный идентификатор имени или типа указанного ресурса. В противном случае, оба значения этих параметров представляют собой длинные указатели на завершающиеся нулем строки. Если первый символ строки равен '#', оставшиеся символы представляют собой десятичное число, которое определяет целочисленный идентификатор имени или типа ресурса. Например, строка "#258" представляет собой целочисленный идентификатор 258.
Приложение может уменьшить количество памяти, необходимое ресурсу, обращаясь к нему по целочисленному идентификатору вместо имени.
Приложение может использовать FindResourceEx для поиска ресурса любого типа, но эта функция должна быть использована только в том случае, если приложение должно иметь доступ к двоичным данным ресурсов, когда оно впоследствии вызывает функции LoadLibrary и LockResource .
Для немедленного использования ресурса приложение должно использовать одну из следующих функций для поиска и загрузки ресурса:
| Функция | Действие |
| FormatMessage | Загружает и форматирует элемент таблицы сообщений. |
| LoadAccelerators | Загружает таблицу акселераторов. |
| LoadBitmap | Загружает битовое изображение. |
| LoadCursor | Загружает курсор. |
| LoadIcon | Загружает иконку. |
| LoadMenu | Загружает меню. |
| LoadString | Загружает элемент таблицы строк. |
Например, приложение должно использовать функцию LoadIcon для загрузки иконки для ее отображения на экране. Тем не менее, приложение должно использовать функции FindResource и LoadResource , если оно загружает иконку для копирования ее данных в другое приложение.
См . также
FindResource, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource .
Пространство имен оболочки
BrowseCallbackProc
Функция BrowseCallbackProc представляет собой определяемую приложением функцию обратного вызова, используемую совместно с функцией SHBrowseForFolder . Диалоговое окно выбора папки вызывает эту функцию для уведомления о событиях. Тип BFFCALLBACK определяет указатель на эту функцию обратного вызова.
int BrowseCallbackProc (
HWND hwnd ,
UINT uMsg ,
LPARAM lParam ,
LPARAM lpData
);
Параметры
hwnd– дескриптор диалогового окна. Функция обратного вызова может отправлять окну следующие сообщения:
| BFFM_ENABLEOK | Разрешает кнопку ОК, если значение параметра wParam не равно нулю. В противном случае запрещает кнопку ОК. |
| BFFM_SETSELECTION | Выбирает указанную папку. Значение lParam представляет собой PIDL выбираемой папки, если значение wParam равно FALSE, или путь папки в противном случае. |
| BFFM _ SETSTATUSTEXT | Устанавливает текст состояния в завершающуюся нулем строку, определенную значением параметра lParam . |
uMsg– идентифицирует событие. Может принимать одно из следующих значений:
| BFFM_INITIALIZED | Диалоговое окно завершило инициализацию. Значение параметра lpData равно NULL . |
| BFFM_SELCHANGED | Изменился выбор в диалоговом окне. lpData представляет собой указатель на список идентификаторов элемента для выбранной папки. |
lParam– зависящее от сообщения значение.
lpData– определяемое приложением значение, которое было указано в члене lParam структуры типа BROWSEINFO .
Возвращаемые значения
Функция возвращает нуль.
См. также
BROWSEINFO .