RegisterHotKey

La funzione RegisterHotKey definisce un tasto di scelta di tutto il sistema.

(BOOL RegisterHotKey HWND  hWnd, / / finestra per ricevere la notifica di tastiint id, / / identificatore del tasto di scelta rapidaUINTfsModifiers, / / tasto modificatore flagsUINTVK / / tasto virtuale di codice);
 

Parametri

hWnd

Gestire alla finestra che riceverà i messaggi WM_HOTKEY generati dal tasto di scelta rapida. Se questo parametro è NULL, WM_HOTKEY messaggi sono inviati per la coda di messaggi del thread chiamante e devono essere elaborati nel ciclo di messaggi.

identificazione

Specifica l'identificatore del tasto di scelta rapida. Nessun altro tasto caldo nel thread chiamante deve avere lo stesso identificatore. Un'applicazione è necessario specificare un valore nella gamma 0x0000 attraverso 0xBFFF. Una libreria a collegamento dinamico (DLL) condivisa deve specificare un valore nella gamma 0xC000 attraverso 0xFFFF (la gamma restituita dalla GlobalAddAtom funzione). Per evitare conflitti con tasti identificatori definiti da altre DLL condivise, una DLL deve utilizzare la funzione GlobalAddAtom per ottenere l'identificatore di tasti.

fsModifiers

Specifica i tasti che devono essere premuti in combinazione con la chiave specificata dal parametro nVirtKey per generare il messaggio WM_HOTKEY. Il parametro fsModifiers può essere una combinazione dei seguenti valori.

Valore	Significato
MOD_ALT	O tasto alt deve essere tenuto premuto.
MOD_CONTROL	O tasto ctrl deve essere tenuto premuto.
MOD_SHIFT	O Maiusc deve essere tenuto premuto.
MOD_WIN	O tasto WINDOWS si tenne. Questi tasti sono etichettati con il logo di Microsoft Windows.

vk

Specifica il codice tasto virtuale del tasto di scelta rapida.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Quando viene premuto un tasto, il sistema cerca un match contro tutti i tasti di scelta rapida. Su di trovare una corrispondenza, il sistema invia il messaggio WM_HOTKEY per la coda di messaggi del thread che ha registrato il tasto di scelta. Questo messaggio è inviato all'inizio della coda così esso viene rimosso per la prossima iterazione del ciclo di messaggi.

Questa funzione non è possibile associare un tasto di scelta rapida con una finestra creata da un altro thread.

RegisterHotKey non riesce se la sequenza di tasti specificata per il tasto di scelta è già stati registrati da un altro tasto di scelta rapida.

Se la finestra identificata dal parametro hWnd già registrato un tasto di scelta rapida con lo stesso identificatore di quello specificato dal parametro id , i nuovi valori per i parametri fsModifiers e vk sostituiscono i valori specificati in precedenza per questi parametri.

Windows CE: Le versioni di Windows CE 2.0 e versioni successive supportano un flag aggiuntivo, chiamato MOD_KEYUP, per il parametro fsModifiers . Se si imposta il flag MOD_KEYUP, la finestra verrà inviata un messaggio WM_HOTKEY su una chiave evento, così come su una chiave giù evento.

RegisterHotKey può essere utilizzato per registrare i tasti di scelta rapida tra thread.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Cenni preliminari sull'Input di tastiera, funzioni di Input di tastiera, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

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

Index