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

See Also

Reference

RegisterHotKey
Keyboard Messages