SHCMBM_OVERRIDEKEY

Article
08/28/2006

The SHCMBM_OVERRIDEKEY message is sent by a window to its soft key bar to modify the default handling of key messages sent to the soft key bar or to be notified of these messages. The notifications are sent as WM_HOTKEY messages to the window.

Syntax

SHCMBM_OVERRIDEKEY
  wParam = (WPARAM) nKey;
  lParam = (LPARAM) (DWORD) LOWORD dwMask;
  lParam = (LPARAM) (DWORD) HIWORD dwBits;

Parameters

nKey
Specifies the key whose default handling is to be overridden.
dwMask
Value ** that specifies which styles in dwBits are to be affected. This parameter can be a combination of the dwBits values.
dwBits
Specifies the type of override.

Return Values

The previous value of the key override bits.

Remarks

The following table lists possible nKey parameter values for each device.

Device	Key
Windows Mobile-based Smartphone	VK_TSOFT1, VK_TSOFT2, VK_TBACK, VK_TVOLUMEUP, VK_TVOLUMEDOWN, VK_TTALK and VK_TRECORD
Windows Mobile-based Pocket PC	VK_TTALK

The following table lists the possible the dwBits parameter values.

Value	Description
SHMBOF_NODEFAULT	Do not perform default handling of this key.
SHMBOF_NOTIFY	Send this key as a WM_HOTKEY message to the soft key bar owner window.

Requirements

Smartphone: Windows Mobile 2003 and later.
OS Versions: Windows CE 3.0 and later.
Header: Aygshell.h.
Library: Aygshell.lib.

Share via