Condividi tramite


CWnd::OnCompareItem

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.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CWnd

Grafico delle gerarchie

Struttura COMPAREITEMSTRUCT

WM_COMPAREITEM

CListBox::CompareItem

CComboBox::CompareItem