Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

OEMs may sometimes need to change the colors of the title bar and soft key independent of the base color in an active theme file. However, the theme does not allow the specification of a base color for title bar and soft keys that is different from COLOR_STARTICONBACKGROUND.

Beginning with Windows Mobile 6.5.3, soft keys are replaced by touchable tiles on Windows Mobile Professional phones.

In such cases, the registry key HKEY_CURRENT_USER\Software\Microsoft\Today\<ThemeFileName>is used to change the title bar and soft key colors independent of the base color. <ThemeFileName>is the name of the theme file that corresponds to the color scheme where the title bar and soft key colors need to be changed. If there is no theme file installed, specify the string "Default" for <ThemeFileName>.

The following table shows the named values for the registry key HKEY_CURRENT_USER\Software\Microsoft\Today\<ThemeFileName>. The color value used as the new base value for title bar and soft keys is set by COLOR_COMMANDBAR. You must specify this value in order to override the title bar and soft key color.

Note:
To set the color values in the following table, you must first swap the Red and Blue colors in the hexadecimal representation of the color, and then convert it to a decimal value. The decimal value should then be assigned to the appropriate named value in the HKEY_CURRENT_USER\Software\Microsoft\Today\<ThemeFileName>registry key. For example, if you have a color represented by 0xAC23DF, then you should first swap the Red and Blue values to get 0xDF23AC, and then convert it to decimal which is 14623660.

All the colors in the following table are specified as a COLORREFstructure.

Name Type Description

COLOR_BTNFACE

REG_DWORD

Sets the color for various banners and headers throughout the device. This should be set to a color that contrasts well with COLOR_BTNTEXT.

COLOR_BTNTEXT

REG_DWORD

Sets the color for all highlights used throughout the device. This should be set to a color that contrasts well with COLOR_BTNFACE but is also not a light or white color.

COLOR_CAPTIONFLAT

REG_DWORD

Sets the color of the caption of message boxes. The message box caption will be drawn flat and not as a gradient.

This value should be set to the decimal value of the color.

COLOR_COMMANDBAR

REG_DWORD

Sets the color for the soft keys or the lower bar. This value also determines the color of the title bar throughout the device.

COLOR_COMMANDBARTEXT

REG_DWORD

Sets the color for the text used on the command bar. This should be set to a color that contrasts well against the color set in COLOR_COMMANDBAR. This value also determines the color of the text on the title bar.

COLOR_COMMANDBARTEXT_HIGHLIGHT

REG_DWORD

Sets the color for the highlighted text used on the command bar only. This should be set to a color that contrasts well against the color set in COLOR_COMMANDBAR. This value also determines the color of the highlighted text on the title bar.

COLOR_COMMANDBARSIP_HIGHLIGHT

REG_DWORD

Set the background color for the SIP icon button on the command bar (not on soft keys). This color should match well with COLOR_COMMANDBAR.

COLOR_HIGHLIGHT

REG_DWORD

Sets the color for all highlights used throughout the device. This should be set to a color that works well against a white background and against the color setting for COLOR_BTNFACE.

COLOR_HIGHLIGHTTEXT

REG_DWORD

Sets the color for all highlighted text throughout the device. This should be set to a color that works well against the color set in COLOR_HIGHLIGHT.

COLOR_SOFTKEYFLATCENTER

REG_DWORD

Sets the color for the center gradient of the soft key. The center gradient will be drawn flat and not as a gradient. This color should match well with COLOR_TRAYGRADLEFT or COLOR_COMMANDBAR if used, which will be used as the base color for the bottom and top gradients of the soft keys.

This value should be set to the decimal value of the color.

COLOR_TITLEDONEXBTNTEXT

REG_DWORD

Sets the color for the foreground in normal state of the OKand Xbuttons.

COLOR_TITLEDONEXBTNTEXT_HIGHLIGHT

REG_DWORD

Sets the color for the foreground in selected state of OKand Xbuttons.

COLOR_TITLEFLATCENTER

REG_DWORD

Sets the color for the center gradient of the title bar. The center gradient will be drawn flat and not as a gradient. This color should match well with COLOR_TRAYGRADLEFT or COLOR_COMMANDBAR, if used, which will be used as the base color for the bottom and top gradients of the title bar.

This value should be set to the decimal value of the color.

COLOR_TITLEFLATDONEBTN

REG_DWORD

Sets the background color of the Donebutton. The Donebutton will be drawn flat and not as a gradient. This color should match well with COLOR_TITLEFLATCENTER.

This value should be set to the decimal value of the color.

COLOR_TITLEFLATDONEBTN_HIGHLIGHT

REG_DWORD

Sets the background color of the Donebutton when it is pressed. The Donebutton will be drawn flat when pressed and not as a gradient. This color should match well with COLOR_TITLEFLATCENTER.

This value should be set to the decimal value of the color.

UseDefaultTitleColor

REG_DWORD

Sets the default color for the title bar.

If this value is set to 1, then COLOR_TRAYGRADLEFT is used for title bar and COLOR_SOFTKEYBTNFACE is used for soft key menu bar.

If this value is set to 0, then COLOR_SOFTKEYBTNFACE is used for both title bar and soft key menu bar.

See Also