ListView_SortItems 宏 (commctrl.h)

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

语法

void ListView_SortItems(
   hwndLV,
   _pfnCompare,
   _lPrm
);

hwndLV

类型： HWND

列表视图控件的句柄。

_pfnCompare

类型： PFNLVCOMPARE

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

_lPrm

类型： LPARAM

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

无

比较函数具有以下形式。

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

lParam1 参数是与要比较的第一项关联的值;lParam2 参数是与第二项关联的值。这些值是在项的 LVITEM 结构的 lParam 成员中插入列表时指定的值。 lParamSort 参数与传递给LVM_SORTITEMS消息的值相同。

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

注意在排序过程中，列表视图内容不稳定。如果回调函数将任何消息发送到列表视图控件，则结果不可预知。