ListView_SetIconSpacing 宏 (commctrl.h)

设置列表视图控件中设置为 LVS_ICON 样式的图标之间的间距。 可以使用此宏或显式发送 LVM_SETICONSPACING 消息。

语法

DWORD ListView_SetIconSpacing(
   HWND hwndLV,
   int  cx,
   int  cy
);

参数

hwndLV

类型:HWND

列表视图控件的句柄。

cx

类型:int

在 x 轴上的图标之间设置的距离(以像素为单位)。

cy

类型:int

在 y 轴上的图标之间设置的距离(以像素为单位)。

返回值

类型:DWORD

返回包含上一个 DWORD 的 DWORD

言论

cxcy 参数相对于图标位图的左上角。 因此,若要设置不重叠的图标之间的间距,cxcy 值必须包含图标的大小,以及图标之间所需的空白空间量。 不包含图标宽度的值将导致重叠。

定义图标间距时,cxcy 必须设置为 4 或更大。 较小的值不会生成所需的布局。 通过将两个值设置为 -1,可以将 cxcy 重置为默认间距。 此方法仅允许重置这两个默认设置。 不能仅通过将其中一 个设置为 -1,将 cxcy 重置为默认设置。

要求

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