menu element

Article
11/02/2006

Specifies the list of menu items that constitutes a menu page.

Element Information

Element type: xsd:complexType

Namespace: https://schemas.microsoft.com/sideshow/2006/scf

Schema name: Simple Content Format

Elements and Attributes

Parent Elements

body element

Child Elements

btn element

item element

div element

Attributes

Attribute	Type	Required	Description	Possible values
id	xsd:positiveInteger	Required	The content identifier of the current page.	The actual content identifier of the current page.
title	xsd:string	Optional	The title to be displayed in the title bar or at the top of the page.	Any valid string. If not specified, the gadget name is used.
selectaction	SelectAction simple type	Optional	Defines whether selection of an item in the menu navigates to the item's specified target page, or whether it invokes the item's specified context menu. If "menuid" is specified and the item has no menuid attribute, the device will navigate to the item's specified target instead.	target: selection causes navigation to the page specified by the item's target attribute menuid: selection causes the context menu specified by the item's menuid attribute to be invoked

Remarks

The menu element uses the MenuChild group element to specify an unbounded sequence of child elements consisting of any combination of the following child elements:

item element
div element
btn element
When specifying a btn element as a child of a menu element, the only allowable values for the btn element's key attribute are left and right.

Usage Example

The following code example displays a menu on the screen of a device.

<body>
    <menu id="300" title="Today’s Appointments">
        <item target="11" imgid="1" menuid="50">10:00a-11:00a Design Meeting</item>
        <div/>
        <item target="12" imgid="1" menuid="50">11:30a-1:00p  Team Lunch</item>        <item target="13" imgid="1" menuid="50">3:00p-4:00p   Pick up kids</item>
    </menu>
</body>

Schema Definition

The following schema defines a menu page.

<xsd:simpleType name="SelectAction">
    <xsd:restriction base="xsd:string">
        <xsd:pattern value="target|menuid" />
    </xsd:restriction>
</xsd:simpleType>

<xsd:element name="menu">
    <xsd:complexType>
        <xsd:group ref="MenuChild" maxOccurs="unbounded" />
        <xsd:attribute name="id" type="xsd:positiveInteger" use="required" />
        <xsd:attribute name="title" type="xsd:string" use="optional" />
        <xsd:attribute name="selectaction" type="SelectAction" use="optional" />
    </xsd:complexType>
</xsd:element>

<xsd:group name="MenuChild">
    <xsd:choice>
        <xsd:element ref="item" minOccurs="1" />
        <xsd:element ref="div" />
        <xsd:element ref="btn" />
    </xsd:choice>
</xsd:group>

Partager via