WM_SETHOTKEY

Un'applicazione invia un messaggio WM_SETHOTKEY a una finestra per associare un tasto di scelta rapida della finestra. Quando l'utente preme il tasto di scelta, il sistema attiva la finestra.

WM_SETHOTKEY wParam = MAKEWORD (WPARAM) (vkey, modificatori) / / codice tasto virtuale e i modificatori di hot lParam chiave = 0;                                   / / non utilizzate; deve essere zero 
 

Parametri

vkey
Valore di wParam. Specifica il codice tasto virtuale e modificatori del tasto di scelta rapida per associare la finestra. Il codice tasto virtuale è nel byte basso del parametro e i flag modificatore sono in alto byte. Impostando questo parametro su NULL rimuove il tasto di scelta rapida associato a una finestra. Il byte modificatore può essere una combinazione dei seguenti flag.
Valore Significato
HOTKEYF_ALT Tasto ALT
HOTKEYF_CONTROL Tasto CTRL
HOTKEYF_EXT Chiave estesa
HOTKEYF_SHIFT Tasto Shift

Valori restituiti

Il valore restituito è uno dei seguenti:

Valore Significato
– 1 La funzione è riuscita — il tasto di scelta non è valido.
..0 La funzione è riuscita — la finestra non è valida.
..1 La funzione è successo, e nessun altra finestra ha la stessa chiave di calda.
..2 La funzione viene eseguita correttamente, ma un'altra finestra ha già la stessa chiave di calda.

Osservazioni

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

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

Quando l'utente preme il tasto di scelta, il sistema genera un messaggio WM_SYSCOMMAND con wParam uguale a SC_HOTKEY e lParam uguale all'handle della finestra. Se questo messaggio è passato al DefWindowProc, il sistema porterà ultimo popup attivo della finestra (se esiste) o la finestra stessa (se non non c'è nessuna finestra pop-up) in primo piano.

Una finestra può avere solo un tasto di scelta rapida. Se la finestra ha già un tasto di scelta rapida associato con esso, la nuova chiave calda sostituisce quello vecchio. Se più di una finestra ha la stessa chiave di calda, la finestra che viene attivata da un tasto di scelta rapida è casuale.

Questi tasti di scelta rapida sono estranei ai tasti di scelta rapida impostati da RegisterHotKey.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarata in winuser.

Vedi anche

Cenni preliminari sull'Input di tastiera, i messaggi di Input di tastiera, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index