CWnd::OnCompareItem

發行項
02/28/2013

這個架構在組合子系排序的主控描繪或清單方塊呼叫此成員函式指定新項目的相對位置。

afx_msg int OnCompareItem(
   int nIDCtl,
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

參數

nIDCtl
傳送 WM_COMPAREITEM 資訊控制項的識別項。
lpCompareItemStruct
包含長指標陣列或清單方塊包含識別項以及應用程式提供的資料為兩個項目的 COMPAREITEMSTRUCT 資料結構。

傳回值

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

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

備註

如果群組或清單方塊會以 CBS_SORT 或 LBS_SORT 樣式，視窗會指派下拉式方塊或清單方塊的主控 WM_COMPAREITEM 訊息，每當應用程式將新的項目。

陣列或清單方塊的兩個項目在 COMPAREITEMSTRUCT 結構已變更所指向的 lpCompareItemStruct。 OnCompareItem 應該傳回值的項目應該在其他的外觀。通常， Windows 進行此呼叫數次，直到判斷新項目的正確位置。

如果 COMPAREITEMSTRUCT 結構的 hwndItem 成員屬於 CListBox 或物件，則 CComboBox 適當類別的 CompareItem 虛擬函式呼叫。在您要使項目比較的衍生 CListBox 或 CComboBox 類別的覆寫 CComboBox::CompareItem 或 CListBox::CompareItem 。

注意事項
此成員函式由架構呼叫可以讓您的應用程式處理 Windows 訊息。接收訊息時，參數會傳遞至函式反映這個框架接收的參數。如果您呼叫這個函式的基底類別實作，該實作會使用這個參數起始傳入訊息所提供函式取代的參數。