GetKeyboardState

La funzione GetKeyboardState viene copiato nel buffer specificato lo status dei 256 tasti virtuali.

(BOOL GetKeyboardState PBYTE  lpKeyState / / puntatore a matrice per ricevere i dati di stato);
 

Parametri

lpKeyState
Puntatore alla matrice 256 byte che riceverà i dati dello stato per ogni tasto virtuale.

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

Un'applicazione può chiamare questa funzione per recuperare lo stato corrente di tutti i tasti virtuali. I cambiamenti di stato come thread rimuove i messaggi di tastiera dalla sua coda messaggi. Lo stato non cambia come coda di messaggi del thread vengono registrati i messaggi di tastiera, né lo cambiamento come inviati a o Estratto da code di messaggi di altri thread dei messaggi della tastiera. (Eccezione: thread che sono collegati tramite AttachThreadInput condividere lo stesso stato tastiera.)

Quando la funzione termina, ogni membro della matrice a cui puntata il parametro lpKeyState contiene dati di stato per una chiave virtuale. Se il bit di ordine superiore è 1, il tasto è premuto; in caso contrario, è su. Se il bit di ordine inferiore è 1, la chiave è attivata o disattivata. Una chiave, come ad esempio i tappi bloccare chiave, viene attivata se è attivata. La chiave è spento e untoggled se il bit di ordine inferiore è 0. Spia luminosa di una chiave di attivazione/disattivazione (se presente) sulla tastiera sarà quando viene attivata la chiave, e fuori quando la chiave è untoggled.

Per recuperare le informazioni sullo stato per una singola chiave, utilizzare la funzione GetKeyState . Per recuperare lo stato corrente per una chiave individuale indipendentemente dal fatto se il messaggio di tastiera corrispondente è stato recuperato dalla coda dei messaggi, utilizzare la funzione GetAsyncKeyState

Un'applicazione può utilizzare le costanti di codice tasto virtuale, VK_SHIFT, VK_CONTROL e VK_MENU come indici di matrice a cui puntata lpKeyState. Questo dà lo status della MAIUSC, ctrl o alt chiavi senza distinguere tra destra e sinistra. Un'applicazione può anche utilizzare le seguenti costanti codice tasto virtuale come indici per distinguere tra le istanze di destra e sinistra di questi tasti.

VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Queste costanti distinguere da sinistra e destra sono disponibili a un'applicazione solo attraverso la GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStatee MapVirtualKey funzioni.

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, GetKeyState, GetAsyncKeyState, MapVirtualKey, SetKeyboardState

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

Index