WM_SETHOTKEY messaggio

Inviato a una finestra per associare un tasto di scelta rapida alla finestra. Quando l'utente preme il tasto di scelta rapida, il sistema attiva la finestra.

#define WM_SETHOTKEY                    0x0032

Parametri

wParam

Il byte basso della parola con ordine basso specifica il codice della chiave virtuale da associare alla finestra.

Il byte elevato della parola con ordine basso può essere uno o più dei valori seguenti di CommCtrl.h.

Valore	Significato
HOTKEYF_ALT 0x04	Tasto ALT
HOTKEYF_CONTROL 0x02	TASTO CTRL
HOTKEYF_EXT 0x08	Chiave estesa
HOTKEYF_SHIFT 0x01	Tasto SHIFT

La parola dell'ordine elevato di wParam viene ignorata.

L'impostazione di wParam su NULL rimuove il tasto di scelta rapida associato a una finestra.

lParam

Questo parametro non viene usato.

Valore restituito

Il valore restituito è uno dei seguenti.

Valore restituito	Descrizione
-1	La funzione ha esito negativo; il tasto di scelta rapida non è valido.
0	La funzione ha esito negativo; la finestra non è valida.
1	La funzione ha esito positivo e nessun'altra finestra ha lo stesso tasto di scelta rapida.
2	La funzione ha esito positivo, ma un'altra finestra ha già lo stesso tasto di scelta rapida.

Osservazioni:

Un tasto di scelta rapida non può essere associato a una finestra figlio.

VK_ESCAPE, VK_SPACE, VK_TAB e VK_PACKET sono tasti di scelta rapida non validi.

Quando l'utente preme il tasto di scelta rapida, il sistema genera un messaggio di WM_SYSCOMMAND con wParam uguale a SC_HOTKEY e lParam uguale all'handle della finestra. Se questo messaggio viene passato a DefWindowProc, il sistema porterà l'ultimo popup attivo della finestra (se esistente) o la finestra stessa (se non è presente alcuna finestra popup) in primo piano.

Una finestra può avere un solo tasto di scelta rapida. Se alla finestra è già associato un tasto di scelta rapida, il nuovo tasto di scelta rapida sostituisce quello precedente. Se più finestre hanno lo stesso tasto di scelta rapida, la finestra attivata dal tasto di scelta rapida è casuale.

Questi tasti di scelta rapida non sono correlati ai tasti di scelta rapida impostati da RegisterHotKey.

Requisiti

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

Vedere anche

Riferimento

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Concettuale

input da tastiera