SHCMBM_OVERRIDEKEY

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

See Also

WM_HOTKEY

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.