VkKeyScanExA-Funktion (winuser.h)
Übersetzt ein Zeichen in den entsprechenden virtuellen Tastencode und den Umschaltzustand. Die Funktion übersetzt das Zeichen mithilfe der Eingabesprache und des physischen Tastaturlayouts, das durch den Eingabe-Gebietsschemabezeichner identifiziert wird.
Syntax
SHORT VkKeyScanExA(
[in] CHAR ch,
[in] HKL dwhkl
);
Parameter
[in] ch
Typ: TCHAR
Das Zeichen, das in einen Virtuellen Schlüsselcode übersetzt werden soll.
[in] dwhkl
Typ: HKL
Eingabegebietsschemabezeichner, der zum Übersetzen des Zeichens verwendet wird. Dieser Parameter kann ein beliebiger Eingabegebietsbezeichner sein, der zuvor von der LoadKeyboardLayout-Funktion zurückgegeben wurde.
Rückgabewert
Typ: SHORT
Wenn die Funktion erfolgreich ist, enthält das Byte mit niedriger Reihenfolge des Rückgabewerts den Code des virtuellen Schlüssels und das Byte mit hoher Ordnung den Umschaltzustand, der eine Kombination aus den folgenden Flagbits sein kann.
Rückgabewert | BESCHREIBUNG |
---|---|
|
Beide UMSCHALTTASTEn werden gedrückt. |
|
Die STRG-TASTE wird gedrückt. |
|
Die ALT-Taste wird gedrückt. |
|
Die Hankaku-Taste wird gedrückt. |
|
Reserviert (definiert durch den Tastaturlayouttreiber). |
|
Reserviert (definiert durch den Tastaturlayouttreiber). |
Wenn die Funktion keinen Schlüssel findet, der in den übergebenen Zeichencode übersetzt wird, enthalten sowohl die Bytes mit niedriger Reihenfolge als auch die hochgeordneten Bytes –1.
Hinweise
Der Eingabegebietsschemabezeichner ist ein umfassenderes Konzept als ein Tastaturlayout, da es auch einen Spracherkennungskonverter, eine Eingabemethode Editor (IME) oder eine andere Form der Eingabe umfassen kann.
Bei Tastaturlayouts, die die rechte ALT-Taste als Umschalttaste verwenden (z. B. das französische Tastaturlayout), wird der Umschaltzustand durch den Wert 6 dargestellt, da die rechte ALT-Taste intern in STRG+ALT konvertiert wird.
Übersetzungen für die numerische Tastatur (VK_NUMPAD0 bis VK_DIVIDE) werden ignoriert. Diese Funktion ist nur zum Übersetzen von Zeichen in Tastenanschläge aus dem Standard Tastaturabschnitts vorgesehen. Beispielsweise wird das Zeichen "7" in VK_7 und nicht in VK_NUMPAD7 übersetzt.
VkKeyScanEx wird von Anwendungen verwendet, die Zeichen mithilfe der WM_KEYUP und WM_KEYDOWN Nachrichten senden.
Hinweis
Der winuser.h-Header definiert VkKeyScanEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winuser.h (einschließlich Windows.h) |
Bibliothek | User32.lib |
DLL | User32.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für