LVM_SORTITEMS消息
使用应用程序定义的比较函数对列表视图控件的项进行排序。 每个项的索引都会更改,以反映新序列。 可以显式发送此消息,也可以使用 ListView_SortItems 宏发送。
参数
-
wParam
-
传递给比较函数的应用程序定义值。
-
lParam
-
指向应用程序定义的比较函数的指针。 每次需要比较两个列表项的相对顺序时,都会在排序操作期间调用比较函数。
返回值
如果成功,则返回 TRUE ,否则返回 FALSE 。
备注
比较函数具有以下形式:
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
lParam1 参数是与要比较的第一项关联的值,lParam2 参数是与第二项关联的值。 这些是在项的 LVITEM 结构的 lParam 成员中插入到列表中时指定的值。 ListView_SortItems的 wParam 参数作为其第三个参数传递给回调函数。
如果第一个项应位于第二个项之前,则比较函数必须返回负值;如果第一个项应紧跟第二个项,则返回正值;如果两个项等效,则比较函数必须返回零值。
备注
在排序过程中,列表视图内容不稳定。 如果回调函数将除LVM_GETITEM (ListView_GetItem) 之外的任何消息发送到列表视图控件,则结果不可预知。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|