Функция LoadImageA (winuser.h)
Загружает значок, курсор, анимированный курсор или растровое изображение.
Синтаксис
HANDLE LoadImageA(
[in, optional] HINSTANCE hInst,
[in] LPCSTR name,
[in] UINT type,
[in] int cx,
[in] int cy,
[in] UINT fuLoad
);
Параметры
[in, optional] hInst
Тип: HINSTANCE
Дескриптор модуля библиотеки DLL или исполняемого файла (.exe), который содержит загруженный образ. Дополнительные сведения см. в GetModuleHandle. Обратите внимание, что с 32-разрядной версией Windows дескриптор экземпляра (HINSTANCE), например экземпляр приложения, который обрабатывается вызовом системной функции WinMain, а дескриптор модуля (HMODULE) совпадает.
Чтобы загрузить предварительно определенное изображение или автономный ресурс (значок, курсор или растровый файл), задайте для этого параметра значение NULL.
[in] name
Тип: LPCTSTR
Загруженный образ.
Если параметр hInst неNULL, а параметр fuLoadLR_LOADFROMFILE, имя указывает ресурс образа в модуле hInst.
Если ресурс изображения должен быть загружен по имени из модуля, имя параметр является указателем на строку, завершающую значение NULL, которая содержит имя ресурса образа.
Если ресурс изображения должен быть загружен порядком из модуля, используйте макрос MAKEINTRESOURCE для преобразования порядкового номера изображения в форму, которую можно передать в функцию loadImage LoadImage.
Если параметр
Стандартные идентификаторы изображений определены в Winuser.h и имеют следующие префиксы:
| Приставка | Значение |
|---|---|
| OBM_ | Растровые изображения OEM. Используйте макрос MAKEINTRESOURCE для передачи этих данных. |
| OIC_ | Значки OEM. Используйте макрос MAKEINTRESOURCE для передачи этих данных. |
| OCR_ | Курсоры OEM. Используйте макрос MAKEINTRESOURCE для передачи этих данных. |
| IDI_ | стандартные значки |
| IDC_ | курсоров уровня "Стандартный" |
Чтобы передать константы идентификаторов образов OEM в функцию LoadImage
Если параметр hInstNULL, а параметр fuLoad включает значение LR_LOADFROMFILE, имя — это имя файла, содержащего автономный ресурс (значок, курсор или файл растрового изображения), например c:\myicon.ico.
Дополнительные сведения см. в разделе "Примечания" ниже.
[in] type
Тип: UINT
Тип загруженного изображения.
Этот параметр может быть одним из следующих значений:
| Ценность | Значение |
|---|---|
| IMAGE_BITMAP | Загружает растровое изображение. |
| IMAGE_CURSOR | Загружает курсор. |
| IMAGE_ICON | Загружает значок. |
[in] cx
Тип: int
Ширина в пикселях значка или курсора. Если этот параметр равен нулю, а параметр fuLoad
[in] cy
Тип: int
Высота значка или курсора в пикселях. Если этот параметр равен нулю, а параметр fuLoad
[in] fuLoad
Тип: UINT
Этот параметр может быть одним или несколькими из следующих значений.
Возвращаемое значение
Тип: HANDLE
Если функция выполнена успешно, возвращаемое значение является дескриптором только что загруженного образа.
Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Если IS_INTRESOURCE(имя) true, то имя указывает целый идентификатор заданного ресурса. В противном случае это указатель на строку, завершаемую значением NULL. Если первый символ строки является знаком фунта (#), остальные символы представляют десятичное число, указывающее целочисленный идентификатор ресурса. Например, строка "#258" представляет идентификатор 258.
После завершения работы с растровым изображением, курсором или значком, загруженным без указания флага LR_SHARED, можно освободить связанную память, вызвав одну из функций в следующей таблице.
| Ресурс | Функция выпуска |
|---|---|
| Точечный рисунок | DeleteObject |
| Курсор | DestroyCursor |
| Икона | DestroyIcon |
Система автоматически удаляет эти ресурсы при завершении процесса, созданного ими; Однако вызов соответствующей функции сохраняет память и уменьшает размер рабочего набора процесса.
Примеры
Пример см. в разделе Использование классов окон.
Заметка
Заголовок winuser.h определяет LoadImage как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winuser.h (включая Windows.h) |
| библиотеки |
User32.lib |
| DLL | User32.dll |
| набор API | ext-ms-win-ntuser-gui-l1-1-0 (представлено в Windows 8) |
См. также
концептуальные
LoadCursor
другие ресурсы
Справочник