CListBox::CompareItem

Статья
02/20/2013

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

virtual int CompareItem(
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Параметры

lpCompareItemStruct
Длинный указатель на структуру COMPAREITEMSTRUCT.

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

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

Значение	Значение
–1	Сортировки элемента 1 перед элементом 2.
0	Сортировка элементов 1 и элемента 2.
1	Сортировки элемента 1 после элемента 2.

См. раздел CWnd::OnCompareItem для описания структуры COMPAREITEMSTRUCT.

Заметки

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

Пример

// CMyODListBox is my owner-drawn list box derived from CListBox. This 
// example compares two items using _tcscmp to sort items in reverse 
// alphabetical order. The list box control was created with the 
// following code:
//   m_myODListBox.Create(
//      WS_CHILD|WS_VISIBLE|WS_BORDER|WS_HSCROLL|WS_VSCROLL|
//      LBS_SORT|LBS_MULTIPLESEL|LBS_OWNERDRAWVARIABLE|LBS_WANTKEYBOARDINPUT,
//      CRect(10,250,200,450), pParentWnd, IDC_MYODLISTBOX);
//
int CMyODListBox::CompareItem(LPCOMPAREITEMSTRUCT lpCompareItemStruct)
{
   ASSERT(lpCompareItemStruct->CtlType == ODT_LISTBOX);
   LPCTSTR lpszText1 = (LPCTSTR) lpCompareItemStruct->itemData1;
   ASSERT(lpszText1 != NULL);
   LPCTSTR lpszText2 = (LPCTSTR) lpCompareItemStruct->itemData2;
   ASSERT(lpszText2 != NULL);

   return _tcscmp(lpszText2, lpszText1);
}