XML Formatting for Standard Home Screen Layouts

Home Screen layout and functionality are specified in a Home Screen XML file (filename.home.xml).

The file that defines the plug-ins that are displayed on the screen, specifies their default formatting, and sets the watermark and branding for the Home screen. A Home Screen XML file begins with the tag and ends with the tag.

Home Screen layouts are written by using an XML-based document format and are stored in individual files with a .home.xml file extension. Only a few basic elements, in addition to a common set of attributes, are described. Plug-in authors can support additional free-form XML content within the plug-in element as needed. All element and attribute names are case-sensitive.

To insert plug-ins into the layout, define a Plugin element in the tag block for each plug-in. The following elements are required for a Plugin element:

Element	Description
Author	Name of the company that created the layout.
ContactUrl	Uniform Resource Locator (URL) for more information about the layout.
Title	Title of the layout. Used in the Home Screen Settings control panel where users select the layout to use. The Lang attribute identifies the language of the tag's content.
Version	Version identification for the scheme. The author of the layout determines the format.

In addition to the required elements, the following optional elements are used to define the actual layout of the screen and its content:

Element	Description
Plugin	Inserts a plug-in into the layout. The clsid value is a unique identifier of the plug-in.
Background	Formats the background of a plug-in or the Home screen.
Format	Controls the formatting of text in a plug-in.
Default	Specifies the default background and formatting attributes for all plug-ins in the layout.

Elements that accept file location attributes, such as the Plugin element and the file locations or background images used as watermarks, use standard Windows-style file references, for example: \windows\bimage.bmp.

The following XML code is an example for a simple Home Screen file. It includes two basic plug-ins: the Carrier/SIM plug-in and the Icon Bar plug-in.

	Copy Code
Example 1.0 源自MSDN