GetAsyncKeyState

La funzione GetAsyncKeyState determina se una chiave è verso l'alto o verso il basso al momento che viene chiamata la funzione e se è stato premuto il tasto dopo una precedente chiamata a GetAsyncKeyState.

Breve GetAsyncKeyState ( int  vKey / / tasto virtuale di codice);
 

Parametri

vKey
Specifica uno dei 256 possibili codici di tasti virtuali. Per ulteriori informazioni, vedere Virtual-Key Codes.

Windows NT: È possibile utilizzare costanti distinguere a sinistra e a destra per specificare alcuni tasti. Vedere la sezione Osservazioni per maggiori informazioni.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito specifica se il tasto è stato premuto dall'ultima chiamata a GetAsyncKeyState, e se la chiave è attualmente su o giù. Se è impostato il bit più significativo, il tasto è premuto, e se è impostato il bit meno significativo, dopo la precedente chiamata a GetAsyncKeyStateè stato premuto il tasto. Il valore restituito è zero se una finestra in un altro processo o thread attualmente ha il focus della tastiera.

Windows 95: Windows 95 non supporta le costanti di distinguere a sinistra e a destra. Se si chiama GetAsyncKeyState con queste costanti, il valore restituito è pari a zero.

Osservazioni

La funzione GetAsyncKeyState funziona con i pulsanti del mouse. Tuttavia, esso controlla sullo stato dei pulsanti del mouse fisico, non sui pulsanti del mouse logico che i pulsanti fisici vengono mappati a. Ad esempio, la chiamata GetAsyncKeyState(VK_LBUTTON) restituisce sempre lo stato del pulsante sinistro del mouse fisica, indipendentemente dal fatto se esso viene mappato al pulsante del mouse di sinistra o destra logico. Si può determinare la mappatura corrente del sistema dei pulsanti del mouse fisica a pulsanti del mouse logico chiamando

GetSystemMetrics(SM_SWAPBUTTON) 
 

che restituisce TRUE se i pulsanti del mouse sono stati scambiati.

È possibile utilizzare le costanti di codice tasto virtuale, VK_SHIFT, VK_CONTROL e VK_MENU come valori per il parametro vKey . In questo modo lo stato della MAIUSC, ctrl o alt chiavi senza distinguere tra destra e sinistra.

Windows NT: È possibile utilizzare le seguenti costanti codice tasto virtuale come valori per vKey per distinguere tra le istanze di destra e sinistra di questi tasti.

Codice Significato
VK_LSHIFT VK_RSHIFT
VK_LCONTROL VK_RCONTROL
VK_LMENU VK_RMENU

Queste costanti distinguere da sinistra e destra sono disponibili solo quando si chiama il GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyStatee MapVirtualKey funzioni.

Windows CE: La funzione GetAsyncKeyState supporta le costanti di chiave virtuale di destra e di sinistra, così è possibile determinare se è stato premuto il tasto sinistro o il tasto destro. Queste costanti sono VK_LCONTROL, VK_RCONTROL, VK_LMENU, VK_RMENU, VK_LSHIFT e VK_RSHIFT.

Il bit meno significativo del valore restituito non è valido in Windows CE e deve essere ignorato.

GetAsyncKeyState restituirà lo stato corrente di chiave, anche se una finestra in un altro processo o thread attualmente ha il focus della tastiera.

È anche possibile utilizzare la costante VK_LBUTTON codice tasto virtuale per determinare lo stato della punta dello stilo, (su/giù), sul touch-screen.

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 da tastiera, GetKeyboardState, GetKeyState, GetSystemMetrics, MapVirtualKey, SetKeyboardState

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

Index