Freigeben über

VkKeyScanA-Funktion (winuser.h)

  • Artikel

[Diese Funktion wurde durch die funktion VkKeyScanEx ersetzt. Sie können weiterhin VkKeyScan-verwenden, wenn Sie jedoch kein Tastaturlayout angeben müssen.]

Übersetzt ein Zeichen in den entsprechenden Code für virtuelle Tasten und den Schichtzustand für die aktuelle Tastatur.

Syntax

SHORT VkKeyScanA(
  [in] CHAR ch
);

Parameter

[in] ch

Typ: TCHAR-

Das Zeichen, das in einen virtuellen Schlüsselcode übersetzt werden soll.

Rückgabewert

Typ: SHORT

Wenn die Funktion erfolgreich ist, enthält das Byte mit niedriger Reihenfolge des Rückgabewerts den Code für virtuelle Schlüssel und das Byte mit hoher Reihenfolge den Schichtzustand, der eine Kombination der folgenden Flagbits sein kann.

Rückgabewert Beschreibung
1
 Beide UMSCHALTTASTEn werden gedrückt.
2
 Die STRG-TASTE wird gedrückt.
4
 Beide ALT-Taste wird gedrückt.
8
 Die Hankaku-Taste wird gedrückt.
16
 Reserviert (definiert durch den Tastaturlayouttreiber).
32
 Reserviert (definiert durch den Tastaturlayouttreiber).
 

Wenn die Funktion keinen Schlüssel findet, der in den übergebenen Zeichencode übersetzt wird, enthalten sowohl die Byte mit niedriger Reihenfolge als auch die Hochreihenfolge -1.

Bemerkungen

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 Zehnertastatur (VK_NUMPAD0 bis VK_DIVIDE) werden ignoriert. Diese Funktion dient nur zum Übersetzen von Zeichen in Tastaturanschläge aus dem Haupttastaturenabschnitt. Beispielsweise wird das Zeichen "7" in VK_7 übersetzt, nicht in VK_NUMPAD7.

VkKeyScan- wird von Anwendungen verwendet, die Zeichen mithilfe der WM_KEYUP und WM_KEYDOWN Nachrichten senden.

Anmerkung

Der winuser.h-Header definiert VkKeyScan 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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Zielplattform- Fenster
Header- winuser.h (enthalten Windows.h)
Library User32.lib
DLL- User32.dll

Siehe auch