Share via


CListBox::CompareItem

並べ替えられたオーナー描画リスト ボックスに新しい項目の相対位置を決定するために、フレームワークによって呼び出されます。

virtual int CompareItem(
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

パラメーター

  • lpCompareItemStruct
    COMPAREITEMSTRUCT の長い構造体へのポインター。

戻り値

COMPAREITEMSTRUCT の構造に示す 2 種類の項目の相対位置を示します。これは、の値である可能性があります:

説明

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

必要条件

ヘッダー: afxwin.h

参照

関連項目

CListBox クラス

階層図

WM_COMPAREITEM

CWnd::OnCompareItem

CListBox::DrawItem

CListBox::MeasureItem

CListBox::DeleteItem