LVM_SORTITEMS сообщение

  • Статья

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

Параметры

wParam

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

lParam

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

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

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

Комментарии

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

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

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

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

Примечание

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

Требования

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