Структура LVBKIMAGEA (commctrl.h)

  • Статья

Содержит сведения о фоновом изображении элемента управления представлением списка. Эта структура используется как для настройки, так и для получения сведений о фоновом изображении.

Синтаксис

typedef struct tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

Члены

ulFlags

Тип: ULONG

Этот элемент может быть одним или несколькими из следующих флагов. Значение LVBKIF_SOURCE_MASK можно использовать для маскирования всех флагов, кроме исходных флагов. Значение LVBKIF_STYLE_MASK можно использовать для маскирования всех флагов стиля, кроме флагов стиля.

Значение Значение
LVBKIF_SOURCE_NONE
 Элемент управления представлением списка не имеет фонового изображения.
LVBKIF_SOURCE_HBITMAP
 Фоновое растровое изображение предоставляется через элемент HBMLVBKIMAGE. Если сообщение LVM_SETBKIMAGE выполнено успешно, то представление списка берет на себя право собственности на растровое изображение.
LVBKIF_SOURCE_URL
 Элемент pszImage содержит URL-адрес фонового изображения.
LVBKIF_STYLE_NORMAL
 Фоновое изображение отображается в обычном режиме.
LVBKIF_STYLE_TILE
 Фоновое изображение будет выложено плиткой для заполнения всего фона элемента управления.
LVBKIF_FLAG_TILEOFFSET
 Укажите координаты первой плитки. Этот флаг действителен, только если также указан флаг LVBKIF_STYLE_TILE . Если этот флаг не указан, первая плитка начинается в левом верхнем углу клиентской области. При использовании ComCtl32.dll версии 6.0 поля xOffsetPercent и yOffsetPercent содержат пиксели, а не процентные значения, чтобы указать координаты первой плитки. Comctl32.dll версии 6 не распространяется, но включена в Windows или более поздней версии. Кроме того, в манифесте необходимо указать Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.
LVBKIF_TYPE_WATERMARK
 Растровое изображение фона подложки предоставляется через член HBMLVBKIMAGE. Если сообщение LVM_SETBKIMAGE завершается успешно, то элемент управления представлением списка берет на себя право собственности на растровое изображение.
LVBKIF_FLAG_ALPHABLEND
 Допустимо только при указании LVBKIF_TYPE_WATERMARK. Этот флаг указывает, что растровое изображение, предоставленное через LVBKIF_TYPE_WATERMARK содержит допустимый альфа-канал.

hbm

Тип: HBITMAP

Дескриптор фонового растрового изображения. Этот элемент действителен, только если флаг LVBKIF_SOURCE_HBITMAP установлен в ulFlags.

pszImage

Тип: LPTSTR

Адрес строки со значением NULL, содержащей URL-адрес фонового изображения. Этот элемент действителен, только если флаг LVBKIF_SOURCE_URL установлен в ulFlags. Этот элемент необходимо инициализировать, чтобы указать на буфер, который содержит или получает текст перед отправкой сообщения.

cchImageMax

Тип: UINT

Размер буфера по адресу в pszImage. Если сведения отправляются в элемент управления, этот элемент игнорируется.

xOffsetPercent

Тип: int

Процент клиентской области элемента управления, по которому изображение должно быть смещено по горизонтали. Например, при значении 0 процентов изображение будет отображаться по левому краю клиентской области элемента управления. На уровне 50 процентов изображение будет отображаться по горизонтали по центру в клиентской области элемента управления. На 100 процентов изображение будет отображаться по правому краю клиентской области элемента управления. Этот член действителен, только если LVBKIF_STYLE_NORMAL указан в ulFlags. Если LVBKIF_FLAG_TILEOFFSET и LVBKIF_STYLE_TILE указаны в ulFlags, то значение указывает пиксель, а не смещение в процентах первой плитки. В противном случае значение игнорируется.

yOffsetPercent

Тип: int

Процент клиентской области элемента управления, по которому изображение должно быть смещение по вертикали. Например, при значении 0 процентов изображение будет отображаться на верхнем крае клиентской области элемента управления. На уровне 50 процентов изображение будет отображаться по вертикали по центру в клиентской области элемента управления. На 100 процентов изображение будет отображаться в нижней части клиентской области элемента управления. Этот член действителен, только если LVBKIF_STYLE_NORMAL указан в ulFlags. Если LVBKIF_FLAG_TILEOFFSET и LVBKIF_STYLE_TILE указаны в ulFlags, то значение указывает пиксель, а не смещение в процентах первой плитки. В противном случае значение игнорируется.

Комментарии

Эта структура используется с LVM_GETBKIMAGE и LVM_SETBKIMAGE сообщениями.

Примечание

Заголовок commctrl.h определяет LVBKIMAGE в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h