CListBox::CompareItem

Article
06/10/2015

Appelé par l'infrastructure pour déterminer la position relative d'un nouvel élément dans une zone de liste triée owner-draw.

virtual int CompareItem( 
   LPCOMPAREITEMSTRUCT lpCompareItemStruct  
);

Paramètres

lpCompareItemStruct
Un long pointeur vers une structure d' COMPAREITEMSTRUCT .

Valeur de retour

Indique la position relative des deux éléments décrits dans la structure de COMPAREITEMSTRUCT . Elle peut avoir l'une des valeurs suivantes :

Valeur	Signification
–1	Trie de priorité 1 avant l'élément 2.
0	Tri de priorité 1 et 2 du point les mêmes.
1	Trie du point 1 après le point 2.

Consultez CWnd::OnCompareItem pour obtenir une description de la structure d' COMPAREITEMSTRUCT .

Notes

Par défaut, cette fonction membre ne fait rien. Si vous créez une zone de liste owner-draw avec le style de LBS_SORT , vous devez substituer cette fonction membre pour aider l'infrastructure du tri de nouveaux éléments ajoutés à la zone de liste.

Exemple

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