RegisterHotKey

Die RegisterHotKey -Funktion definiert eine systemweite Tastenkürzel.

BOOL RegisterHotKey) HWND  hWnd, / / Fenster Hotkey-Benachrichtigungint id, / / Bezeichner des hot-KeyUINTfsModifiers, / / Schlüssel-Modifizierer kennzeichnetUINTVK / / virtual-Key Code);
 

Parameter

hWnd

Handle für das Fenster, das WM_HOTKEY Nachrichten generiert von den hot Key erhalten. Wenn dieser Parameter NULL ist, WM_HOTKEY Nachrichten an die Nachrichtenwarteschlange des aufrufenden Threads geschrieben sind und in der Nachrichtenschleife verarbeitet werden müssen.

id

Gibt den Bezeichner des heißen Schlüssels. Kein andere Tastenkürzel im aufrufenden Thread sollte den gleichen Bezeichner haben. Eine Anwendung muss einen Wert im Bereich von 0 x 0000 durch 0xBFFF angeben. Eine freigegebene Dynamic Link Library (DLL) müssen Sie einen Wert im Bereich von 0xC000 bis 0xFFFF (Bereich zurückgegeben von der GlobalAddAtom Funktion). Um Konflikte mit Hotkey-Bezeichner definiert durch andere gemeinsam genutzte DLLs zu vermeiden, sollten eine DLL die GlobalAddAtom -Funktion verwenden, um die hot-Key-ID zu erhalten.

fsModifiers

Gibt Schlüssel, die gedrückt werden müssen in Kombination mit dem Schlüssel durch den nVirtKey -Parameter angegeben, um die WM_HOTKEY-Nachricht generieren. Der FsModifiers -Parameter kann eine Kombination der folgenden Werte sein.

Wert	Bedeutung
MOD_ALT	Entweder Alt-Taste muss gedrückt gehalten werden.
MOD_CONTROL	Entweder STRG-Taste muss gedrückt gehalten werden.
MOD_SHIFT	Entweder UMSCHALT-Taste muss gedrückt gehalten werden.
MOD_WIN	Entweder WINDOWS-Taste gedrückt wurde. Diese Tasten sind mit dem Microsoft Windows-Logo gekennzeichnet.

vk

Den virtuelle Tastencode des heißen Schlüssels gibt.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich NULL.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn eine Taste gedrückt wird, sucht das System nach einem Spiel gegen alle Hotkeys. Bei der Suche nach eine Übereinstimmung, Bucht das System die WM_HOTKEY-Nachricht an die Nachrichtenwarteschlange des Threads, die den hot Key registriert. Diese Nachricht wird an den Anfang der Warteschlange gebucht, so dass sie mit der nächsten Iteration der Nachrichtenschleife entfernt wird.

Diese Funktion kann nicht mit einem Fenster von einem anderen Thread erstellt eine Abkürzungstaste zuordnen.

RegisterHotKey schlägt fehl, wenn die Tastatureingaben für den hot Key angegeben durch einen anderen Hotkey bereits registriert worden sind.

Wenn das Fenster bereits von der hWnd -Parameter identifiziert eine Abkürzungstaste mit demselben Bezeichner wie durch den Id -Parameter angegeben registriert, ersetzen die neuen Werte für die Parameter FsModifiers und Vk die zuvor angegebenen Werte für diese Parameter.

Windows CE: Windows CE-Versionen 2.0 und höher unterstützen eine zusätzliche Eigenschaft, genannt MOD_KEYUP, für den FsModifiers -Parameter. Wenn Sie das MOD_KEYUP-Flag festgelegt, wird das Fenster eine WM_HOTKEY-Nachricht auf einem Schlüssel-Ereignis als auch auf ein KeyDown-Ereignis gesendet werden.

RegisterHotKey kann verwendet werden, um hot-Keys threadübergreifend registrieren.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Tastatur-Eingabe, Keyboard Input Funktionen, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index