ListView_SetColumnWidth 宏 (commctrl.h)

用于更改报表视图中列的宽度或列表视图模式下所有列的宽度。 可以使用此宏或显式发送 LVM_SETCOLUMNWIDTH 消息。

语法

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

参数

hwnd

类型:HWND

列表视图控件的句柄。

iCol

类型:int

有效列的从零开始的索引。 对于列表视图模式,此参数必须设置为零。

cx

类型:int

列的新宽度(以像素为单位)。 对于报表视图模式,支持以下特殊值:

价值 意义
LVSCW_AUTOSIZE
自动调整列的大小。
LVSCW_AUTOSIZE_USEHEADER
自动调整列的大小以适应标题文本。 如果将此值与最后一列一起使用,则其宽度设置为填充列表视图控件的剩余宽度。

返回值

类型:BOOL

如果成功,则返回 TRUE;否则返回 FALSE

言论

假设你有一个宽度为 500 像素的 2 列列表视图控件。 如果列零的宽度设置为 200 像素,则进行以下调用。

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

第二列(最后一列)宽为 300 像素。

请注意,ListView_SetColumnWidthcx 参数转换为 16 位值。

要求

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