Share via


WM_HOTKEY

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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.

Syntax

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_KEYUP

    Both key up events and key down events generate a WM_HOTKEY message

    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

Header winuser.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

RegisterHotKey
Keyboard Messages