messaggio WM_COMPAREITEM

Inviato per determinare la posizione relativa di un nuovo elemento nell'elenco ordinato di una casella combinata o di una casella di riepilogo disegnata dal proprietario. Ogni volta che l'applicazione aggiunge un nuovo elemento, il sistema invia questo messaggio al proprietario di una casella combinata o di una casella di riepilogo creata con lo stile CBS_SORT o LBS_SORT .

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam; 

Parametri

wParam

Specifica l'identificatore del controllo che ha inviato il messaggio di WM_COMPAREITEM .

lParam

Puntatore a una struttura COMPAREITEMSTRUCT che contiene gli identificatori e i dati forniti dall'applicazione per due elementi nella casella di riepilogo o combinata.

Valore restituito

Il valore restituito indica la posizione relativa dei due elementi. Può essere uno dei valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
Valore	Significato
-1	L'elemento 1 precede l'elemento 2 nell'ordine ordinato.
0	Gli elementi 1 e 2 sono equivalenti nell'ordine ordinato.
1	L'elemento 1 segue l'elemento 2 nell'ordine ordinato.

Commenti

Quando il proprietario di una casella combinata o una casella di riepilogo disegnata dal proprietario riceve questo messaggio, il proprietario restituisce un valore che indica quali elementi specificati dalla struttura COMPAREITEMSTRUCT verranno visualizzati prima dell'altro. In genere, il sistema invia il messaggio più volte finché non determina la posizione esatta per il nuovo elemento.

Se una finestra di dialogo gestisce questo messaggio, deve eseguire il cast del valore restituito desiderato in un valore BOOL e restituire direttamente il valore. Il valore DWL_MSGRESULT impostato dalla funzione SetWindowLong viene ignorato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

COMPAREITEMSTRUCT

Altre risorse

Setwindowlong