Share via


SHCMBM_OVERRIDEKEY

4/8/2010

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.

Note

Beginning with Windows Mobile 6.5.3, soft keys are replaced by touchable tiles on Windows Mobile Professional phones.

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
    Valuethat 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 Value

The previous value of the key override bits.

Remarks

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

Device Key

Windows Mobile Standard

VK_TSOFT1, VK_TSOFT2, VK_TBACK, VK_TVOLUMEUP, VK_TVOLUMEDOWN, VK_TTALK and VK_TRECORD

Windows Mobile Professional and Windows Mobile Classic

VK_TSOFT1, VK_TSOFT2, 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

Header aygshell.h
Library aygshell.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Smartphone for Windows Mobile 2003 and later

See Also

Reference

WM_HOTKEY