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.

Примечания

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

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

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