GetKeyState

La funzione GetKeyState recupera lo status della chiave virtuale specificato. Lo status specifica se la chiave è in su, giù, o attivabile/disattivabile (on, off — alternando ogni volta che viene premuto il tasto).

Breve GetKeyState ( int  nVirtKey / / tasto virtuale di codice);
 

Parametri

nVirtKey
Specifica una chiave virtuale. Se la chiave virtuale desiderata è una lettera o una cifra (da A Z, alla z o 0 a 9), nVirtKey deve essere impostato al valore di quel carattere ASCII. Per altri tasti, deve essere un codice tasto virtuale.

Se viene utilizzato un layout di tastiera non in lingua inglese, con valori nell'intervallo da ASCII A Z e 0 e 9 tasti virtuali vengono utilizzati per specificare la maggior parte dei tasti carattere. Ad esempio, per il layout di tastiera tedesca, il tasto virtuale di valore O ASCII (0x4F) riferimento alla chiave "o", mentre VK_OEM_1 fa riferimento alla chiave "o con umlaut".

Valori restituiti

Il valore restituito specifica lo stato della chiave virtuale determinata, come segue:

Osservazioni

Lo status di chiave restituito da cambiamenti questa funzione come un determinato thread legge i messaggi chiavi dalla sua coda di messaggi. Lo stato non riflette il livello di interrupt stato connesso con l'hardware. Utilizzare la funzione GetAsyncKeyState per recuperare le informazioni.

Un'applicazione chiama GetKeyState in risposta a un messaggio di input della tastiera. Questa funzione recupera lo stato della chiave, quando è stato generato il messaggio di input.

Per recuperare le informazioni sullo stato per tutti i tasti virtuali, utilizzare la funzione GetKeyboardState.

Un'applicazione può utilizzare le costanti di codice tasto virtuale, VK_SHIFT, VK_CONTROL e VK_MENU come valori per il parametro nVirtKey . 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 valori per nVirtKey a 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.

Windows CE: La funzione GetKeyState utilizzabile solo per verificare lo stato giù dei seguenti tasti virtuali

VK_CONTROL

VK_SHIFT

VK_MENU

VK_LCONTROL

VK_LSHIFT

VK_LMENU

VK_RCONTROL

VK_RSHIFT

VK_RMENU

GetKeyState può essere utilizzato solo per verificare lo stato stato attivato o disattivato della chiave virtuale VK_CAPITAL.

Descrizione

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

Vedi anche

Cenni preliminari sull'Input di tastiera, funzioni di Input di tastiera, GetAsyncKeyState, GetKeyboardState, MapVirtualKey, SetKeyboardState

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

Index