LVM_SORTITEMSEX消息

使用应用程序定义的比较函数对列表视图控件的项进行排序。 每个项的索引都会更改，以反映新序列。 可以显式发送此消息，也可以使用 ListView_SortItemsEx 宏发送。

参数

wParam

传递给比较函数的应用程序定义值。

lParam

指向应用程序定义的比较函数的指针。 每次需要比较两个列表项的相对顺序时，都会在排序操作期间调用它。

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。

备注

比较函数具有以下形式：

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);  

此消息类似于 LVM_SORTITEMS，但传递给比较函数的信息类型除外。 使用 LVM_SORTITEMSEX， lParam1 是第一项的当前索引， lParam2 是第二项的当前索引。 如果需要，可以发送 LVM_GETITEMTEXT 消息以检索有关项的详细信息。

如果第一个项应位于第二个项之前，则比较函数必须返回负值;如果第一个项应紧跟第二个项，则返回正值;如果两个项等效，则比较函数必须返回零值。

备注

在排序过程中，列表视图内容不稳定。 如果回调函数将除LVM_GETITEM (ListView_GetItem) 之外的任何消息发送到列表视图控件，则结果不可预知。

要求

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