CListBox::CompareItem

Artikel
02/26/2013

Aufgerufen vom Framework, um die relative Position eines neuen Elements in einem sortierten Ownerdrawn Listenfeld zu bestimmen.

virtual int CompareItem(
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Parameter

lpCompareItemStruct
Ein langer Zeiger auf eine Struktur COMPAREITEMSTRUCT.

Rückgabewert

Gibt die relative Position der beiden Elemente an, die in der COMPAREITEMSTRUCT-Struktur beschrieben werden.Sie kann einer der folgenden Werte:

Wert	Bedeutung
–1	Element 1 sortiert vor Element 2.
0	Sortierung des Elements 1 und 2 des Elements identisch.
1	Element 1 sortiert nach Element 2.

Siehe CWnd::OnCompareItem für eine Beschreibung der COMPAREITEMSTRUCT-Struktur.

Hinweise

Standardmäßig hat diese Memberfunktion nichts.Wenn Sie ein Ownerdrawn Listenfeld mit dem LBS_SORT Format erstellen, müssen Sie diese Memberfunktion überschreiben, um dem Framework in den Sortierungsneuen artikeln helfen, die dem Listenfeld hinzugefügt werden.

Beispiel

// 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);
}