Списки изображений

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

Общие сведения

Раздел	Содержимое
Списки изображений	Список изображений — это коллекция изображений одного размера, каждая из которых может ссылаться на его индекс.

Функции

Раздел	Содержимое
HIMAGELIST_QueryInterface	Извлекает указатель на объект IImageList или IImageList2, соответствующий дескриптору HIMAGELIST списка изображений.
ImageList_Add	Добавляет изображение или изображения в список изображений.
ImageList_AddMasked	Добавляет изображение или изображения в список изображений, создав маску из указанной растровой карты.
ImageList_BeginDrag	Начинает перетаскивание изображения.
ImageList_CoCreateInstance	Создает один экземпляр списка изображений и возвращает указатель интерфейса на него.
ImageList_Copy	Копирует изображения в заданном списке изображений.
ImageList_Create	Создает новый список изображений.
ImageList_Destroy	Уничтожает список изображений.
ImageList_DragEnter	Отображает изображение перетаскивания в указанной позиции в окне.
ImageList_DragLeave	Разблокирует указанное окно и скрывает изображение перетаскивания, что позволяет обновить окно.
ImageList_DragMove	Перемещает изображение, перетаскиваемое во время операции перетаскивания. Эта функция обычно вызывается в ответ на сообщение WM_MOUSEMOVE.
ImageList_DragShowNolock	Отображает или скрывает перетаскиваемое изображение.
ImageList_Draw	Рисует элемент списка изображений в указанном контексте устройства.
ImageList_DrawEx	Рисует элемент списка изображений в указанном контексте устройства. Функция использует указанный стиль рисования и объединяет изображение с указанным цветом.
ImageList_DrawIndirect	Рисует изображение списка изображений на основе структуры IMAGELISTDRAWPARAMS.
ImageList_Duplicate	Создает дубликат существующего списка изображений.
ImageList_EndDrag	Завершает операцию перетаскивания.
ImageList_GetBkColor	Извлекает текущий цвет фона для списка изображений.
ImageList_GetDragImage	Извлекает временный список изображений, используемый для изображения перетаскивания. Функция также извлекает текущую позицию перетаскивания и смещение изображения перетаскивания относительно позиции перетаскивания.
ImageList_GetIcon	Создает значок из изображения и маски в списке изображений.
ImageList_GetIconSize	Извлекает измерения изображений в списке изображений. Все изображения в списке изображений имеют одинаковые размеры.
ImageList_GetImageCount	Извлекает количество изображений в списке изображений.
ImageList_GetImageInfo	Извлекает сведения об изображении.
ImageList_LoadImage	Создает список изображений из указанного растрового изображения.
ImageList_Merge	Создает новое изображение путем объединения двух существующих образов. Функция также создает новый список изображений, в котором хранится изображение.
ImageList_Read	Считывает список изображений из потока.
ImageList_ReadEx	Считывает список изображений из потока и возвращает интерфейс в список изображений.
ImageList_Remove	Удаляет изображение из списка изображений.
ImageList_Replace	Заменяет изображение в списке изображений новым изображением.
ImageList_ReplaceIcon	Заменяет изображение значком или курсором.
ImageList_SetBkColor	Задает цвет фона для списка изображений. Эта функция работает только при добавлении значка или использовании ImageList_AddMasked с черно-белым растровым изображением. Без маски весь рисунок рисуется; поэтому цвет фона не отображается.
ImageList_SetColorTable	Задает таблицу цветов для списка изображений.
ImageList_SetDragCursorImage	Создает новое изображение перетаскивания путем объединения указанного изображения (обычно изображения курсора мыши) с текущим изображением перетаскивания.
ImageList_SetIconSize	Задает размеры изображений в списке изображений и удаляет все изображения из списка.
ImageList_SetImageCount	Изменяет размер существующего списка изображений.
ImageList_SetOverlayImage	Добавляет указанное изображение в список изображений, которые будут использоваться в качестве маски наложения. Список изображений может содержать до четырех маск наложения в версии 4.70 и более ранних версий и до 15 в версии 4.71. Функция назначает индекс маски наложения указанному изображению.
ImageList_Write	Записывает список изображений в поток.
ImageList_WriteEx	Записывает список изображений в поток.

Макросы

Раздел	Содержимое
ImageList_AddIcon	Добавляет значок или курсор в список изображений. ImageList_AddIcon вызывает функцию ImageList_ReplaceIcon.
ImageList_ExtractIcon	Вызывает функцию ImageList_GetIcon для создания значка или курсора на основе изображения и маски в списке изображений.
ImageList_LoadBitmap	Вызывает функцию ImageList_LoadImage для создания списка изображений из указанного ресурса растрового изображения.
ImageList_RemoveAll	Вызывает функцию ImageList_Remove, чтобы удалить все изображения из списка изображений.
INDEXTOOVERLAYMASK	Подготавливает индекс маски наложения, чтобы функция ImageList_Draw ее можно было использовать.

Интерфейсы

Раздел	Содержимое
IImageList	Предоставляет методы, которые управляют списками изображений и взаимодействуют с ними. Чтобы использовать IImageList, укажите Comctl32.dll версии 6 в манифесте. Если этого не сделать, Comctl32.dll версии 5 будет использоваться по умолчанию, с помощью которого IImageList может отобразить непредсказуемое поведение. Дополнительные сведения о манифестах см. в разделе "Включение визуальных стилей".

Методы

Раздел	Содержимое
Прибавить	Добавляет изображение или изображения в список изображений.
AddMasked	Добавляет изображение или изображения в список изображений, создав маску из указанной растровой карты.
BeginDrag	Начинает перетаскивание изображения.
Клонировать	Клонирует существующий список изображений.
Копировать	Копирует изображения из заданного списка изображений.
Dragenter	Блокирует обновление указанного окна во время операции перетаскивания и отображает изображение перетаскивания в указанной позиции в окне.
Dragleave	Разблокирует указанное окно и скрывает изображение перетаскивания, которое позволяет обновить окно.
DragMove	Перемещает изображение, перетаскиваемое во время операции перетаскивания. Эта функция обычно вызывается в ответ на сообщение WM_MOUSEMOVE.
DragShowNolock	Отображает или скрывает перетаскиваемое изображение.
Нарисовать	Рисует элемент списка изображений в указанном контексте устройства.
EndDrag	Завершает операцию перетаскивания.
GetBkColor	Возвращает текущий цвет фона для списка изображений.
GetDragImage	Возвращает временный список изображений, используемый для изображения перетаскивания. Функция также извлекает текущую позицию перетаскивания и смещение изображения перетаскивания относительно позиции перетаскивания.
GetIcon	Создает значок из изображения и маски в списке изображений.
GetIconSize	Возвращает размеры изображений в списке изображений. Все изображения в списке изображений имеют одинаковые размеры.
GetImageCount	Возвращает количество изображений в списке изображений.
GetImageInfo	Получает сведения об изображении.
GetImageRect	Получает ограничивающий прямоугольник изображения.
GetItemFlags	Возвращает флаги изображения.
GetOverlayImage	Извлекает указанное изображение из списка изображений, используемых в качестве маски наложения.
Слияние	Создает новое изображение путем объединения двух существующих образов. Этот метод также создает новый список изображений, в котором будет храниться изображение.
Удалить	Удаляет изображение из списка изображений.
Replace	Заменяет изображение в списке изображений новым изображением.
ReplaceIcon	Заменяет изображение значком или курсором.
SetBkColor	Задает цвет фона для списка изображений. Этот метод работает только при добавлении значка в список изображений или использовании метода IImageList::AddMasked для добавления черно-белой растровой карты. Без маски весь рисунок рисует, а цвет фона не отображается.
SetDragCursorImage	Создает новое изображение перетаскивания путем объединения указанного изображения, который обычно является изображением курсора мыши с текущим изображением перетаскивания.
SetIconSize	Задает размеры изображений в списке изображений и удаляет все изображения из списка.
SetImageCount	Изменяет размер существующего списка изображений.
SetOverlayImage	Добавляет указанное изображение в список изображений, используемых в качестве маски наложения. Список изображений может содержать до четырех масок наложения в Common Controls версии 4.70 и более ранних версий и до 15 в версии 4.71 или более поздней. Метод назначает индекс маски наложения указанному изображению.

Структуры

Раздел	Содержимое
IMAGEINFO	Содержит сведения об изображении в списке изображений. Эта структура используется с функцией IImageList::GetImageInfo.
IMAGELISTDRAWPARAMS	Содержит сведения о операции рисования списка изображений и используется с функцией IImageList::D raw .