Структура 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	Фоновая растровая карта предоставляется через hbm член LVBKIMAGE. Если сообщение 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	Фоновая карта подложки предоставляется через hbm член LVBKIMAGE. Если сообщение 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	commctrl.h