CWnd::OnCompareItem

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

afx_msg int OnCompareItem(
   int nIDCtl,
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Параметры

  • nIDCtl
    Идентификатор элемента управления, отправившего сообщение WM_COMPAREITEM.

  • lpCompareItemStruct
    Содержит длинный указатель на структуру данных COMPAREITEMSTRUCT, содержащий идентификаторы и приложение-, предоставляемые данные для 2 элементов в комбинированном или списка.

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

Указывает относительное положение 2 элементов.Она может быть люба следующих значений:

Значение

Значение

–1

Сортировки элемента 1 перед элементом 2.

0

Сортировка элементов 1 и элемента 2.

1

Сортировки элемента 1 после элемента 2.

Заметки

Если комбинированное или список созданы с учетом CBS_SORT или LBS_SORT Windows отправляет владелец поля со списком или списка сообщение WM_COMPAREITEM, когда приложение добавляет новый элемент.

2 Элемента в комбинированном списке реформированы или в структуре COMPAREITEMSTRUCT указанной в lpCompareItemStruct.OnCompareItem должно возвращать значение, указывающее, какие из элементов должно стоять перед другим.Как правило, этот вызов Windows поддерживает несколько раз, до тех пор, пока он не определит точную позицию для нового элемента.

Если участник hwndItem структуры COMPAREITEMSTRUCT принадлежит к CListBox или объект CComboBox, то называется виртуальная функция CompareItem соответствующего класса.Переопределение CComboBox::CompareItem или CListBox::CompareItem в производных CListBox или классе CComboBox чтобы сделать сравнение элемента.

ПримечаниеПримечание

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

Требования

Header: afxwin.h

См. также

Ссылки

Класс CWnd

Диаграмма иерархии

Структура COMPAREITEMSTRUCT

WM_COMPAREITEM

CListBox::CompareItem

CComboBox::CompareItem