WM_VKEYTOITEM messaggio

Inviato da una casella di riepilogo con lo stile LBS_WANTKEYBOARDINPUT al proprietario in risposta a un messaggio di WM_KEYDOWN .

WM_VKEYTOITEM

    WPARAM wParam;
    LPARAM lParam; 

Parametri

wParam

LOWORD specifica il codice di tasto virtuale del tasto premuto dall'utente. L'HIWORD specifica la posizione corrente del cursore.

lParam

Handle nella casella di riepilogo.

Valore restituito

Il valore restituito specifica l'azione eseguita dall'applicazione in risposta al messaggio. Un valore restituito -2 indica che l'applicazione ha gestito tutti gli aspetti della selezione dell'elemento e non richiede ulteriori azioni dalla casella di riepilogo. (Vedere la sezione Osservazioni). Il valore restituito -1 indica che la casella di riepilogo deve eseguire l'azione predefinita in risposta alla sequenza di tasti. Un valore restituito pari a 0 o superiore specifica l'indice di un elemento nella casella di riepilogo e indica che la casella di riepilogo deve eseguire l'azione predefinita per la sequenza di tasti sull'elemento specificato.

Osservazioni:

Il valore restituito -2 è valido solo per le chiavi non convertite in caratteri dal controllo casella di riepilogo. Se il messaggio WM_KEYDOWN viene convertito in un messaggio di WM_CHAR e l'applicazione elabora il messaggio WM_VKEYTOITEM generato in seguito alla pressione del tasto, la casella di riepilogo ignora il valore restituito e esegue l'elaborazione predefinita per tale carattere. WM_KEYDOWN messaggi generati da chiavi quali VK_UP, VK_DOWN, VK_NEXT e VK_PREVIOUS non vengono convertiti in messaggi di WM_CHAR. In questi casi, l'intercettazione del messaggio WM_VKEYTOITEM e la restituzione di -2 impedisce alla casella di riepilogo di eseguire l'elaborazione predefinita per tale chiave.

Per intercettare le chiavi che generano un messaggio char ed eseguono un'elaborazione speciale, l'applicazione deve sottoclassare la casella di riepilogo, intercettare sia i messaggi WM_KEYDOWN che i messaggi WM_CHAR ed elaborare i messaggi in modo appropriato nella routine della sottoclasse.

Le note precedenti si applicano alle normali caselle di riepilogo create con lo stile LBS_WANTKEYBOARDINPUT. Se la casella di riepilogo è disegnata dal proprietario, l'applicazione deve elaborare il messaggio WM_CHARTOITEM.

La funzione DefWindowProc restituisce -1.

Se una routine della finestra di dialogo gestisce questo messaggio, deve eseguire il cast del valore restituito desiderato a 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

WM_CHARTOITEM

Altre risorse

HIWORD

LOWORD

WM_KEYDOWN