См . также
CopyCursor, DrawIcon, DrawIconEx.
Функция CreateIcon создает иконку, которая имеет указанные размер, цвета и битовые шаблоны.
HICON CreateIcon (
HINSTANCE hInstance , // дескриптор экземпляра приложения
int nWidth , // ширина иконки
int nHeight , // высота иконки
BYTE cPlanes , // число плоскостей в битовой маске исключающее ИЛИ
BYTE cBitsPixel , // число бит на пиксель
// в битовой маске исключающее ИЛИ
CONST BYTE * lpbANDbits , // указатель на массив битовой маски И
CONST BYTE * lpbXORbits // указатель на массив битовой маски ИЛИ
);
Параметры
hInstance - идентифицирует экземпляр модуля, создающего иконку.
nWidth - определяет ширину иконки в пикселях.
nHeight - определяет высоту иконки в пикселях.
cPlanes - определяет число плоскостей в битовой маске исключающее ИЛИ иконки.
cBitsPixel - определяет число бит на пиксель в битовой маске исключающее ИЛИ иконки.
lpbANDbits - указатель на массив байт, который содержит битовые значения для маски И иконки. Такая битовая маска описывает монохромное изображение.
lpbXORbits - указатель на массив байт, который содержит битовые значения для маски исключающее ИЛИ иконки. Такая битовая маска описывает зависимое от устройства цветное изображение.
Возвращаемые значения
В случае успеха возвращается дескриптор иконки.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Значения параметров nWidth и nHeight должны указывать ширину и высоту, поддерживаемые текущим драйвером дисплея, потому что система не может создать иконки других размеров. Для определения того, какие ширина и высота поддерживаются драйвером дисплея, вызовите функцию GetSystemMetrics , указав значения SM _ CXICON и SM _ CYICON .
CreateIcon применяет следующую таблицу истинности для битовых масок.
Битовая маска И | Битовая маска исключающее ИЛИ | Отображение |
0 | 0 | Черное. |
0 | 1 | Белое. |
1 | 0 | Цвет экрана. |
1 | 1 | Обратный цвет экрана. |
См. также
GetSystemMetrics .
Функция CreateIconFromResource создает иконку или курсор из битов ресурса, описывающих иконку.
HICON CreateIconFromResource (
PBYTE presbits , // указатель на биты ресурса
DWORD dwResSize , // число бит в буфере
BOOL fIcon , // флаг иконки или курсора
DWORD dwVer // версия формата Windows
);
Параметры
presbits - указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .
dwResSize - определяет размер, в байтах, набора битов, на который указывает параметр presbits .
fIcon - определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.
dwVer - определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр presbits . Параметр может принимать одно из следующих значений:
Формат | Значение |
Windows 2. x | 0x00020000 |
Windows 3.x | 0x00030000 |
Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .
Возвращаемые значения
В случае успеха возвращается дескриптор иконки или курсора.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Функции CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectory (в Windows 95 также функции CreateIconFromResourceEx и LookupIconIdFromDirectoryEx ) позволяют приложениям оболочки и браузерам иконок проверять и использовать ресурсы всей системы.
См. также
CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx .
Функция CreateIconFromResourceEx создает иконку или курсор из битов ресурса, описывающих иконку.
HICON CreateIconFromResourceEx (
PBYTE pbIconBits , // указатель на биты ресурса
DWORD cbIconBits , // число бит в буфере
BOOL fIcon , // флаг иконки или курсора
