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.
See Also
WM_HOTKEY
Send Feedback on this topic to the authors
Feedback FAQs
© 2006 Microsoft Corporation. All rights reserved.