Dynamic Assignment of SK1
You can set the left soft key (SK1) to change depending on when a most recent event (MRE) occurs. The change includes a reset of the text associated with the softkey, and also execution of a Shell command when the softkey is hit. The programming elements that are used to set SK1 to reflect a change in event are the MREINFO structure and MRESetSoftkeyEvent function.
 Note: |
|---|
| Beginning with Windows Mobile 6.5.3, soft keys are replaced by touchable tiles on Windows Mobile Professional phones. |
These APIs are defined in the <Adaptation Kit>\Public\Ossvcs\Oak\Inc\Mre.h file.
struct MREINFO {
UINT cbSize;
DWORD dwFlags;
int iPriority;
DWORD tDontOverwrite; // Do not overwrite this event until
// (GetTickCount() >= tDontOverwrite).
// Ignored if 0.
TCHAR* pszLabel;
SHELLEXECUTEINFO* psei;
};
HRESULT MRESetSoftkeyEvent(
const MREINFO* pmi
);
The status data identifiers (SDIDs) SDID_MRE and SDID_ACTIVE_CALLCOUNT events from statstor are monitored by the Shell. All SDIDs are defined in the <Adaptation Kit>\Public\Ossvcs\Oak\Inc\Sdids.h file. The Shell changes SK1 according to the MREINFO structure. As with Windows Mobile Standard, SDID_ACTIVE_CALLCOUNT takes precedence over SDID_MRE.
OEMs should modify the information associated with SDID_MRE in statstor if they want to customize it. If the SDID_MRE event occurs, but the data associated with it is malformed, the default SK1 assignment will be used.