сообщение LVM_SORTITEMS

Использует определяемую приложением функцию сравнения для сортировки элементов элемента управления представления списка. Индекс каждого элемента изменяется в соответствии с новой последовательностью. Это сообщение можно отправить явным образом или с помощью макроса ListView_SortItems .

Параметры

wParam

Определяемое приложением значение, передаваемое в функцию сравнения.

lParam

Указатель на определяемую приложением функцию сравнения. Функция сравнения вызывается во время операции сортировки при каждом сравнении относительного порядка двух элементов списка.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или false в противном случае.

Remarks

Функция сравнения имеет следующую форму:

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

Параметр lParam1 — это значение, связанное с сравниваемого первого элемента, а параметр lParam2 — значение, связанное со вторым элементом. Это значения, указанные в элементе lParam структуры LVITEM элементов при их вставке в список. Параметр wParamListView_SortItems передается функции обратного вызова в качестве третьего параметра.

Функция сравнения должна возвращать отрицательное значение, если первый элемент должен предшествовать второму, положительное значение, если первый элемент должен следовать второму, или ноль, если два элемента эквивалентны.

Примечание

Во время сортировки содержимое представления списка является нестабильным. Если функция обратного вызова отправляет сообщения в элемент управления представлением списка в сторону от LVM_GETITEM (ListView_GetItem), результаты будут непредсказуемыми.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Header	Commctrl.h