17.15.2.42 title

This element specifies advisory information about a single frame or frameset. The title information shall be stored in this element’s val attribute. This property is analogous to the title attribute on the frame or frameset element in HTML.

If this element is omitted, then no title shall be associated with the given frame or frameset.

[Example: Consider a WordprocessingML document that serves as the frameset container for a frameset consisting of the following three frames:

The frameset properties for this document are specified by the following WordprocessingML within the web page settings:

<w:frameset>
  <w:title w:val="Our library of documents" />
  <w:frame>
    <w:name w:val="Frame 1" />
    <w:title w:val="Menu bar" />
  </w:frame>
  <w:frameset>
    <w:title w:val="Navigation and document collection" />
    …
    <w:frame>
      <w:name w:val="Frame 2" />
      <w:title w:val="Navigation bar" />
    </w:frame>
    <w:frame>
      <w:name w:val="Frame 3" />
      <w:title w:val="Documents" />
    </w:frame>
  </w:frameset>
</w:frameset>

The title element specifies supplementary information for each frame and frameset. In this case, the frames have titles of “Menu bar”, “Navigation bar”, and “Documents”, respectively, while the framesets have titles of “Our library of documents”, and “Navigation and document collection”, respectively. end example]

Attributes

val (String Value)

Specifies that its contents contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

[Example: Consider the following WordprocessingML fragment:

    <w:pPr>
      <w:pStyle w:val="Heading1" />
    </w:pPr>

The value of the val attribute is the ID of the associated paragraph style’s styleId.

However, consider the following fragment:

    <w:sdtPr>
      <w:alias w:val="SDT Title Example" />
      …
    </w:sdtPr>

In this case, the decimal number in the val attribute is the caption of the nearest ancestor structured document tag. In each case, the value is interpreted in the context of the parent element. end example]

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

[Note: The W3C XML Schema definition of this element’s content model (CT_String) is located in A.1. end note]