CWnd::OnCompareItem

Artikel
02/26/2013

Das Framework ruft diese Memberfunktion auf, um die relative Position eines neuen Elements in einem untergeordneten Element anzugeben sortierte Ownerdrawnkombinationsfeld oder -Listenfeld.

afx_msg int OnCompareItem(
   int nIDCtl,
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Parameter

nIDCtl
Der Bezeichner des Steuerelements, das die WM_COMPAREITEM Meldung gesendet.
lpCompareItemStruct
Enthält einen langen Zeiger auf eine COMPAREITEMSTRUCT Datenstruktur, die die Bezeichner und die von der Anwendung bereitgestellten Daten für zwei Elemente im Kombinationsfeld oder im Listenfeld enthält.

Rückgabewert

Gibt die relative Position der beiden Elemente.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.

Hinweise

Wenn ein Kombinationsfeld oder ein Listenfeld mit dem CBS_SORT oder LBS_SORT Format erstellt wird, sendet Windows den Kombinationsfeld- oder Listenfeldbesitzer eine WM_COMPAREITEM Meldung, wenn die Anwendung ein neues Element hinzufügt.

Zwei Elemente im Kombinationsfeld oder im Listenfeld werden in einer Struktur COMPAREITEMSTRUCT verbessert, die auf durch lpCompareItemStruct gezeigt wird.OnCompareItem sollte einen Wert zurückgeben, der angibt, das aus den Elementen vor dem anderen angezeigt werden soll.In der Regel macht Windows diesen Aufruf mehrmals, bis er die genaue Position für den neuen Artikel bestimmt.

Wenn der hwndItem-Member der Struktur COMPAREITEMSTRUCTCListBox oder CComboBox-Objekt gehört, wird die virtuelle Funktion CompareItem der entsprechenden Klasse aufgerufen.Überschreiben CComboBox::CompareItem oder CListBox::CompareItem im abgeleiteten CListBox oder in CComboBox-Klasse, um den Elementvergleiches durchzuführen.

Hinweis
Diese Memberfunktion wird vom Framework aufgerufen, um die Anwendung zu ermöglichen, eine Windows-Meldung zu bearbeiten.Die Parameter, die an die Funktion übergeben werden, geben die Parameter, die vom Framework empfangen werden, als die Nachricht empfangen wurde.Wenn Sie die Basisklassenimplementierung dieser Funktion aufrufen, verwendet diese Implementierung die Parameter, die mit der Meldung übergeben werden und nicht die Parameter, die an die Funktion bereitstellen.

Diese Memberfunktion wird vom Framework aufgerufen, um die Anwendung zu ermöglichen, eine Windows-Meldung zu bearbeiten.Die Parameter, die an die Funktion übergeben werden, geben die Parameter, die vom Framework empfangen werden, als die Nachricht empfangen wurde.Wenn Sie die Basisklassenimplementierung dieser Funktion aufrufen, verwendet diese Implementierung die Parameter, die mit der Meldung übergeben werden und nicht die Parameter, die an die Funktion bereitstellen.