WM_SETHOTKEY

Eine Anwendung sendet eine WM_SETHOTKEY-Nachricht an ein Fenster, um das Fenster eine Tastenkombination zuordnen. Wenn der Benutzer die Tastenkombination drückt, aktiviert das System das Fenster.

WM_SETHOTKEY wParam = (WPARAM) MAKEWORD Vkey (Modifizierer) / / virtuelle Tastencodes und Modifizierer des hot Schlüssel lParam = 0;                                   / / nicht benutzt; NULL muss sein

Parameter

vkey

Der wParam-Wert. Gibt die virtuelle Tastencodes und Modifizierer des heißen Schlüssels zugeordnet. Der virtuelle Tastencode ist in das niedrige Byte des Parameters und die Modifiziererflags sind in das high-Byte. Wenn dieser Parameter auf NULL entfernt den hot Key, das einem Fenster zugeordnet. Das Modifizierer Byte kann eine Kombination folgender Flags sein.

Wert	Bedeutung
HOTKEYF_ALT	ALT-Taste
HOTKEYF_CONTROL	STRG-Taste
HOTKEYF_EXT	Erweiterte Schlüssel
HOTKEYF_SHIFT	Shift-Taste

Rückgabewerte

Der Rückgabewert ist eine der folgenden:

Wert	Bedeutung
-1	Die Funktion schlägt fehl, — der hot Key ist ungültig.
..0	Die Funktion schlägt fehl – das Fenster ist ungültig.
..1	Die Funktion erfolgreich ist, und kein anderes Fenster hat den gleichen Hotkey.
..2	Die Funktion erfolgreich ist, aber ein anderes Fenster hat bereits die gleiche Tastenkombination.

Bemerkungen

Eine Abkürzungstaste kann kein untergeordnetes Fenster zugeordnet werden.

VK_ESCAPE, VK_SPACE und VK_TAB sind ungültige hot-keys.

Wenn der Benutzer die Tastenkombination drückt, erzeugt das System eine WM_SYSCOMMAND-Meldung mit wParam auf SC_HOTKEY und lParam das Fensterhandle gleich gleich. Wenn diese Nachricht an DefWindowProcübergeben wird, wird das System bringen, die die letzte aktive Popup-Fenster (falls vorhanden) oder das Fenster selbst (wenn es kein Popupfenster gibt) in den Vordergrund.

Ein Fenster kann nur ein heißen Schlüssel haben. Wenn das Fenster bereits eine Tastenkombination zugeordnet hat, ersetzt der neue Hotkey den alten. Wenn mehr als ein Fenster den gleichen Hotkey hat, ist das Fenster, das durch den Hotkey aktiviert ist zufällig.

Diese Zugriffstasten sind unabhängig von der RegisterHotKey festgelegten Hotkeys.

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.

Siehe auch

Übersicht über die Tastatur-Eingabe, Keyboard Input Nachrichten, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index