Share via

messaggio WM_SETHOTKEY

  • Articolo

Inviato a una finestra per associare una chiave 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

La parola a basso ordine specifica il codice della chiave virtuale da associare alla finestra.

La parola ad ordine elevato può essere una o più dei valori seguenti da CommCtrl.h.

L'impostazione di wParam su NULL rimuove la chiave di scelta rapida associata a una finestra.

Valore Significato
HOTKEYF_ALT
0x04
 ALT (tasto)
HOTKEYF_CONTROL
0x02
 TASTO CTRL
HOTKEYF_EXT
0x08
 Chiave estesa
HOTKEYF_SHIFT
0x01
 TASTO MAIUSC

lParam

Questo parametro non viene usato.

Valore restituito

Il valore restituito è uno dei seguenti.

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

Commenti

Non è possibile associare una chiave di scelta rapida a una finestra figlio.

VK_ESCAPE, VK_SPACE e VK_TAB sono chiavi di scelta rapida non valide.

Quando l'utente preme il tasto di scelta rapida, il sistema genera un messaggio 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 presente) o la finestra stessa (se non esiste alcuna finestra popup) in primo piano.

Una finestra può avere un solo tasto di scelta rapida. Se la finestra dispone già di un tasto di scelta rapida associata, la nuova chiave di scelta rapida sostituisce quella precedente. Se più finestre hanno la stessa chiave di scelta rapida, la finestra attivata dalla chiave 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)

Vedi anche

Riferimento

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Informazioni concettuali

Input della tastiera