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

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

  • Статья

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

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

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

Функции

Раздел Содержимое
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 .