функция ImageList_LoadImageW (commctrl.h)

Статья
11/18/2024

Создает список изображений из указанного растрового изображения.

Синтаксис

HIMAGELIST ImageList_LoadImageW(
  HINSTANCE hi,
  LPCWSTR   lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Параметры

hi

Тип: HINSTANCE

Дескриптор экземпляра, содержащего ресурс. Этот параметр может быть значение NULL, если вы загружаете образ из файла или загружаете ресурс OEM.

lpbmp

Тип: LPCTSTR

Образ, который нужно загрузить.

Если параметр uFlags включает LR_LOADFROMFILE, lpbmp — это адрес строки, завершающей значение NULL, которая называет файл, содержащий образ для загрузки.

Если параметр hi неNULL и LR_LOADFROMFILE не указан, lpbmp — это адрес строки, завершающей значение NULL, которая содержит имя ресурса изображения в модуле hi.

Если NULL и LR_LOADFROMFILE не указано, LOWORD этого параметра должен быть идентификатором загружаемого образа OEM. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE с одним из идентификаторов образов OEM, определенных в Winuser.h. Эти идентификаторы имеют следующие префиксы.

Ценность	Значение
OBM_ для растровых карт OEM
OIC_ значков OEM
OCR_ для курсоров OEM

cx

Тип: int

Ширина каждого изображения. Высота каждого изображения и начального числа изображений определяется измерениями указанного ресурса.

cGrow

Тип: int

Количество изображений, по которым может расти список изображений, когда система должна освободить место для новых образов. Этот параметр представляет количество новых изображений, которые может содержать список измененных изображений.

crMask

Тип: COLORREF

Цвет, используемый для создания маски. Каждый пиксель этого цвета в указанном растровом рисунке, курсоре или значке изменяется на черный, а соответствующий бит в маске имеет значение 1. Если этот параметр является значением CLR_NONE, маска не создается. Если этот параметр является значением CLR_DEFAULT, цвет пикселя в левом верхнем углу изображения рассматривается как цвет маски.

uType

Тип: UINT

Флаг, указывающий тип загруженного изображения. Этот параметр должен быть IMAGE_BITMAP, чтобы указать, что загружается растровое изображение.

примечаниеImageList_LoadImage используется только с растровыми файлами. Другие типы изображений не поддерживаются.

Ценность	Значение
IMAGE_BITMAP	Загружает растровое изображение.

uFlags

Тип: UINT

Флаги, указывающие, как загрузить изображение. Этот параметр может быть сочетанием следующих значений.

Ценность	Значение
LR_CREATEDIBSECTION	Позволяет функции возвращать растровое изображение раздела DIB, а не совместимое растровое изображение, если параметр uType указывает IMAGE_BITMAP. LR_CREATEDIBSECTION полезно для загрузки растрового изображения, не сопоставляя его с цветами устройства отображения.
LR_DEFAULTCOLOR	Использует цветной формат отображения.
LR_DEFAULTSIZE	Использует ширину или высоту, указанную значениями системных метрик для курсоров и значков, если параметр cx имеет значение нулю. Если это значение не указано и cx равно нулю, функция задает размер, указанный в ресурсе. Если ресурс содержит несколько изображений, функция задает размер первого изображения.
LR_LOADFROMFILE	Загружает изображение из файла, указанного параметром lpbmp.
LR_LOADMAP3DCOLORS	Выполняет поиск таблицы цветов для изображения и заменяет следующие оттенки серого на соответствующий трехмерный цвет: Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW Серый: RGB(192, 192, 192)COLOR_3DFACE Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT Дополнительные сведения см. в разделе "Примечания".
LR_LOADTRANSPARENT	Извлекает значение цвета первого пикселя в изображении и заменяет соответствующую запись в таблице цветов цветом по умолчанию (цвет отображения COLOR_WINDOW). Все пиксели в изображении, использующее этот цвет, становятся цветом значения окна по умолчанию. Это значение применяется только к изображениям, имеющим соответствующую таблицу цветов. Дополнительные сведения см. в разделе "Примечания".
LR_MONOCHROME	Загружает изображение в черно-белом виде.
LR_SHARED	Предоставляет общий доступ к дескриптору изображения, если изображение загружается несколько раз. Не используйте это значение для изображений, имеющих нетрадиционные размеры, которые могут измениться после загрузки или для изображений, загруженных из файла.

Возвращаемое значение

Тип: HIMAGELIST

Возвращает дескриптор списка изображений в случае успешного выполнения или null в противном случае.

Замечания

LR_LOADTRANSPARENT не загружает изображение прозрачно. Он создает непрозрачный список изображений, который отображается только прозрачным, так как все фоновые пиксели были изменены на COLOR_WINDOW. Если изображения рисуются по фону, который не является цветом COLOR_WINDOW, изображение не рисуется должным образом. Кроме того, LR_LOADTRANSPARENT и LR_LOADMAP3DCOLORS использовать системные цвета, действующие в то время, когда ImageList_LoadImage был вызван. Если системные цвета впоследствии изменяются, приложение должно перезагрузить изображение для повторного сопоставления цветов.

Заметка

Заголовок commctrl.h определяет ImageList_LoadImage как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h
библиотеки	Comctl32.lib
DLL	Comctl32.dll

См. также

LoadImage

Поделиться через