Freigeben über


WM_SETHOTKEY Nachricht

Wird an ein Fenster gesendet, um dem Fenster eine Abkürzungstaste zuzuordnen. Wenn der Benutzer die Hot-Taste drückt, aktiviert das System das Fenster.

#define WM_SETHOTKEY                    0x0032

Die Parameter

wParam-

Das niedrige Byte des Worts mit niedriger Reihenfolge gibt den virtuellen Schlüsselcode an, der dem Fenster zugeordnet werden soll.

Bei dem hohen Byte des Worts mit niedriger Reihenfolge kann es sich um einen oder mehrere der folgenden Werte von CommCtrl.h handeln.

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

Das Hochreihenfolgenwort von wParam wird ignoriert.

Wenn Sie wParam auf NULL festlegen, wird der mit einem Fenster verknüpfte Hot Key entfernt.

lParam-

Dieser Parameter wird nicht verwendet.

Rückgabewert

Der Rückgabewert ist einer der folgenden.

Rückgabewert BESCHREIBUNG
–1
Die Funktion ist nicht erfolgreich; Die Abkürzungstaste ist ungültig.
0
Die Funktion ist nicht erfolgreich; das Fenster ist ungültig.
1
Die Funktion ist erfolgreich, und kein anderes Fenster hat die gleiche Abkürzungstaste.
2
Die Funktion ist erfolgreich, aber ein anderes Fenster verfügt bereits über die gleiche Abkürzungstaste.

Bemerkungen

Eine Abkürzungstaste kann keinem untergeordneten Fenster zugeordnet werden.

VK_ESCAPE, VK_SPACE, VK_TAB und VK_PACKET sind ungültige Tasten.

Wenn der Benutzer die Abkürzungstaste 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 Popupfenster des Fensters (sofern vorhanden) oder das Fenster selbst (wenn kein Popupfenster vorhanden ist) in den Vordergrund.

Ein Fenster kann nur eine Abkürzungstaste haben. Wenn dem Fenster bereits eine Abkürzungstaste zugeordnet ist, ersetzt die neue Hot-Key die alte Taste. Wenn mehr als ein Fenster über dieselbe Abkürzungstaste verfügt, ist das durch die Abkürzungstaste aktivierte Fenster zufällig.

Diese Hot keys sind nicht mit den von RegisterHotKey festgelegten Hot Keys verknüpft.

Anforderungen

Anforderung Wert
Mindest unterstützter Client
Windows 2000 Professional [nur Desktop-Apps]
Unterstützter Mindestserver
Windows 2000 Server [nur Desktop-Apps]
Kopfzeile
Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

RegisterHotKey-

WM_GETHOTKEY

WM_SYSCOMMAND

Konzeptionelle

Tastatureingabe