макрос ListView_SortItems (commctrl.h)

  • Статья

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

Синтаксис

void ListView_SortItems(
   hwndLV,
   _pfnCompare,
   _lPrm
);

Параметры

hwndLV

Тип: HWND

Дескриптор элемента управления представлением списка.

_pfnCompare

Тип: PFNLVCOMPARE

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

_lPrm

Тип: LPARAM

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

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

None

Remarks

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

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

Параметр lParam1 — это значение, связанное с первым сравниваемого элемента; Параметр lParam2 — это значение, связанное со вторым элементом. Это значения, которые были указаны в элементе lParam структуры LVITEM элементов при их вставке в список. Параметр lParamSort — это то же значение, которое передается LVM_SORTITEMS сообщению.

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

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

Требования

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