DocumentID: ECMA-376/Part4/2.15.2 Title: ECMA-376, Part4: 2.15.2 Web Page Settings Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006 Warning: Coverted to HTML format by a script known to have bugs
The next group of settings stored in WordprocessingML is web page settings. These settings specify two categories of settings:
[Example: Consider the following WordprocessingML fragment for the web page settings in a WordprocessingML document:
<w:webSettings>
<w:frameset>
...
</w:frameset>
<w:doNotUseLongFileNames w:val="true" />
</w:webSettings>
The webSettings element contains all of the web page settings for this document. In this case, the web page settings specified for this document are: a frameset defined using the frameset element (§2.15.2.18); and a setting specifying that when this file is saved as a web page, all resulting files shall not exceed 8.3 characters in length using the doNotUseLongFileNames element (§2.15.2.13). end example]
This element specifies that applications shall allow use of the PNG file format when the contents of this WordprocessingML document are saved as a web page. This includes all supporting images used as part of this HTML web page.
If this element is omitted from the document, then the PNG file format shall not be allowed when this document is saved as a web page, and that another suitable file format (such as the JPEG file format) should be utilized in its place.
[Note: This setting is intended for applications to save web pages which can be supported by legacy web browsers which do not support the reading of PNG images. However, although PNG utilizes a lossless compression algorithm, JPEG uses 'lossy' compression and may in some cases result in lower fidelity images. end note]
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:allowPNG w:val="true" />
</w:webSettings>
The allowPNG element has a val attribute value of true, which specifies that applications may use the PNG graphic format as needed when saving this WordprocessingML document as a web page. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that the current div element does not represent an HTML div element, but rather represents an HTML blockquote element. This element shall specify that this container shall be written out using the blockquote element if this document is subsequently saved as HTML.
If this element is omitted, then the current div element does not represent an HTML blockquote element. If both this element and the bodyDiv element (§2.15.2.3) are specified, then this element shall take precedence in all cases.
[Example: Consider a simple HTML document defined as follows:
<html>
<body style="margin-left:200px;margin-top:50px">
<p>Paragraph one.</p>
<blockquote style="border: 5px solid #00FFFF">
<p>Paragraph in a blockquote.</p>
</blockquote>
<p>Paragraph two.</p>
</body>
</html>
When this document is saved in the WordprocessingML format, the information stored on the div, blockquote, and body elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1626542603">
...
<w:divsChild>
<w:div w:id="313534916">
<w:blockQuote w:val="true" />
...
</w:div>
</w:divsChild>
</w:div>
</w:divs>
The blockQuote element has a val attribute value of true, which specifies that the nested div element actually represents a nested HTML blockquote when this document is resaved as HTML. end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that the current div element does not represent an HTML div element, but rather represents formatting properties on the HTML body element. This element shall specify that the properties specified by this container shall be written out onto the body element if this document is subsequently saved as HTML.
If this element is omitted, then the current div element does not represent an HTML body element. If both this element and the blockQuote element (§2.15.2.2) are specified, then this element shall be ignored. If this element is specified on any div which is not the main div element for the document, then this element shall be ignored.
[Example: Consider a simple HTML document defined as follows:
<html>
<body style="margin-left:200px;margin-top:50px">
<p>Paragraph one.</p>
<blockquote style="border: 5px solid #00FFFF">
<p>Paragraph in a blockquote.</p>
</blockquote>
<p>Paragraph two.</p>
</body>
</html>
When this document is saved in the WordprocessingML format, the information stored on the div, blockquote, and body elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1626542603">
<w:bodyDiv w:val="true" />
...
<w:divsChild>
...
</w:divsChild>
</w:div>
</w:divs>
The bodyDiv element has a val attribute value of true, which specifies that the div element actually represents properties on the HTML body when this document is resaved as HTML. end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the border which shall be displayed at the bottom of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a bottom border.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style=" border-left-style:solid; border-right-style:groove; border-right-width:1px; border-top-style:dashed; border-top-width:3px; border-bottom-style:outset; border-bottom-width:3px">
<p>paragraph of text</p>
</div>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:divBdr>
<w:top w:val="dashed" w:sz="18" w:space="7" w:color="auto" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="auto" />
<w:bottom w:val="outset" w:sz="18" w:color="auto" />
<w:right w:val="threeDEngrave" w:sz="6" w:color="auto" />
</w:divBdr>
</w:div>
</w:divs>
The bottom element specifies border information about the bottom border for the single HTML div structure in the document; in this case, a 2.25 point bottom border of type outset. The initial 3 pixel border was converted to 2.25 points using the following logic:
(missing picture formula-2.15.2.4-1)
end example]
|
Parent Elements |
|
divBdr (§2.15.2.7) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.15.2.4-2) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.15.2.4-3) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.15.2.4-4) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.15.2.4-5) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.15.2.4-6) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.15.2.4-7) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies the color of the splitters within the frameset in this WordprocessingML document. This element shall only be honored on the root frameset for this document, and may be ignored for all nested framesets in this document.
If this element is omitted, then the default color of the splitter may be automatically determined by the application displaying this WordprocessingML document (equivalent to a val attribute value of auto).
[Example: Consider a frameset consisting of the following three frames:
The following properties define the presentation of the splitter bars within this frameset:
<w:frameset>
<w:framesetSplitbar>
<w:w w:val="200" />
<w:color w:val="0000FF" />
</w:framesetSplitbar>
...
</w:frameset>
The color element's val attribute specifies that the splitters shall be displayed in the RGB color 0000FF (blue) when the contents of this document are displayed. end example]
|
Parent Elements |
|
framesetSplitbar (§2.15.2.20) |
|
Attributes |
Description |
|---|---|
|
themeColor (Run Content Theme Color) |
Specifies a theme color which should be applied to the current run. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows for color information to be set centrally in the document. If the [Example: Consider a run of text which should be displayed using the
The The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Run Content Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this run's contents. If the The [Example: Consider a shade of 40% applied to a run in a document. This shade is calculated as follows: (missing picture formula-2.15.2.5-1) Te resulting Given a input red, green, or blue color value C (from 0-255), an output color value of C' (from 0-255), and a shade value S (from 0-100), the shade is applied as follows: (missing picture formula-2.15.2.5-2) [Example: Consider a document with a run using the The hex value for the green component is
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Run Content Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this run's contents. If the The [Example: Consider a tint of 60% applied to a run in a document. This tint is calculated as follows: (missing picture formula-2.15.2.5-3) The resulting Given a input red, green, or blue color value C (from 0-255), an output color value of C' (from 0-255), and a tint value T (from 0-100), the tint is applied as follows: (missing picture formula-2.15.2.5-4) [Example: Consider a document with a run using the The hex value for the green component is
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Run Content Color) |
Specifies the color for this run. This color may either be presented as a hex value (in RRGGBB format), or If the run specifies the use of a theme color via the [Example: Consider a run color with value
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the run contents can be distinguished against the page's background color. end example] The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Color">
<attribute name="val" type="ST_HexColor" use="required"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
</complexType>
This element specifies information about a single HTML div, body, or blockquote element which was included in this document, so that that information (which is stored on a logical structure with no direct analog in WordprocessingML) may be maintained when an HTML document is stored in the WordprocessingML format.
The div element stores the following information about these structures:
div, and blockquote elementsWhen the resulting WordprocessingML document is displayed by an application, the settings specified by this information shall be reflected in the formatting of the resulting paragraphs (i.e. this information shall not only be used when the document is resaved in the HTML format).
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style="border-left-style: solid; border-left-width: 1px; border-right-style: solid; border-right-width: 1px; padding-left: 4px; padding-right: 4px; padding-top: 1px; padding-bottom: 1px; margin-left: 50px">
<p>Paragraph one.</p>
<p>Paragraph two.</p>
</div>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div, blockquote, and body elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:marLeft w:val="750" />
<w:divBdr>
<w:left w:val="single" w:sz="6" w:color="auto" />
<w:right w:val="single" w:sz="6" w:color="auto" />
</w:divBdr>
</w:div>
</w:divs>
The div element specifies all margin and border information about the single HTML div structures in the document; in this case, the left indentation and the left and right borders. end example]
|
Parent Elements |
|
Child Elements |
Subclause |
|---|---|
|
blockQuote (Data for HTML blockquote Element) |
|
|
bodyDiv (Data for HTML body Element) |
|
|
divBdr (Set of Borders for HTML div) |
|
|
divsChild (Child div Elements Contained within Current div) |
|
|
marBottom (Bottom Margin for HTML div) |
|
|
marLeft (Left Margin for HTML div) |
|
|
marRight (Right Margin for HTML div) |
|
|
marTop (Top Margin for HTML div) |
|
Attributes |
Description |
|---|---|
|
id (div Data ID) |
Specifies a unique decimal number which shall be used to associate one or more structures in the WordprocessingML content with this HTML When a WordprocessingML structure (a paragraph or a table row) is associated with [Example: If a paragraph is wrapped within two HTML div elements, like this:
The resulting WordprocessingML paragraph shall reference the div Data ID associated with the inner HTML The ID specified by this attribute is then referenced by the divId element for all structures which are immediately contained within the specified HTML [Example: Consider a simple HTML document defined as follows:
If the outer and inner
Then the first paragraph would reference the div ID of the outer div (since it is contained by the HTML
The The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Div">
<sequence>
<element name="blockQuote" type="CT_OnOff" minOccurs="0"/>
<element name="bodyDiv" type="CT_OnOff" minOccurs="0"/>
<element name="marLeft" type="CT_SignedTwipsMeasure"/>
<element name="marRight" type="CT_SignedTwipsMeasure"/>
<element name="marTop" type="CT_SignedTwipsMeasure"/>
<element name="marBottom" type="CT_SignedTwipsMeasure"/>
<element name="divBdr" type="CT_DivBdr" minOccurs="0"/>
<element name="divsChild" type="CT_Divs" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="id" type="ST_DecimalNumber" use="required"/>
</complexType>
This element specifies the set of borders for the boundaries of the current HTML div, body, or blockquote element, using the four border types defined by its child elements.
If this element is omitted, then there shall be no borders associated with the current HTML v, body, or blockquote element.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style=" border-left-style:solid; border-right-style:groove; border-right-width:3px; border-top-style:dashed; border-top-width:3px; border-bottom-style:outset; border-bottom-width:3px">
<p>paragraph of text</p>
</div>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:divBdr>
<w:top w:val="dashed" w:sz="18" w:space="7" w:color="auto" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="auto" />
<w:bottom w:val="outset" w:sz="18" w:color="auto" />
<w:right w:val="threeDEngrave" w:sz="6" w:color="auto" />
</w:divBdr>
</w:div>
</w:divs>
The divBdr element specifies border information about the single HTML div structure in the document. end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Child Elements |
Subclause |
|---|---|
|
bottom (Bottom Border for HTML div) |
|
|
left (Left Border for HTML div) |
|
|
right (Right Border for HTML div) |
|
|
top (Top Border for HTML div) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_DivBdr">
<sequence>
<element name="top" type="CT_Border" minOccurs="0"/>
<element name="left" type="CT_Border" minOccurs="0"/>
<element name="bottom" type="CT_Border" minOccurs="0"/>
<element name="right" type="CT_Border" minOccurs="0"/>
</sequence>
</complexType>
This element specifies all information about the set of HTML div elements (as well as the body and blockquote elements) which were included in this document, so that that information (which is stored on a logical structure with no direct analog in WordprocessingML) may be maintained when an HTML document is stored in the WordprocessingML format.
The divs element stores the following information about these structures:
div, blockquote, and body elementsWhen the resulting WordprocessingML document is displayed by an application, the settings specified by this information shall be reflected in the formatting of the resulting paragraphs (i.e. this information shall not only be used when the document is resaved in the HTML format).
[Example: Consider a simple HTML document defined as follows:
<html>
<body style="margin-left:200px;margin-top:50px">
<p>Paragraph one.</p>
<blockquote style="border: 5px solid #00FFFF">
<p>Paragraph in a blockquote.</p>
</blockquote>
<p>Paragraph two.</p>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div, blockquote, and body elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1626542603">
<w:bodyDiv w:val="1" />
<w:marLeft w:val="3000" />
<w:marTop w:val="750" />
<w:divsChild>
<w:div w:id="313534916">
<w:blockQuote w:val="1" />
<w:marLeft w:val="720" />
<w:marRight w:val="720" />
<w:marTop w:val="100" />
<w:marBottom w:val="100" />
<w:divBdr>
<w:top w:val="single" w:sz="36" w:color="00FFFF" />
<w:left w:val="single" w:sz="36" w:color="00FFFF" />
<w:right w:val="single" w:sz="36" w:color="00FFFF" />
<w:bottom w:val="single" w:sz="36" w:color="00FFFF" />
</w:divBdr>
</w:div>
</w:divsChild>
</w:div>
</w:divs>
The divs element specifies all of the margin and border information about the necessary HTML structures in the document; in this case, the body element and the nested blockquote. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Child Elements |
Subclause |
|---|---|
|
div (Information About Single HTML div Element) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Divs">
<sequence minOccurs="1" maxOccurs="unbounded">
<element name="div" type="CT_Div"/>
</sequence>
</complexType>
This element specifies the set of HTML div or blockquote elements which are contained within the current HTML div, body, or blockquote element, establishing the parent/child hierarchy of the original set of these elements.
When an HTML document containing these objects is saved in the WordprocessingML format, WordprocessingML objects store a reference to their most immediate parent div, body, or blockquote element using the divId element.
However, since only a single reference is stored, this information is often insufficient to determine the appropriate parent/child hierarchy for the original HTML div data, so it can be applied appropriately. This element allows that hierarchy to be stored, as child HTML div elements are stored within the childDivs element.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style=" margin-top:50px">
<p>Paragraph one.</p
<div style="margin-left:50px">
<p>Paragraph two.</p>
</div>
</div>
</body>
</html>
If the outer and inner body and div elements were assigned id attributes of 1626542603 and 313534916 respectively, then the first paragraph would reference the div ID of the outer div (since it is contained within that HTML div element) and the second paragraph would reference the div ID of the inner div (since it is contained within the child HTML div element), as follows:
<w:p>
<w:pPr>
<w:divId w:val="1626542603" />
</w:pPr>
<w:r>
<w:t>Paragraph one.</w:t>
</w:r>
</w:p>
<w:p>
<w:pPr>
<w:divId w:val="313534916" />
</w:pPr>
<w:r>
<w:t>Paragraph one.</w:t>
</w:r>
</w:p>
However, this information alone is insufficient - it is unclear if the second div is contained within, or simply adjacent to, the first one.
In order to preserve this information, the correct hierarchy is stored within the web settings part:
<w:divs>
<w:div w:id="1626542603">
...
<w:divsChild>
<w:div w:id="313534916">
...
</w:div>
</w:divsChild>
</w:div>
</w:divs>
The divsChild element contains the second div as a child of the first div, specifying that the first div covers both paragraphs. end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Child Elements |
Subclause |
|---|---|
|
div (Information About Single HTML div Element) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Divs">
<sequence minOccurs="1" maxOccurs="unbounded">
<element name="div" type="CT_Div"/>
</sequence>
</complexType>
This element specifies that applications shall not automatically place all supporting files (images which are part of this HTML web page, etc.) in a subdirectory when the contents of this WordprocessingML document are saved as a web page. Typically, applications which save a document as a web page consisting of multiple files save all supporting files in a subdirectory next to the main HTML file (in order to keep those files organized). This element specifies the files shall be placed in the same directory as the actual web page.
If this element is omitted from the document, then all supporting files should be saved into a subdirectory beneath the main web page file when this document is saved as a web page.
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:doNotOrganizeInFolder w:val="true" />
</w:webSettings>
The doNotOrganizeInFolder element has a val attribute value of true, which specifies that applications should save all supplementary files in the same directory as the main web page HTML document when saving this WordprocessingML document as a web page. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies whether applications may rely on the CSS properties for font face (the font-family property) when saving this WordprocessingML document as a web page. If this element is utilized, then the HTML font element should be used either in place of or in concert with these CSS properties in order to specify the font face formatting for the resulting web page.
If this element is omitted, then applications may choose to rely on the CSS properties for font face as desired.
[Note: This setting is intended for applications to save web pages which can be supported by legacy web browsers which do not support the reading of these CSS properties when attempting to read and display the resulting web page, in order to maximize the fidelity of the resulting output. end note]
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:doNotRelyOnCSS w:val="true" />
</w:webSettings>
The doNotRelyOnCSS element has a val attribute value of true, which specifies that applications should include the HTML font element when saving this WordprocessingML document as a web page. For example, this output:
<span style='font-family:"Courier New"'>text</span>
This output would instead be saved as follows:
<font face="Courier New"><span style='font-family:"Courier New"'>text</span></font>
end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that applications should recommend that new web page files generated using this WordprocessingML document use a multi-file web page format (HTML), rather than a single-file web page format (MHTML) when this document is saved as an HTML web page. This setting shall not prevent the use of the MHTML format; it shall only cause applications to recommend (via a default) a non single-file format when saving as a web page.
[Note: This setting is primarily intended for applications which explicitly support a "Save as Web Page..." action, in order to determine the default setting for the resulting web page. end note]
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:doNotSaveAsSingleFile w:val="true" />
</w:webSettings>
The doNotSaveAsSingleFile element specifies that applications should recommend a multi-file web page format when this document is subsequently saved as a web page. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that applications shall ensure that the file names for all files generated when saving this document as a web page do not exceed eight characters with a three character extension. This includes all supporting files (images which are part of this HTML web page, etc.).
[Note: This setting is intended for applications to save web pages which can be supported by legacy web browsers which do not support the reading of long file names when attempting to read and display the resulting web page. end note]
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:doNotUseLongFileNames w:val="true" />
</w:webSettings>
The doNotUseLongFileNames element specifies that applications should ensure that all file names generated when this document is subsequently saved as a web page do not exceed the 8.3 character file name limitation. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the encoding which shall be used for the contents of this WordprocessingML document when it is saved as an HTML web page. The set of encodings supported by this element shall be derived from the standard set of character set definitions provided at http://www.iana.org/assignments/character-sets.
If this element is omitted, then the default encoding for the current system shall be used when this document is saved as a web page. If the value of the val attribute is unknown or supported by an application, then the default encoding for the current system shall be used when this document is saved as a web page.
[Example: Consider a WordprocessingML document which contains the following content within the web settings part:
<w:webSettings>
<w:encoding w:val="utf-8" />
</w:webSettings>
The encoding element's val attribute has a value of utf-8, which specifies that this document shall be encoded in the UTF-8 format when it is saved as a web page. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Attributes |
Description |
|---|---|
|
val (String Value) |
Specifies that its contents will 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:
The value of the However, consider the following fragment:
In this case, the decimal number in the The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_String">
<attribute name="val" type="ST_String" use="required"/>
</complexType>
This element specifies the 3D style of the splitters within the frameset in this WordprocessingML document. This element shall only be honored on the root frameset for this document, and may be ignored for all nested framesets in this document. When this property is turned on, the borders for this frameset shall be flat (not 3D), otherwise they may be presented as 3D splitter when they are displayed.
If this element is omitted, then the default style of the splitter should be a 3D splitter.
[Example: Consider a frameset consisting of the following three frames:
The following properties define the presentation of the splitter bars within this frameset:
<w:frameset>
<w:framesetSplitbar>
<w:w w:val="200" />
<w:color w:val="0000FF" />
<w:flatBorders w:val="true" />
</w:framesetSplitbar>
...
</w:frameset>
The flatBorders element's val attribute has a value of true, which specifies that the style of the splitters shall be flat (the splitter may not be 3D when displayed). end example]
|
Parent Elements |
|
framesetSplitbar (§2.15.2.20) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the properties for a single frame within a frameset document. When a document defines a frameset using the frameset element; that frameset is composed of a set of frames, each of which is specified by a single frame element.
[Example: Consider a WordprocessingML document which 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:frame>
<w:sz w:val="20%" />
<w:name w:val="Frame 1" />
<w:sourceFileName r:id="rId1" />
</w:frame>
<w:frameset>
...
</w:frameset>
</w:frameset>
The frame element specifies the set of properties for a single frame in the document. In this case, these properties (for the frame marked with Frame 1 in the diagram above) specify that the frame shall have the following properties:
end example]
|
Parent Elements |
|
frameset (§2.15.2.18); frameset (§2.15.2.19) |
|
Child Elements |
Subclause |
|---|---|
|
linkedToFile (Maintain Link to Existing File) |
|
|
marH (Top and Bottom Margin for Frame) |
|
|
marW (Left and Right Margin for Frame) |
|
|
name (Frame Name) |
|
|
noResizeAllowed (Frame Cannot Be Resized) |
|
|
scrollbar (Scrollbar Display Option) |
|
|
sourceFileName (Source File for Frame) |
|
|
sz (Frame Size) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Frame">
<sequence>
<element name="sz" type="CT_String" minOccurs="0"/>
<element name="name" type="CT_String" minOccurs="0"/>
<element name="sourceFileName" type="CT_Rel" minOccurs="0"/>
<element name="marW" type="CT_PixelsMeasure" minOccurs="0"/>
<element name="marH" type="CT_PixelsMeasure" minOccurs="0"/>
<element name="scrollbar" type="CT_FrameScrollbar" minOccurs="0"/>
<element name="noResizeAllowed" type="CT_OnOff" minOccurs="0"/>
<element name="linkedToFile" type="CT_OnOff" minOccurs="0"/>
</sequence>
</complexType>
This element specifies the order in which the frames (and nested framesets) in a frameset shall be displayed. When a frameset is created, it can only contain frames which are stacked in one direction:
This element specifies how the frames in this frameset are stacked, which shall also be used to interpret the sizes defined by the sz element (§2.15.2.39) for each frame. In order to determine the ordering of the constituent frames within this frameset, the ordering of the child frame and frameset elements shall be used.
If this element is omitted, then the frames in this frameset shall be stacked vertically on top of one another (a row frameset).
[Example: Consider a WordprocessingML document which 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:frameLayout w:val="rows" />
<w:frame>
...
</w:frame>
<w:frameset>
<w:frameLayout w:val="cols" />
<w:frame>
...
</w:frame>
<w:frame>
...
</w:frame>
</w:frameset>
</w:frameset>
The frameLayout element specifies that the outer frameset is a consists of the single frame and the child frameset stacked vertically, and an inner nested frameset consisting of two frames stacked horizontally. end example]
|
Parent Elements |
|
frameset (§2.15.2.18); frameset (§2.15.2.19) |
|
Attributes |
Description |
|---|---|
|
val (Frameset Layout Value) |
Specifies the type of layout which shall be used to display the contents of the frames and nested framesets within this frameset, as defined by the simple type referenced below. [Example: Consider a frameset definition within a WordprocessingML document which defines the following frameset layout setting:
The The possible values for this attribute are defined by the ST_FrameLayout simple type (§2.18.35). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FrameLayout">
<attribute name="val" type="ST_FrameLayout" use="required"/>
</complexType>
This element specifies that this document is the container for a frameset. This WordprocessingML element is analogous to the frameset element in HTML.
When the frameset element is present within a document, that document shall serve as a frameset definition only; all of its normal document content shall therefore not be displayed as long as it contains at least one child frame or frameset element.
If this element is omitted, then the currently document shall not be treated as a frameset definition; its regular document content shall be displayed.
[Example: Consider a WordprocessingML document which 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:frameLayout w:val="rows" />
<w:frame>
...
</w:frame>
<w:frameset>
<w:frameLayout w:val="cols" />
<w:frame>
...
</w:frame>
<w:frame>
...
</w:frame>
</w:frameset>
</w:frameset>
The parent frameset element specifies that the current document is a frameset definition; that frameset consists of a single frame and another nested frameset stacked vertically. end example]
|
Parent Elements |
|
webSettings (§2.15.2.44) |
|
Child Elements |
Subclause |
|---|---|
|
frame (Single Frame Properties) |
|
|
frameLayout (Frameset Layout) |
|
|
frameset (Nested Frameset Definition) |
|
|
framesetSplitbar (Frameset Splitter Properties) |
|
|
sz (Nested Frameset Size) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Frameset">
<sequence>
<element name="sz" type="CT_String" minOccurs="0"/>
<element name="framesetSplitbar" type="CT_FramesetSplitbar" minOccurs="0"/>
<element name="frameLayout" type="CT_FrameLayout" minOccurs="0"/>
<choice minOccurs="0" maxOccurs="unbounded">
<element name="frameset" type="CT_Frameset" minOccurs="0" maxOccurs="unbounded"/>
<element name="frame" type="CT_Frame" minOccurs="0" maxOccurs="unbounded"/>
</choice>
</sequence>
</complexType>
This element specifies a frameset which has been nested within another frameset within a WordprocessingML document. This WordprocessingML element is analogous to the frameset element in HTML (when that frameset is the child of another frameset element).
[Example: Consider a WordprocessingML document which 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:frameLayout w:val="rows" />
<w:frame>
...
</w:frame>
<w:frameset>
<w:frameLayout w:val="cols" />
<w:frame>
...
</w:frame>
<w:frame>
...
</w:frame>
</w:frameset>
</w:frameset>
The child frameset element specifies the frameset definition for the inner frameset; that frameset consists of two frames (Frame 2 and Frame 3 in the image above) which have been laid out horizontally as columns. end example]
|
Parent Elements |
|
frameset (§2.15.2.18); frameset (§2.15.2.19) |
|
Child Elements |
Subclause |
|---|---|
|
frame (Single Frame Properties) |
|
|
frameLayout (Frameset Layout) |
|
|
frameset (Nested Frameset Definition) |
|
|
framesetSplitbar (Frameset Splitter Properties) |
|
|
sz (Nested Frameset Size) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Frameset">
<sequence>
<element name="sz" type="CT_String" minOccurs="0"/>
<element name="framesetSplitbar" type="CT_FramesetSplitbar" minOccurs="0"/>
<element name="frameLayout" type="CT_FrameLayout" minOccurs="0"/>
<choice minOccurs="0" maxOccurs="unbounded">
<element name="frameset" type="CT_Frameset" minOccurs="0" maxOccurs="unbounded"/>
<element name="frame" type="CT_Frame" minOccurs="0" maxOccurs="unbounded"/>
</choice>
</sequence>
</complexType>
This element specifies the properties for the splitters associated with this frameset. A splitter is a horizontal or vertical line which visually separates the contents of one frame from another within a frameset.
If this element is omitted, then the default parameters for each of the child frameset properties shall be used for all splitters in this frameset.
[Example: Consider a frameset consisting of the following three frames:
The following properties define the presentation of the splitter bars within this frameset:
<w:frameset>
<w:framesetSplitbar>
<w:w w:val="90" />
<w:color w:val="auto" />
</w:framesetSplitbar>
...
</w:frameset>
The framesetSplitbar element specifies the properties for all splitters in this frameset; in this case, those properties are that the splitter shall be 4.5 points (90 twentieths of a point) wide, and that the color of the splitter shall be automatically determined via the attribute value of auto. end example]
|
Parent Elements |
|
frameset (§2.15.2.18); frameset (§2.15.2.19) |
|
Child Elements |
Subclause |
|---|---|
|
color (Frameset Splitter Color) |
|
|
flatBorders (Frameset Splitter Border Style) |
|
|
noBorder (Do Not Display Frameset Splitters) |
|
|
w (Frameset Splitter Width) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FramesetSplitbar">
<sequence>
<element name="w" type="CT_TwipsMeasure" minOccurs="0"/>
<element name="color" type="CT_Color" minOccurs="0"/>
<element name="noBorder" type="CT_OnOff" minOccurs="0"/>
<element name="flatBorders" type="CT_OnOff" minOccurs="0"/>
</sequence>
</complexType>
This element specifies the border which shall be displayed at the left of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a left border.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style=" border-left-style:solid; border-right-style:groove; border-right-width:1px; border-top-style:dashed; border-top-width:3px; border-bottom-style:outset; border-bottom-width:3px">
<p>paragraph of text</p>
</div>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:divBdr>
<w:top w:val="dashed" w:sz="18" w:space="7" w:color="auto" />
<w:left w:val="single" w:sz="24" w:space="4" w:color="auto" />
<w:bottom w:val="outset" w:sz="18" w:color="auto" />
<w:right w:val="threeDEngrave" w:sz="6" w:color="auto" />
</w:divBdr>
</w:div>
</w:divs>
The left element specifies border information about the left border for the single HTML div structure in the document; in this case, a 3 point bottom border of type single. The initial 4 pixel border was converted to 3 points using the following logic:
(missing picture formula-2.15.2.21-1)
end example]
|
Parent Elements |
|
divBdr (§2.15.2.7) |
|
Attributes |
Description |
|---|---|
|
color (Border Color) |
Specifies the color for this border. This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate. [Example: Consider a border color with value auto, as follows:
This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. end example] If the border style (the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
frame (Create Frame Effect) |
Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text. If this attribute is omitted, then the border is not given any frame effect. [Example: Consider a bottom border which shall appear with a frame effect, which is specified in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
shadow (Border Shadow) |
Specifies whether this border should be modified to create the appearance of a shadow. For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location. If this attribute is omitted, then the border is not given the shadow effect. [Example: Consider a top border which shall appear with a shadow effect, resulting in the following WordprocessingML:
This frame's The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
space (Border Spacing Measurement) |
Specifies the spacing offset that shall be used to place this border on the parent object. When a document has a page border that is relative to the page edges (using a value of page in the When a document has a page border that is relative to the text extents (using a value of text in the [Example: Consider a document with a set of page borders all specified to appear 24 points from the edge of the page. The resulting WordprocessingML would be as follows:
The The possible values for this attribute are defined by the ST_PointMeasure simple type (§2.18.75). |
|
sz (Border Width) |
Specifies the width of the current border. If the border style ( If the border style ( [Example: Consider a document with a three point wide dashed line border on all sides, resulting in the following WordprocessingML markup:
The border style is specified using the The possible values for this attribute are defined by the ST_EighthPointMeasure simple type (§2.18.27). |
|
themeColor (Border Theme Color) |
Specifies a theme color to be applied to the current border. The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document. [Example: Consider a set of borders configured to use the accent2 theme color, resulting in the following WordprocessingML markup:
The borders have a The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Border Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a shade of 40% applied to a border in a document. This shade is calculated as follows: (missing picture formula-2.15.2.21-2) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.15.2.21-3) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is C0504D. The equivalent HSL color value would be. Applying the shade formula with a shade percentage of 75% to the luminance, we get: (missing picture formula-2.15.2.21-4) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Border Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this border instance. If the The [Example: Consider a tint of 60% applied to a border in a document. This tint is calculated as follows: (missing picture formula-2.15.2.21-5) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.15.2.21-6) [Example: Consider a document with a background using the accent2 theme color, whose RGB value (in RRGGBB hex format) is 4F81BD. The equivalent HSL color value would be. Applying the tint formula with a tint percentage of 60% to the luminance, we get: (missing picture formula-2.15.2.21-7) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting background's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Border Style) |
Specifies the style of border used on this object. This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style. [Example: Consider a left border resulting in the following WordprocessingML:
This border's The possible values for this attribute are defined by the ST_Border simple type (§2.18.4). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Border">
<attribute name="val" type="ST_Border" use="required"/>
<attribute name="color" type="ST_HexColor" use="optional"/>
<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
<attribute name="space" type="ST_PointMeasure" use="optional"/>
<attribute name="shadow" type="ST_OnOff" use="optional"/>
<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies that the file referenced by the sourceFileName element (§2.15.2.38) as the basis for the current frame shall not be changed, even when the file defined by the parent frameset is moved - i.e. the link shall remain exactly as specified.
[Guidance: Typically, when a document is incorporated into a frameset, a copy of that document is made such that all files encompassing the frameset are stored in a single subdirectory (so they can be moved as a single unit). However, if the link to the current file is absolute and shall not be changed even when the location of the main frameset document, then this element shall be set to indicate that setting. end guidance]
If this element is omitted, then a new file may be created as necessary when the parent frameset document is resaved to another location.
[Example: Consider a WordprocessingML document which 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:frame>
<w:sz w:val="20%" />
<w:name w:val="Frame 1" />
<w:sourceFileName r:id="rId1" />
<w:linkedToFile w:val="true" />
</w:frame>
<w:frameset>
...
</w:frameset>
</w:frameset>
The linkedToFile element specifies that the frame source location specified by the sourceFileName element (§2.15.2.38) shall not be modified, even if the parent frameset document is resaved to another location. end example]
|
Parent Elements |
|
frame (§2.15.2.16) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the margin which shall be displayed at the bottom of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a bottom margin.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style="margin-top:100px; margin-left:200px; margin-right:50px; margin-bottom:100px">
<p>paragraph of text</p>
</div>
<p>another paragraph of text</p>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:marLeft w:val="3000" />
<w:marRight w:val="750" />
<w:marTop w:val="1500" />
<w:marBottom w:val="1500" />
</w:div>
</w:divs>
The marBottom element specifies margin information about the bottom margin for the single HTML div structure in the document; in this case, a 75 point bottom margin. The initial 100 pixel margin was converted to 75 points using the following logic:
(missing picture formula-2.15.2.23-1)
end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (Positive or Negative Value in Twentieths of a Point) |
Specifies a value whose contents shall contain a positive whole number, whose contents consist of a positive or negative measurement in twentieths of a point (equivalent to 1/1440th of an inch). The contents of this measurement shall be interpreted based on the context of the parent XML element. [Example: Consider an attribute value of -720 whose type is ST_SignedTwipsMeasure. This attribute value specifies a value of negative one-half of an inch or -36 points (-720 twentieths of a point = -36 points = -0.5 inches). end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_SignedTwipsMeasure">
<attribute name="val" type="ST_SignedTwipsMeasure" use="required"/>
</complexType>
This element specifies the top and bottom margin height for a single frame in a frameset document, as follows:
This height is expressed in pixels.
If this element is omitted, then no top or bottom margin shall be used for this frame.
[Example: Consider a document that has a frame, where the margin height has been specified and is represented as the following WordprocessingML:
<w:frame>
<w:marH w:val="594"/>
</w:frame>
The marH element has a val attribute value of 594, which specifies that this frame has a top and bottom margin value of 594 pixels, resulting in 594 pixels of space between the content and the top and bottom margins of the frame. end example]
|
Parent Elements |
|
frame (§2.15.2.16) |
|
Attributes |
Description |
|---|---|
|
val (Measurement in Pixels) |
Specifies a value whose contents shall contain a positive whole number, whose contents consist of a positive measurement in pixels. The contents of this measurement shall be interpreted based on the context of the parent XML element. [Example: Consider an attribute value of 960 whose type is ST_PixelsMeasure. This attribute value specifies a value of 960 pixels. end example] The possible values for this attribute are defined by the ST_PixelsMeasure simple type (§2.18.74). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_PixelsMeasure">
<attribute name="val" type="ST_PixelsMeasure" use="required"/>
</complexType>
This element specifies the margin which shall be displayed at the left of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a left margin.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style="margin-top:100px; margin-left:200px; margin-right:50px; margin-bottom:100px">
<p>paragraph of text</p>
</div>
<p>another paragraph of text</p>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:marLeft w:val="3000" />
<w:marRight w:val="750" />
<w:marTop w:val="1500" />
<w:marBottom w:val="1500" />
</w:div>
</w:divs>
The marLeft element specifies margin information about the left margin for the single HTML div structure in the document; in this case, a 150 point left margin. The initial 200 pixel margin was converted to 150 points using the following logic:
(missing picture formula-2.15.2.25-1)
end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (Positive or Negative Value in Twentieths of a Point) |
Specifies a value whose contents shall contain a positive whole number, whose contents consist of a positive or negative measurement in twentieths of a point (equivalent to 1/1440th of an inch). The contents of this measurement shall be interpreted based on the context of the parent XML element. [Example: Consider an attribute value of -720 whose type is ST_SignedTwipsMeasure. This attribute value specifies a value of negative one-half of an inch or -36 points (-720 twentieths of a point = -36 points = -0.5 inches). end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_SignedTwipsMeasure">
<attribute name="val" type="ST_SignedTwipsMeasure" use="required"/>
</complexType>
This element specifies the margin which shall be displayed at the right of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a right margin.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style="margin-top:100px; margin-left:200px; margin-right:50px; margin-bottom:100px">
<p>paragraph of text</p>
</div>
<p>another paragraph of text</p>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:marLeft w:val="3000" />
<w:marRight w:val="750" />
<w:marTop w:val="1500" />
<w:marBottom w:val="1500" />
</w:div>
</w:divs>
The marRight element specifies margin information about the right margin for the single HTML div structure in the document; in this case, a 37.5 point right margin. The initial 50 pixel margin was converted to 37.5 points using the following logic:
(missing picture formula-2.15.2.26-1)
end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (Positive or Negative Value in Twentieths of a Point) |
Specifies a value whose contents shall contain a positive whole number, whose contents consist of a positive or negative measurement in twentieths of a point (equivalent to 1/1440th of an inch). The contents of this measurement shall be interpreted based on the context of the parent XML element. [Example: Consider an attribute value of -720 whose type is ST_SignedTwipsMeasure. This attribute value specifies a value of negative one-half of an inch or -36 points (-720 twentieths of a point = -36 points = -0.5 inches). end example] The possible values for this attribute are defined by the ST_SignedTwipsMeasure simple type (§2.18.88). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_SignedTwipsMeasure">
<attribute name="val" type="ST_SignedTwipsMeasure" use="required"/>
</complexType>
This element specifies the margin which shall be displayed at the top of the boundaries of the current HTML div object.
If this element is omitted, then this HTML div object shall not have a top margin.
[Example: Consider a simple HTML document defined as follows:
<html>
<body>
<div style="margin-top:100px; margin-left:200px; margin-right:50px; margin-bottom:100px">
<p>paragraph of text</p>
</div>
<p>another paragraph of text</p>
</body>
</html>
This HTML would therefore normally appear as follows (image scaled appropriately):
Now, when this document is saved in the WordprocessingML format, the information stored on the div elements is stored in the web setting part as follows:
<w:divs>
<w:div w:id="1785730240">
<w:marLeft w:val="3000" />
<w:marRight w:val="750" />
<w:marTop w:val="1500" />
<w:marBottom w:val="1500" />
</w:div>
</w:divs>
The marTop element specifies margin information about the top margin for the single HTML div structure in the document; in this case, a 75 point top margin. The initial 100 pixel margin was converted to 75 points using the following logic:
(missing picture formula-2.15.2.27-1)
end example]
|
Parent Elements |
|
div (§2.15.2.6) |
|
Attributes |
Description |
|---|---|
|
val (Positive or Negative Value in Twentieths of a Point) |
Specifies a value whose contents shall contain a positive whole number, whose contents consist of a positive or negative measurement in twentieths of a point (equivalent to 1/1440th of an inch). The contents of this measurement shall be interpreted based on the contex |