LoadImage

Функция LoadImage загружает значка, курсора или точечный рисунок.

Ручка LoadImage) HINSTANCE  hinst, / / дескриптор экземпляра, содержащего изображениеLPCTSTRlpszName, / / имя или идентификатор изображенияUINTuType, / / тип изображенияintcxDesired, / / желаемой ширине intcyDesired, / / желаемая высотаUINTfuLoad / / загрузить флаги);
 

Параметры

hinst
Дескриптор экземпляра модуля, содержащего изображение для загрузки. Чтобы загрузить изображения OEM, установите этот параметр равным нулю.
lpszName
Дескриптор изображения для загрузки.

Если параметр hinst имеет значение не NULL и параметр fuLoad не включает LR_LOADFROMFILE, lpszName — это указатель на ограниченную значением null строку, содержащую имя ресурса изображения в модуле hinst.

Если hinst имеет значение NULL и LR_LOADFROMFILE не указан, младшее слово этого параметра должен быть идентификатором OEM изображения для загрузки. Идентификаторы image OEM определены в WINUSER.H и имеют следующие префиксы:
Префикс Значение
OBM_ OEM точечные рисунки
OIC_ OEM значки
OCR_ OEM курсоры

Если параметр fuLoad содержит значение LR_LOADFROMFILE, lpszName — это имя файла, содержащего изображение.

uType
Указывает тип изображения для загрузки. Этот параметр может принимать одно из следующих значений:
Значение Значение
IMAGE_BITMAP Загружает растровое изображение.
IMAGE_CURSOR Загружает курсор.
IMAGE_ICON Загружает значок.

cxDesired
Задает ширину в пикселах значка или курсора. Если этот параметр равен нулю, и параметр fuLoad имеет значение LR_DEFAULTSIZE, функция использует SM_CXICON или SM_CXCURSOR значение системы метрики для задания ширины. Если этот параметр равен нулю, и LR_DEFAULTSIZE не используется, функция использует текущий ресурс ширина.
cyDesired
Задает высоту в пикселах значка или курсора. Если этот параметр равен нулю, и параметр fuLoad имеет значение LR_DEFAULTSIZE, функция использует SM_CYICON или SM_CYCURSOR значение системы метрики для задания высоты. Если этот параметр равен нулю, и LR_DEFAULTSIZE не используется, функция использует текущий ресурс высота.
fuLoad
Определяет комбинацию следующих значений:
Значение Значение
LR_DEFAULTCOLOR По умолчанию флаг; Это не делает ничего. Все это означает — "не LR_MONOCHROME".
LR_CREATEDIBSECTION Когда параметр uType указывает IMAGE_BITMAP, вызывает функции для возврата точечного рисунка DIB секции, а не совместимый точечный рисунок. Этот флаг используется для загрузки точечного рисунка без сопоставления цветов устройства отображения.
LR_DEFAULTSIZE Использует ширину или высоту, установленные значения метрик системы для курсоров и значков, если значения cxDesired или cyDesired устанавливаются в ноль. Если этот флаг не указан, и cxDesired и cyDesired устанавливаются в нуль, функция использует текущий ресурс размер. Если ресурс содержит несколько изображений, функция использует размер первого изображения.
LR_LOADFROMFILE Загружает изображение из файла, заданного параметром lpszName . Если этот флаг не указан, lpszName — имя ресурса.
LR_LOADMAP3DCOLORS Выполняет поиск таблицы цветов для изображения и заменяет следующие оттенки серого цветом соответствующего 3D:

Цвет Заменены
DK Грей,
RGB(128,128,128)
COLOR_3DSHADOW
Грей,
RGB(192,192,192)
COLOR_3DFACE
Грей lt,
RGB(223,223,223)
COLOR_3DLIGHT

LR_LOADTRANSPARENT Извлекает значение цвет первого пиксела в изображении и заменяет соответствующую запись в таблице цветов окна цвет по умолчанию (COLOR_WINDOW). Все пикселы в изображении, которые используют эту запись становится окна цвет по умолчанию. Это значение применяется только к изображениям, которые имеют соответствующие таблицы цветов.

Если fuLoad содержит значения LR_LOADTRANSPARENT и LR_LOADMAP3DCOLORS, LRLOADTRANSPARENT имеет приоритет. Однако вместо записи таблицы цветов с COLOR_3DFACE, а не COLOR_WINDOW.

LR_MONOCHROME Загружает изображение в черно-белом режиме.
LR_SHARED Разделяет изображений ручка, если изображение загружается несколько раз. Если LR_SHARED не задано, второй вызов LoadImage для того же ресурса будет снова загрузить изображение и возвращать другой маркер.

Не используйте LR_SHARED для изображений, содержащих нестандартных размеров, которые могут измениться после загрузки, или которые загружаются из файла.

Windows 95 и Windows 98: Функция находит первое изображение с именем запрашиваемого ресурса в кэше, независимо от размера просил.

LR_VGACOLOR Использует истинное VGA.

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

Если функция выполнена успешно, возвращаемое значение является дескриптором вновь загруженного изображения.

Если вызов функции был неуспешен, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

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

Ресурс Функция выпуска
Точечный рисунок DeleteObject
Курсор DestroyCursor
Значок DestroyIcon

Система автоматически удаляет эти ресурсы после завершения процесса, который создал их, однако, соответствующие функции экономит память и уменьшает размер рабочего множества процесса.

Windows CE: Параметры cxDesired и cyDesired должен быть равен нулю для IMAGE_BITMAP.

Windows CE не поддерживает растяжения и сжатия иконок.

Параметр fuLoad должен быть равен нулю (== LR_DEFAULTCOLOR).

Если выбрана платформа, которая не поддерживает курсоры мыши нельзя указывать значения SM_CXCURSOR и SM_CYCURSOR в параметрах cxDesired и cyDesired , и IMAGE_CURSOR нельзя задать для параметра uType.

Если выбрана платформа, которая поддерживает курсоров мыши, укажите SM_CXCURSOR и SM_CYCURSOR в cxDesired и параметры cyDesired и IMAGE_CURSOR в параметре uType.

QuickInfo

nbsp; Windows &NT: требует версии 4.0 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор ресурсов, ресурсов функции, CopyImage, GetSystemMetrics LoadBitmap, LoadCursor, LoadIcon

Index