CListBox::CompareItem

發行項
06/10/2015

呼叫由架構判斷新項目的相對位置 (排序的主控描繪清單方塊。

virtual int CompareItem( 
   LPCOMPAREITEMSTRUCT lpCompareItemStruct  
);

參數

lpCompareItemStruct
為 COMPAREITEMSTRUCT 結構的長度的指標。

傳回值

表示 COMPAREITEMSTRUCT 結構描述的兩個項目的相對位置。可以是下列其中一個值:

值	意義
–1	在項目 2. 之前的項目 1 排序。
0	項目 1 和 2 項目排序相同。
1	在項目 2. 之後的項目 1 排序。

提供 COMPAREITEMSTRUCT 架構的說明請參閱 CWnd::OnCompareItem 。

備註

根據預設，此成員函式不會執行任何動作。如果您建立了 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);
}