Teilen über

WM_SETHOTKEY Nachricht

  • Artikel

Wird an ein Fenster gesendet, um dem Fenster einen Hot Key zuzuordnen. Wenn der Benutzer die Tastenkombination drückt, aktiviert das System das Fenster.

#define WM_SETHOTKEY                    0x0032

Parameter

wParam

Das Wort mit niedriger Ordnung gibt den virtuellen Schlüsselcode an, der dem Fenster zugeordnet werden soll.

Das Wort mit hoher Ordnung kann mindestens einer der folgenden Werte aus CommCtrl.h sein.

Wenn Sie wParam auf NULL festlegen, wird der Hot Key entfernt, der einem Fenster zugeordnet ist.

Wert Bedeutung
HOTKEYF_ALT
0x04
 ALT-TASTE
HOTKEYF_CONTROL
0x02
 STRG-TASTE
HOTKEYF_EXT
0x08
 Erweiterter Schlüssel
HOTKEYF_SHIFT
0x01
 Umschalttaste

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Der Rückgabewert ist einer der folgenden:

Rückgabewert BESCHREIBUNG
-1
 Die Funktion ist nicht erfolgreich. Der Schlüssel ist ungültig.
0
 Die Funktion ist nicht erfolgreich. das Fenster ist ungültig.
1
 Die Funktion ist erfolgreich, und kein anderes Fenster verfügt über die gleiche Tastenkombination.
2
 Die Funktion ist erfolgreich, aber ein anderes Fenster verfügt bereits über die gleiche Tastenkombination.

Bemerkungen

Einem untergeordneten Fenster kann kein Schlüssel zugeordnet werden.

VK_ESCAPE, VK_SPACE und VK_TAB sind ungültige Hot keys.

Wenn der Benutzer die Tastenkombination drückt, generiert das System eine WM_SYSCOMMAND Nachricht mit wParam gleich SC_HOTKEY und lParam gleich dem Handle des Fensters. Wenn diese Meldung an DefWindowProc übergeben wird, bringt das System das letzte aktive Popup des Fensters (sofern vorhanden) oder das Fenster selbst (wenn kein Popupfenster vorhanden ist) in den Vordergrund.

Ein Fenster kann nur einen Hot Key haben. Wenn dem Fenster bereits ein Hot Key zugeordnet ist, ersetzt der neue Hot key den alten Schlüssel. Wenn mehrere Fenster über denselben Hot key verfügen, ist das Fenster, das von der Hot key aktiviert wird, zufällig.

Diese Tastenkombinationen hängen nicht mit den von RegisterHotKey festgelegten Hot keys zusammen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]
Header
Winuser.h (windows.h einschließen)

Siehe auch

Referenz

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Konzept

Tastatureingabe