CWnd::OnCompareItem

Articolo
02/19/2013

Il framework chiama la funzione membro per specificare la posizione relativa del nuovo elemento in Owner Draw ordinato figlio combinato o casella di riepilogo.

afx_msg int OnCompareItem(
   int nIDCtl,
   LPCOMPAREITEMSTRUCT lpCompareItemStruct 
);

Parametri

nIDCtl
L'identificatore del controllo che ha inviato un messaggio WM_COMPAREITEM.
lpCompareItemStruct
Contiene un puntatore a una struttura di dati COMPAREITEMSTRUCT contenente identificatori e i dati esplicitamente forniti per due elementi nel codice misto o nella casella di riepilogo.

Valore restituito

Indica la posizione relativa dei due elementi.Può essere uno dei seguenti valori:

Valore	Significato
–1	Ordina l'elemento 1 prima dell'elemento 2.
0	Ordinamento l'elemento 1 e l'elemento 2 lo stesso.
1	Ordina l'elemento 1 dopo l'elemento. 2.

Note

Se una casella combinata o di riepilogo viene creato con lo stile LBS_SORT o CBS_SORT, Windows invia il proprietario della casella di riepilogo o della casella combinata un messaggio WM_COMPAREITEM ogni volta che l'applicazione viene aggiunto un nuovo elemento.

Due elementi nel codice misto o la casella di riepilogo sono riformati in una struttura COMPAREITEMSTRUCT indicata da lpCompareItemStruct.OnCompareItem deve restituire un valore che indica gli elementi verranno visualizzati prima dell'altro.In genere, Windows consente a questa chiamata più volte fino a determinare la posizione esatta per il nuovo elemento.

Se il membro hwndItem della struttura COMPAREITEMSTRUCT appartiene a CListBox o oggetto CComboBox, la funzione virtuale CompareItem della classe appropriata viene chiamata.Override CComboBox::CompareItem o CListBox::CompareItem nel CListBox o classe derivata da CComboBox per eseguire il confronto dell'elemento.

[!NOTA]

Questa funzione membro viene chiamata dal framework per consentire l'applicazione per gestire un messaggio di Windows.I parametri passati alla funzione riflettono i parametri ricevuti dal framework quando il messaggio è stato ricevuto.Se si chiama l'implementazione della classe base di questa funzione, tale implementazione dei parametri passati originariamente con il messaggio e non i parametri forniti alla funzione.