LVM_SORTITEMSEX сообщение

  • Статья

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

Параметры

wParam

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

lParam

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

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

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

Комментарии

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

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

Это сообщение похоже на LVM_SORTITEMS, за исключением типа информации, передаваемой функции сравнения. При LVM_SORTITEMSEXlParam1 является текущим индексом первого элемента, а lParam2 — текущим индексом второго элемента. При необходимости можно отправить LVM_GETITEMTEXT сообщение, чтобы получить дополнительные сведения об элементе.

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

Примечание

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

Требования

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