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 |
|
Vedi anche
-
Riferimento
-
Altre risorse