ListView_SetItemPosition宏 (commctrl.h)

将项移动到列表视图控件中的指定位置(在图标或小图标视图中)。 可以使用此宏或显式发送 LVM_SETITEMPOSITION 消息。

语法

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

参数

hwndLV

类型:HWND

列表视图控件的句柄。

i

类型:int

列表视图项的索引。

x

类型:int

项左上角的新 x 位置(以视图坐标表示)。

y

类型:int

项左上角的新 y 位置(以视图坐标为单位)。

返回值

类型:BOOL

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

言论

如果列表视图控件具有 LVS_AUTOARRANGE 样式,则列表视图控件在设置项目的位置后排列。

在 Windows Vista 上,在具有 LVS_AUTOARRANGE 样式的列表视图控件上调用此宏不执行任何操作,并且返回值 FALSE

要求

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