WM_HOTKEY

  • Article

This 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.

WM_HOTKEY idHotKey = (int) wParam; 
  fuModifiers = (UINT) LOWORD(lParam); 
  uVirtKey = (UINT) HIWORD(lParam);

Parameters

  • idHotKey
    Hot key identifier that generated the message. If the message was generated by a system-defined hot key, the idHotKey parameter is one of the following values.

    Value Description
    IDHOT_SNAPDESKTOP The snap desktop hot key was pressed.
    IDHOT_SNAPWINDOW The snap window hot key was pressed.

  • fuModifiers
    Specifies the keys that were to be pressed in combination with the key specified by the nVirtKey parameter to generate the WM_HOTKEY message. The fuModifiers parameter can be a combination of the following values.

    Value Description
    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.

  • uVirtKey
    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_SET\GETHOTKEY messages relate to window activation hot keys.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Winuser.h.

See Also

RegisterHotKey | Keyboard Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.