windows_programming_notes.nbk: Home | Index | Next Page: WM_HSCROLL | Previous Page: WM_HELP

 WM_HOTKEY

The WM_HOTKEY message is posted when the user presses a hot key registered by the RegisterHotKey function. The message is placed at the top of the message queue associated with the thread that registered the hot key.

A window receives this message through its WindowProc function.

    LRESULT CALLBACK WindowProc(
      HWND hwnd,       // handle to window
      UINT uMsg,       // WM_HOTKEY
      WPARAM wParam,   // hot key identifier
      LPARAM lParam    // options and virtual-key code
    );

Parameters

• wParam
Specifies the identifier of the hot key that generated the message. If the message was generated by a system-defined hot key, this parameter will be one of the following values. Value Meaning
• IDHOT_SNAPDESKTOP The "snap desktop" hot key was pressed.
• IDHOT_SNAPWINDOW The "snap window" hot key was pressed.
• lParam
The low-order word specifies the keys that were to be pressed in combination with the key specified by the high-order word to generate the WM_HOTKEY message. This word can be one or more of the following values. Value Meaning
• MOD_ALT Either ALT key was held down.
• MOD_CONTROL Either CTRL key was held down.
• MOD_SHIFT Either SHIFT key was held down.
• MOD_WIN Either WINDOWS key was held down. These keys are labeled with the Microsoft Windows logo.

The high-order word specifies the virtual key code of the hot key.

Remarks

WM_HOTKEY is unrelated to the WM_GETHOTKEY and WM_SETHOTKEY hot keys. The WM_HOTKEY message is sent for generic hot keys while the WM_SETHOTKEY and WM_GETHOTKEY messages relate to window activation hot keys.

Requirements

• Windows NT/2000 or later: Requires Windows NT 3.1 or later.
• Windows 95/98/Me: Requires Windows 95 or later.
• Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: WM_HSCROLL | Previous Page: WM_HELP

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time