MapVirtualKeyEx

La funzione MapVirtualKeyEx converte (mappe) un tasto virtuale di codice in un valore di codice o carattere di scansione, o si traduce un codice di scansione in un codice tasto virtuale. La funzione si traduce i codici utilizzando la lingua di input e il layout di tastiera fisica identificata dall'handle layout di tastiera dato.

 (UINT MapVirtualKeyEx UINT  uCode, / / tasto virtuale codice codice o scansioneUINTuMapType, / / traduzione per eseguireHKLdwhkl / / handle layout di tastiera);
 

Parametri

uCode

Specifica il codice tasto virtuale di codice o di scansione per una chiave. Come questo valore viene interpretato dipende dal valore del parametro uMapType.

uMapType

Specifica la traduzione di eseguire. Il valore di questo parametro dipende dal valore del parametro uCode:

Valore	Significato
0	uCode è un codice tasto virtuale ed è tradotto in un codice di scansione. Se si tratta di un codice tasto virtuale che non fa distinzione tra mano sinistra e destra tasti, viene restituito il codice di scansione sinistro. Se non vi è alcuna traduzione, la funzione restituisce 0.
1	uCode è un codice di scansione ed è tradotto in un codice tasto virtuale che non fa distinzione tra sinistra - e right - hand tasti. Se non vi è alcuna traduzione, la funzione restituisce 0.
2	uCode è un codice tasto virtuale ed è tradotto in un valore di caratteri che nella parola ordine ridotto del valore restituito. Tasti morti (segni diacritici) sono indicate impostando il bit superiore del valore restituito. Se non vi è alcuna traduzione, la funzione restituisce 0.
3	uCode è un codice di scansione ed è tradotto in un codice tasto virtuale che distingue tra sinistra - e right - hand tasti. Se non vi è alcuna traduzione, la funzione restituisce 0.

dwhkl

Handle per il layout di tastiera da utilizzare per tradurre il codice dato. Questo parametro può essere qualsiasi handle del layout di tastiera precedentemente restituito dalla funzione LoadKeyboardLayout.

Valori restituiti

Il valore restituito è un codice di scansione, un codice tasto virtuale o un valore di carattere, a seconda del valore di uCode e uMapType. Se non vi è alcuna traduzione, il valore restituito è zero.

Osservazioni

Un'applicazione può utilizzare MapVirtualKeyEx per tradurre i codici di scansione per le costanti di codice tasto virtuale, VK_SHIFT, VK_CONTROL e VK_MENU e viceversa. Queste traduzioni non fanno distinzione tra le istanze di sinistra e destra della MAIUSC, ctrl o alt tasti. Un'applicazione può ottenere il codice di analisi corrispondente all'istanza di uno di questi tasti destro o sinistro chiamando MapVirtualKeyEx con uCode impostato su una delle seguenti costanti codice tasto virtuale.

Queste costanti distinguere da sinistra e destra sono disponibili per un'applicazione solo attraverso la GetKeyboardState, SetKeyboardState, GetAsyncKeyState, GetKeyState, MapVirtualKeye MapVirtualKeyEx le funzioni. Per la tabella completa lista dei codici dei tasti virtuali, vedere Virtual-Key Codes.

Descrizione

nbsp; Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

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

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

Index