ListView_SetColumnWidth 宏 (commctrl.h)

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

语法

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   cx
);

参数

hwnd

类型: HWND

列表视图控件的句柄。

iCol

类型: int

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

cx

类型: int

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

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

返回值

备注

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

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

第二个 (和最后一个) 列的宽度为 300 像素。

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

要求

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