通过

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
 背景位图通过 LVBKIMAGE 的 hbm 成员提供。 如果消息 LVM_SETBKIMAGE 成功，则列表视图将拥有位图的所有权。
LVBKIF_SOURCE_URL
 pszImage 成员包含背景图像的 URL。
LVBKIF_STYLE_NORMAL
 背景图像正常显示。
LVBKIF_STYLE_TILE
 将平铺背景图像以填充控件的整个背景。
LVBKIF_FLAG_TILEOFFSET
 指定第一个磁贴的坐标。 仅当还指定 了LVBKIF_STYLE_TILE 标志时，此标志才有效。 如果未指定此标志，则第一个磁贴从工作区的左上角开始。 如果使用版本 6.0 ComCtl32.dll xOffsetPercent 和 yOffsetPercent 字段包含像素（而不是百分比值）来指定第一个磁贴的坐标。 Comctl32.dll 版本 6 不可再发行，但包含在 Windows 或更高版本中。 此外，必须在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息，请参阅 启用视觉样式。
LVBKIF_TYPE_WATERMARK
 通过 LVBKIMAGE 的 hbm 成员提供水印背景位图。 如果 LVM_SETBKIMAGE 消息成功，则列表视图控件将拥有位图的所有权。
LVBKIF_FLAG_ALPHABLEND
 仅当同时指定了LVBKIF_TYPE_WATERMARK时才有效。 此标志指示通过LVBKIF_TYPE_WATERMARK提供的位图包含有效的 alpha 通道。

hbm

类型： HBITMAP

背景位图的句柄。 仅当在 ulFlags 中设置了LVBKIF_SOURCE_HBITMAP标志时，此成员才有效。

pszImage

类型： LPTSTR

包含背景图像 URL 的以 NULL 结尾的字符串的地址。 仅当在 ulFlags 中设置了LVBKIF_SOURCE_URL标志时，此成员才有效。 在发送消息之前，此成员必须初始化为指向包含或接收文本的缓冲区。

cchImageMax

类型： UINT

pszImage 中地址处的缓冲区大小。 如果将信息发送到控件，则忽略此成员。

xOffsetPercent

类型： int

图像应水平偏移的控件工作区的百分比。 例如，在 0% 时，图像将针对控件工作区的左边缘显示。 在 50% 时，图像将在控件的工作区中水平居中显示。 在 100% 时，图像将针对控件工作区的右边缘显示。 仅当在 ulFlags 中指定LVBKIF_STYLE_NORMAL时，此成员才有效。 如果在 ulFlags 中同时指定了LVBKIF_FLAG_TILEOFFSET和LVBKIF_STYLE_TILE，则 该值指定第一个磁贴的像素偏移量，而不是百分比偏移量。 否则，将忽略该值。

yOffsetPercent

类型： int

图像应垂直偏移的控件工作区的百分比。 例如，在 0% 时，图像将针对控件工作区的上边缘显示。 在 50% 时，图像将在控件的工作区中垂直居中显示。 在 100% 时，图像将针对控件工作区的下边缘显示。 仅当在 ulFlags 中指定LVBKIF_STYLE_NORMAL时，此成员才有效。 如果在 ulFlags 中同时指定了LVBKIF_FLAG_TILEOFFSET和LVBKIF_STYLE_TILE，则 该值指定第一个磁贴的像素偏移量，而不是百分比偏移量。 否则，将忽略该值。

注解

此结构用于 LVM_GETBKIMAGE 和 LVM_SETBKIMAGE 消息。

注意

commctrl.h 标头将 LVBKIMAGE 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h