Custom Applications Launched from the Title Bar
4/8/2010
Applies to Windows Mobile 6.5.3
When a user taps the title bar, a pull-down list appears with icons that map to the notification or status icons in the title bar. When a user taps an icon in the pull-down list, this launches the existing associated action. For example, tapping the Volume icon in the pull-down list of the title bar launches Volume Settings.
OEMs can override the title bar items listed in the pull-down list. For example, if you replace standard volume settings with a custom volume event, when a user taps the associated icon, the title bar pull-down list will launch the customized volume setting. If you remove customized registry key settings, the default Microsoft application will appear when a user clicks the associated icon.
Not all items on the title bar pull-down list can be replaced with custom applications or events. You can customize task bar button handlers only. You cannot customize shell notifications and shortcut handlers.
Note
Changing the task bar events will not affect the associated title bar icons. For information about title bar icons, see Customizing Title Bar Icons on the Home Screen.
Each of the applications listed in the pull-down list has a corresponding launch path. You can specify each of these paths by using the following values stored in the HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Rai registry key.
The following table shows the keys and named values for each key.
| Registry Key | Type | Description |
|---|---|---|
:TASKBAR_DATACONNECTION |
REG_SZ |
Specifies the Data Connection event in the TitleBarList by setting the following values: "0"="OEM_DataConnection" "1"="\windows\OEMTitleBarHandler.exe /DataConnection" If the value is not set or is empty, the default path will be the current built-in application path. |
:TASKBAR_RADIOSIGNAL |
REG_SZ |
Specifies the Radio Signal event in the TitleBarList by setting the following values: "0"="OEM_RadioSignal" "1"="\windows\OEMTitleBarHandler.exe /RadioSignal" If the value is not set or is empty, the default path will be the current built-in application path. > [!NOTE] > The default radio signal handler launches the phone application if a voice call is connected. The OEM is responsible for customizing an appropriate action when the radio signal is pressed during a voice call. |
:TASKBAR_VOLUME |
REG_SZ |
Specifies the Volume event in the TitleBarList by setting the following values: "0"="OEM_Volume" "1"="\windows\OEMTitleBarHandler.exe /Volume" If the value is not set or is empty, the default path will be the current built-in application path. > [!NOTE] > The Volume command can be executed while the phone is locked. The OEM is responsible for customizing how to display the volume window when the phone is locked. |
:TASKBAR_BATTERY |
REG_SZ |
Specifies the Battery event in the TitleBarList by setting the following values: "0"="OEM_Battery" "1"="\windows\OEMTitleBarHandler.exe /Battery" If the value is not set or empty, the default path will be the current built-in application path. |
:TASKBAR_CLOCK |
REG_SZ |
Specifies the Clock event in the TitleBarList by setting the following values: "0"="OEM_Clock" "1"="\windows\OEMTitleBarHandler.exe /Clock" If the value is not set or is empty, the default path will be the current built-in application path. |
Description
To replace a task bar item, define the HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Rai registry key and specify the values as shown in the following code snippet.
Code example
HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Rai\:TASKBAR_[Registry Key Name]
"0" = "window_class_name"
"1" = "command to execute the OEM handler"
The values can be set to the new path \path\to\new\target.exe plus command parameters.
Note
You must include a 0 and 1 string value in the same registry key setting.