# Custom Applications Launched from the Title Bar

Windows Mobile 6.5
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

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.

REG_SZ

Specifies the Radio Signal event in the TitleBarList by setting the following values:

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.

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.

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.

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.