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 值来屏蔽除样式标志之外的所有标志。
值 | 含义 |
---|---|
|
列表视图控件没有背景图像。 |
|
背景位图通过 LVBKIMAGE 的 hbm 成员提供。 如果消息 LVM_SETBKIMAGE 成功,则列表视图将拥有位图的所有权。 |
|
pszImage 成员包含背景图像的 URL。 |
|
背景图像正常显示。 |
|
将平铺背景图像以填充控件的整个背景。 |
|
指定第一个磁贴的坐标。 仅当还指定 了LVBKIF_STYLE_TILE 标志时,此标志才有效。 如果未指定此标志,则第一个磁贴从工作区的左上角开始。 如果使用版本 6.0 ComCtl32.dll xOffsetPercent 和 yOffsetPercent 字段包含像素(而不是百分比值)来指定第一个磁贴的坐标。 Comctl32.dll 版本 6 不可再发行,但包含在 Windows 或更高版本中。 此外,必须在清单中指定 Comctl32.dll 版本 6。 有关清单的详细信息,请参阅 启用视觉样式。 |
|
通过 LVBKIMAGE 的 hbm 成员提供水印背景位图。 如果 LVM_SETBKIMAGE 消息成功,则列表视图控件将拥有位图的所有权。 |
|
仅当同时指定了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 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈