Сведения о списках изображений

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

API Microsoft Win32 предоставляет функции списка изображений и макросы, которые позволяют создавать и уничтожать списки изображений, добавлять и удалять изображения, заменять и объединять изображения, рисовать изображения и перетаскивать изображения. Чтобы использовать функции списка изображений, включите общий файл заголовка элемента управления в файлы исходного кода и свяжите с общей библиотекой экспорта элементов управления. Кроме того, перед вызовом любой функции списка изображений используйте функцию InitCommonControls или InitCommonControlsEx, чтобы обеспечить загрузку библиотеки DLL общего элемента управления.

В этом разделе рассматриваются следующие разделы:

• Типы
• Создание и уничтожение списков изображений
• Добавление и удаление изображений
• Замена и объединение образов
• Рисование изображений
• Перетаскивание изображений
• Сведения об изображении
• Наложения изображений
• 32-разрядные антиалиасные значки

Типы

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

При рисовании немаскированного изображения он просто копируется в контекст целевого устройства; То есть он рисуется по существующему цвету фона контекста устройства. При рисовании маскированного изображения биты изображения объединяются с битами маски, обычно создавая прозрачные области в растровом изображении, где отображается цвет фона контекста целевого устройства. Существует несколько стилей рисования, которые можно указать при рисовании маскированного изображения. Например, можно указать, что изображение должно быть dithered, чтобы указать выбранный объект.

Создание и уничтожение списков изображений

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

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

Если ImageList_Create успешно, он возвращает дескриптор в тип HIMAGELIST. Этот дескриптор используется в других функциях списка изображений для доступа к списку изображений и управления изображениями. Вы можете добавлять и удалять изображения, копировать изображения из одного списка изображений в другой и объединять изображения из двух разных списков изображений. Если список изображений больше не нужен, его можно уничтожить, указав его дескриптор в вызове функции ImageList_Destroy .

Добавление и удаление изображений

Вы можете добавить битовые изображения, значки или курсоры в список изображений. Вы добавляете битовые изображения, указывая дескриптор к двум растровым изображениям в вызове функции ImageList_Add . Первая растровая карта содержит один или несколько изображений для добавления в растровое изображение изображения, а второй растровый рисунок содержит маски для добавления в растровое изображение маски. Для немаскированных списков изображений второй дескриптор растрового изображения игнорируется; Его можно задать в значение NULL.

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

Макрос ImageList_AddIcon добавляет значок или курсор в список изображений. Если список изображений маскирован, ImageList_AddIcon добавляет маску, предоставляемую значком или курсором, в растровое изображение маски. Если список изображений не является маской для значка или курсора, не используется при рисовании изображения.

Значок можно создать на основе изображения и маски в списке изображений с помощью функции ImageList_GetIcon. Функция возвращает дескриптор новому значку.

ImageList_Add, ImageList_AddMasked и ImageList_AddIcon назначить индекс каждому изображению по мере добавления в список изображений. Индексы основаны на нулях; То есть первый образ в списке имеет индекс нуля, следующий имеет индекс одного и т. д. После добавления одного изображения функции возвращают индекс изображения. При добавлении нескольких изображений одновременно функции возвращают индекс первого изображения.

Функция ImageList_Remove удаляет изображение из списка изображений.

Замена и объединение образов

Функции ImageList_Replace и ImageList_ReplaceIcon заменяют изображение в списке изображений новым изображением. ImageList_Replace заменяет изображение битовой маской и изображением, а ImageList_ReplaceIcon заменяет изображение значком или курсором.

Функция ImageList_Merge объединяет два образа, сохраняя новый образ в новом списке изображений. Новое изображение создается путем прозрачного рисования второго изображения. Маска для нового изображения является результатом логической операции OR на битах маски для двух существующих изображений.

Рисование изображений

Чтобы нарисовать изображение, используйте функцию ImageList_Draw или ImageList_DrawEx. Вы указываете дескриптор списка изображений, индекс рисунка для рисования, дескриптор контекста конечного устройства, расположение в контексте устройства и один или несколько стилей рисования.

При указании стиля ILD_TRANSPARENT ImageList_Draw или ImageList_DrawEx используется двухэтапный процесс для рисования маскированного изображения. Во-первых, он выполняет логическую операцию AND на битах изображения и битах маски. Затем он выполняет логическую операцию XOR в результатах первой операции и фоновых битах контекста целевого устройства. Этот процесс создает прозрачные области в полученном изображении; То есть каждый белый бит в маске приводит к тому, что соответствующий бит в результирующем изображении будет прозрачным.

Перед рисованием маскированного изображения на сплошном цвете фона следует использовать функцию ImageList_SetBkColor , чтобы задать цвет фона списка изображений таким же цветом, что и назначение. Настройка цвета устраняет необходимость создания прозрачных областей на изображении и позволяет ImageList_Draw или ImageList_DrawEx просто копировать изображение в контекст целевого устройства, что приводит к значительному увеличению производительности. Чтобы нарисовать изображение, укажите стиль ILD_NORMAL в вызове ImageList_Draw или ImageList_DrawEx.

Цвет фона для списка маскированных изображений можно задать в любое время, чтобы он правильно рисовал на любом сплошном фоне. Установка цвета фона на CLR_NONE приводит к тому, что изображения будут вырисовываться прозрачно по умолчанию. Чтобы получить цвет фона списка изображений, используйте функцию ImageList_GetBkColor .

Стили ILD_BLEND25 и ILD_BLEND50 опустите изображение с цветом выделения системы. Эти стили полезны, если вы используете маскированные изображения для представления объекта, который пользователь может выбрать. Например, можно использовать стиль ILD_BLEND50 для рисования изображения при его выборе.

Немаскированное изображение копируется в контекст целевого устройства с помощью операции растрового изображения SRCCOPY. Цвета в изображении отображаются одинаково независимо от цвета фона контекста устройства. Стили рисования, указанные в ImageList_Draw или ImageList_DrawEx , также не влияют на внешний вид немаскированного изображения.

Перетаскивание изображений

API Win32 включает функции для перетаскивания изображения на экране. Функции перетаскивания плавно перемещают изображение, цветом и без мигания курсора. Можно перетаскивать как маскированные, так и незамаскированные изображения.

Функция ImageList_BeginDrag начинает операцию перетаскивания. Параметры включают дескриптор в список изображений, индекс изображения для перетаскивания и расположение горячей точки в изображении. Горячая точка — это один пиксель, который функции перетаскивания распознают как точное расположение экрана изображения. Как правило, приложение устанавливает горячее место таким образом, чтобы оно совпадало с горячей точкой курсора мыши. Функция ImageList_DragMove перемещает изображение в новое расположение.

Функция ImageList_DragEnter задает начальную позицию изображения перетаскивания в окне и рисует изображение в позиции. Параметры включают дескриптор в окно, в котором рисуется изображение и координаты начальной позиции в окне. Координаты относительно левого верхнего угла окна, а не клиентской области. То же самое верно для всех функций перетаскивания изображений, которые принимают координаты в качестве параметров. Это означает, что при указании координат необходимо компенсировать ширину элементов окна, таких как граница, строка заголовка и строка меню. Если при вызове ImageList_DragEnter указан дескриптор NULL, функции перетаскивания рисуют изображение в контексте устройства, связанном с окном рабочего стола, и координаты относительно левого верхнего угла экрана.

Функция ImageList_SetDragCursorImage создает новое изображение перетаскивания путем объединения заданного изображения (обычно изображения курсора мыши) с текущим изображением перетаскивания. Так как функции перетаскивания используют новое изображение во время операции перетаскивания, следует использовать функцию ShowCursor для скрытия фактического курсора мыши после вызова ImageList_SetDragCursorImage. В противном случае система может иметь два курсора мыши в течение длительности операции перетаскивания.

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

Сведения об изображении

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

Наложения изображений

Каждый список изображений содержит список индексов для использования в качестве наложений. Наложение — это изображение, которое прозрачно рисуется на другом изображении. Любой образ в настоящее время в списке изображений можно использовать в качестве наложения. Можно указать до четырех наложений на список изображений. Это ограничение было расширено до 15 в версии 4.71.

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

При рисовании изображения с помощью функции ImageList_Draw или ImageList_DrawEx указывается наложение. Наложение указывается путем выполнения логической операции OR между нужными флагами рисования и результатом макроса INDEXTOOVERLAYMASK. Макрос INDEXTOOVERLAYMASK принимает индекс наложения и форматирует его для включения с флагами для этих функций. Это приведет к рисованию изображения с указанным наложением. В следующем примере показано, как добавляется наложение и указывается при рисовании изображения.

ImageList_SetOverlayImage(himl, 0, 3);
ImageList_Draw(himl, 1, hdc, 0, 0, ILD_MASK | INDEXTOOVERLAYMASK(3));

Нарисуйте изображение 1, а затем наложите это изображение с изображением 0. Так как 3 — это индекс наложения, указанный в вызове ImageList_SetOverlayImage, 3 помещается в макрос INDEXTOOVERLAYMASK.

32-разрядные антиалиасные значки

Антилайсинг — это техника для смягчения или размытия острых ребер. Это дает изображения более естественного вида. Списки изображений в Windows Vista и Windows 7 поддерживают использование 32-разрядных значков и растровых изображений. Значения цвета используют 24 бита, а 8 битов используются в качестве альфа-канала на значках. Чтобы создать список изображений, который может обрабатывать 32-разрядное изображение на пиксель (bpp), вызовите функцию ImageList_Create , передавая флаг ILC_COLOR32.

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

• Первые три изображения находятся в 16 цветовом режиме для использования в безопасном режиме.
• Следующие три значка используются в 256-цветовом режиме.
• Последние три значка имеют альфа-канал и могут использоваться только в операционных системах под управлением 24-разрядного цвета или более поздней версии.
• Порядок изображений в формате значка имеет значение. Если порядок неправильный, старые версии функции Windows плохо извлекаются при извлечении значков. Неправильное извлечение значков может привести к повреждению памяти и неправильной отрисовке.
• В предыдущих версиях Windows было ограничение ресурсов на 10 значков.