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 |