DocumentID: ECMA-376/Part4/2.7.3 Title: ECMA-376, Part4: 2.7.3 General Style Properties 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
General style properties refer to the set of properties which can be used regardless of the type of style. [Example: Within a style definition the style name, additional aliases for the style, a style ID (used by the document content to refer to the style), if style is hidden, if style is locked, etc. are general style properties. end example]
[Example: Consider a style called Heading 1 in a document as follows:
<w:style w:type="paragraph" w:styleId="Heading1">
<w:name w:val="heading 1"/>
<w:basedOn w:val="Normal"/>
<w:next w:val="Normal"/>
<w:link w:val="Heading1Char"/>
<w:priority w:val="1"/>
<w:qformat/>
<w:rsid w:val="00F303CE"/>
...
</w:style>
Above the formatting information specific to this style type are a set of general style properties which define information shared by all style types. end example]
This element specifies the set of alternative names for the parent style definition. These names may be used in an application's user interface as desired. The alternate names shall be stored in this element's val attribute, and each name shall be separated by one or more consecutive comma characters (Unicode character value 002C). All commas present shall be interpreted as separator character and never as part of an alternate style name.
If present, the alternate style names shall be used in the user interface in place of the built-in name specified in the name element (§2.7.3.9) when the appropriate value is set in the stylePaneFormatFilter element (§2.15.1.87).
If this element is omitted, then the style shall not have any alternate style names.
[Example: Consider a style with a primary name and two alternate names, defined using the name and aliases elements, as follows:
<w:style w:styleId="TestStyle" ... >
<w:name w:val="GD20Complex"/>
<w:aliases w:val="Regional Growth,Complex Growth"/>
...
</w:style>
This style specifies that it has the primary name GD20Complex using the name element (§2.7.3.9), as well as two alternate names Regional Growth and Complex Growth using the aliases element. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 whether an application shall automatically modify this style when the contents of an entire paragraph in the document with this style applied are modified, ensuring that although only a single instance of text with this style was modified, that change is stored on the style and therefore propagated to all locations where the style is in use.
If this element is omitted, then formatting shall not automatically be merged back into the style definition.
[Example: Consider a style defined as follows in a WordprocessingML document:
<w:style w:styleId="Normal" ... >
<w:name w:val="Normal"/>
<w:autoRedefine/>
<w:rPr>
<w:b/>
</w:rPr>
...
</w:style>
This style specifies via the use of the autoRedefine element that any formatting applied to text which uses this style shall be merged back into the style definition (assuming, of course, that this is a paragraph style).
For example, consider a document which uses the Normal style as defined above:
The first and third paragraphs use the Normal style, and hence have the bold property applied. If an application were to add the underline formatting to the entire first paragraph, as follows:
That property, rather than being saved as direct formatting, shall be used to update the associated Normal style to add this property, specified using the u element (§2.3.2.38).
<w:style w:styleId="Normal" ... >
<w:name w:val="Normal"/>
<w:autoRedefine/>
<w:rPr>
<w:b/>
<w:u/>
</w:rPr>
...
</w:style>
Since this property is automatically merged into the style, it would also appear on the third paragraph (note that the step above would normally be automatically modified into the state shown below, and not discrete as shown above).
end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 style ID of the parent style from which this style inherits in the style inheritance. The style inheritance refers to a set of styles which inherit from one another to produce the resulting set of properties for a single style. The val attribute of this element specifies the styleId attribute for the parent style in the style inheritance.
If this element is omitted, then this style shall not be based on any other style in the current document (i.e. this element is the root of the style inheritance for a style). If no style in the current document specifies the styleId present in the val attribute, then this element shall be ignored (i.e. this element is the root of the style inheritance for a style).
If a style with this styleId is present, then it shall be subject to the following restrictions:
[Example: Consider three WordprocessingML character styles defined as follows:
styleId value of Strong whose properties consist of the bold propertystyleId value of Underline whose properties consist of the underline propertystyleId value of Emphasis whose properties consist of the italics propertyEach of these character styles defines a single character formatting property. If the basedOn values for each element were defined as follows:
<w:style w:styleId="Strong">
<w:basedOn w:val="Underline"/>
...
<w:rPr>
<w:b/>
</w:rPr>
</w:style>
<w:style w:styleId="Underline">
<w:basedOn w:val="Emphasis"/>
...
<w:rPr>
<w:u/>
</w:rPr>
</w:style>
<w:style w:styleId="Emphasis">
...
<w:rPr>
<w:i/>
</w:rPr>
</w:style>
The Strong style is based on the Underline style which is in turn based on the Emphasis style. This means that the actual definition of the Strong style would be as follows:
The style chain for the Strong style would be defined as follows:
Similarly, the style chain for the Underline style would be defined as follows:
In each case, the style chain is the list of all styles which are combined in order to produce the entire set of properties for any given style. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 whether this style shall be hidden from any and all user interfaces when this document is loaded by an application. If this element is set, then this style may be used to format content (i.e. any content which references this style shall have its properties as normal), but the style shall be hidden from all user interface associated with that application. [Note: This setting is typically used to hide styles which are being used internally by an application which should not be used as formatting in a typical case. end note]
If this element is omitted, then the style shall not be required to be hidden from the user interface.
[Example: Consider a style with a primary name of InternalStyle that should not be displayed in any user interface. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="Style2">
<w:name w:val="InternalStyle"/>
<w:hidden/>
...
</w:style>
The hidden element specifies that this style definition shall be round-tripped with the file (since it is part of the document) but should not be displayed in any user interface associated with an application which processes this document. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 which shall be applied to a set of latent styles for this document. Latent styles refer to any set of style definitions known to an application which have not been included in the current document. [Example: Latent styles may include additional styles known by a particular hosting application. end example]
When a style definition is embedded in a document, it specifies two distinct groups of properties:
Obviously, embedding all the styles known to a particular application in each document which it produces would drastically increase the file size. Latent styles provide a way to store pieces of information for the first group (behavior properties) which must be specified for all styles known to an application without requiring the storage of the second group (formatting properties).
[Example: Consider a WordprocessingML document which contains text specified in one of two styles: Heading1 or Normal. Based on this, the document only needs to store the formatting properties for those two styles, saving the additional overhead which would be required to save all of the styles supported by the hosting application.
However, if the documentProtection element (§2.15.1.28) specifies that the hosting application shall prevent the use of any style whose locked element (§2.7.3.7) is set to false, then the locking state of all styles known to that application become useful and necessary to maintain the current state of the document. Using latent styles, this information may be stored without storing any formatting properties for those styles.
For example, if all styles which are not stored in the document shall be locked except for the style with a primary name (§2.7.3.9) of Heading 2. This requirement would be specified using latent styles as follows:
<w:latentStyles ... w:defLockedState="true">
<w:lsdException w:name="Heading 2" w:locked="false"/>
</w:latentStyles>
The latentStyles element specifies that all latent styles known to any hosting application shall have a default locking state of true except for any style known to the hosting application with a primary name of Heading 2, whose latent style definition specifies that its locked state shall be false. end example]
|
Parent Elements |
|
styles (§2.7.3.18) |
|
Child Elements |
Subclause |
|---|---|
|
lsdException (Latent Style Exception) |
|
Attributes |
Description |
|---|---|
|
count (Latent Style Count) |
Specifies the number of known styles which shall be initialized to the current latent style defaults when this document is first processed. [Note: This property may be used by an application as needed to ensure that only the number of styles known when this document was created are initialized with the defaults on the parent element, and that all new known styles use their default values. end note] [Example: Consider a WordprocessingML document in which only the first 20 latent styles shall be initialized. This requirement would be specified as follows:
The The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
defLockedState (Default Style Locking Setting) |
Specifies the default setting for the locked element (§2.7.3.7) which shall be applied to any style made available by the hosting application which is not explicitly defined in the current document. This setting shall be overridden for every style for which a latent style exception (§2.7.3.8) exists. If this element is omitted, the default locked state for all latent styles in the current document shall be false. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall be locked. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
defQFormat (Default Primary Style Setting) |
Specifies the default setting for the qFormat element (§2.7.3.14) which shall be applied to any style made available by the hosting application which is not explicitly defined in the current document. This setting shall be overridden for every style for which a latent style exception (§2.7.3.8) exists. If this element is omitted, the default qFormat state for all latent styles in the current document shall be false. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall not be marked as primary styles. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
defSemiHidden (Default Semi-Hidden Setting) |
Specifies the default setting for the semiHidden element (§2.7.3.16) which shall be applied to any style made available by the hosting application which is not explicitly defined in the current document. This setting shall be overridden for every style for which a latent style exception (§2.7.3.8) exists. If this element is omitted, the default semiHidden state for all latent styles in the current document shall be false. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall not be marked as semi-hidden. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
defUIPriority (Default User Interface Priority Setting) |
Specifies the default setting for the uiPriority element (§2.7.3.19) which shall be applied to any style made available by the hosting application which is not explicitly defined in the current document. This setting shall be overridden for every style for which a latent style exception (§2.7.3.8) exists. If this element is omitted, the default uiPriority state for all latent styles in the current document shall be 99. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall not be marked as semi-hidden. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
defUnhideWhenUsed (Default Hidden Until Used Setting) |
Specifies the default setting for the unhideWhenUsed element (§2.7.3.20) which shall be applied to any style made available by the hosting application which is not explicitly defined in the current document. This setting shall be overridden for every style for which a latent style exception (§2.7.3.8) exists. If this element is omitted, the default unhideWhenUsed state for all latent styles in the current document shall be false. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall be hidden until they are used in the document's contents. This requirement would be specified using latent styles as follows:
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_LatentStyles">
<sequence>
<element name="lsdException" type="CT_LsdException" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="defLockedState" type="ST_OnOff"/>
<attribute name="defUIPriority" type="ST_DecimalNumber"/>
<attribute name="defSemiHidden" type="ST_OnOff"/>
<attribute name="defUnhideWhenUsed" type="ST_OnOff"/>
<attribute name="defQFormat" type="ST_OnOff"/>
<attribute name="count" type="ST_DecimalNumber"/>
</complexType>
This element specifies the pairing of styles which comprise a linked style. A linked style is a grouping of a paragraph style and character style which is used in a user interface to allow the same set of formatting properties to be applied:
Each style continues to exist independently in the file format as there is both a paragraph and character style present within the styles element (§2.7.3.18), however these two styles shall be merged into one and applied appropriately based on whether they are applied to run(s) or paragraph(s), by referencing the styleId attribute of the paired linked style via this element's val attribute.
If this element is omitted, then this style is not part of a linked style pairing. If no style in the current document specifies the styleId present in the val attribute, then this element shall be ignored.
If a style with this styleId is present, then it shall be subject to the following restrictions:
[Example: Consider a linked style defined as follows in a WordprocessingML document:
<w:style w:type="paragraph" w:styleId="TestParagraphStyle">
<w:link w:val="TestCharacterStyle"/>
...
</w:style>
<w:style w:type="character" w:styleId="TestCharacterStyle">
<w:link w:val="TestParagraphStyle"/>
...
</w:style>
This pairing of a paragraph style and a character style are linked via the link element, which is used the reference the styleId of the paragraph style from the character style definition and vice versa. Because this pairing is valid based on the rules above, the resulting combination shall be used as a linked style, which appears as one style in an application, but uses the character and/or paragraph style as appropriate. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 whether an application shall prevent the use of this style when this document is loaded and/or modified. If this element is set, then this style may be used to format existing content (i.e. any content which references this style shall have its properties as normal), but new instances of the style shall be prevented from being applied via all mechanisms associated with that application.
If this element is omitted, then the use of the style shall not be prevented by an application processing this document.
[Example: Consider a style with a primary name of Test Style which should be locked, and prevented from being added to any content in a given document. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="TestStyle">
<w:name w:val="Test Style"/>
<w:locked/>
...
</w:style>
The presence of the locked element specifies that this style definition shall new instances of the style shall be prevented from being applied via all mechanisms associated with that application. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 which shall be applied a single latent style for this document. Latent styles refer to any set of known style definitions which have not been included in the current document.
[Example: Consider a WordprocessingML document which contains text specified in one of two styles: Heading1 or Normal. Based on this, the document only needs to store the formatting properties for those two styles, saving the additional overhead which would be required to save all of the styles supported by the hosting application.
However, if the documentProtection element (§2.15.1.28) specifies that the hosting application shall prevent the use of any style whose locked element (§2.7.3.7) is set to false, then the locking state of all styles known to that application become useful and necessary to maintain the current state of the document. Using latent styles, this information may be stored without storing any formatting properties for those styles.
For example, if all styles which are not stored in the document shall be locked except for the style with a primary name (§2.7.3.9) of Heading 2. This requirement would be specified using latent styles as follows:
<w:latentStyles ... w:defLockedState="true">
<w:lsdException w:name="Heading 2" w:locked="false"/>
</w:latentStyles>
The lsdException element specifies that the latent style with a primary name of Heading 2 shall have a locked state setting of false. end example]
|
Parent Elements |
|
latentStyles (§2.7.3.5) |
|
Attributes |
Description |
|---|---|
|
locked (Latent Style Locking Setting) |
Specifies the default setting for the locked element (§2.7.3.7) which shall be applied to the latent style with the matching style If this element is omitted, the default locked state for this latent style shall be determined by the [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall be locked except for the TestStyle style. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
name (Primary Style Name) |
Specifies the primary name for the style which shall inherit this set of latent style property exceptions. If the current application does not know of an internal primary style with the current name, then this set of latent style exceptions may be ignored. [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall be locked except for the TestStyle style. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
qFormat (Latent Style Primary Style Setting) |
Specifies the default setting for the qFormat element (§2.7.3.14) which shall be applied to the latent style with the matching style If this element is omitted, the default qFormat state for this latent style shall be determined by the [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall not be primary styles except for the TestStyle style. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
semiHidden (Semi hidden text override) |
Specifies the default setting for the semiHidden element (§2.7.3.16) which shall be applied to the latent style with the matching style If this element is omitted, the default semiHidden state for this latent style shall be determined by the [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall not be semi-hidden except for the TestStyle style. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
uiPriority (Override default sorting order) |
Specifies the default setting for the uiPriority element (§2.7.3.19) which shall be applied to the latent style with the matching style If this element is omitted, the default uiPriority state for this latent style shall be determined by the [Example: Consider a WordprocessingML document in which all styles which are not stored in the document shall have a priority value of 10 except for the TestStyle style. This requirement would be specified using latent styles as follows:
The The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
unhideWhenUsed (Unhide when used) |
Specifies the default setting for the unhideWhenUsed element (§2.7.3.20) which shall be applied to the latent style with the matching style If this element is omitted, the default unhideWhenUsed state for this latent style shall be determined by the [Example: Consider a WordprocessingML document in which all styles are to be hidden until used except for the TestStyle style. This requirement would be specified using latent styles as follows:
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_LsdException">
<attribute name="name" type="ST_String" use="required"/>
<attribute name="locked" type="ST_OnOff"/>
<attribute name="uiPriority" type="ST_DecimalNumber"/>
<attribute name="semiHidden" type="ST_OnOff"/>
<attribute name="unhideWhenUsed" type="ST_OnOff"/>
<attribute name="qFormat" type="ST_OnOff"/>
</complexType>
This element specifies the primary name for the current style in the document. This name may be used in an application's user interface as desired. The actual primary name for this style is stored in its val attribute.
If present, the alternate style names (§2.7.3.1) shall be used in the user interface in place of the built-in name specified when the appropriate value is set in the stylePaneFormatFilter element (§2.15.1.86).
If this element is omitted, then the style shall not have a primary style name.
[Example: Consider a style with a primary name and two alternate names, defined using the name and aliases elements, as follows:
<w:style w:styleId="TestStyle" ... >
<w:name w:val="GD20Complex"/>
<w:aliases w:val="Regional Growth,Complex Growth"/>
...
</w:style>
This style specifies that it has the primary name GD20Complex using the name element. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 style which shall automatically be applied to a new paragraph created following a paragraph with the parent paragraph style applied. [Note: This setting is typically used when the use of the current style is limited to one paragraph at most, and it would typically be undesirable to apply this style to following paragraphs - for example, a title style may specify that its following paragraphs shall return to regular text formatting. end note]
If this element is specified on a style of any type other than a paragraph style, this element shall be ignored. If no style whose styleId matches the val attribute of this element exists or that style is not a paragraph style, this element shall be ignored.
If this element is omitted, then the following paragraph shall use the same paragraph style as the current paragraph.
[Example: Consider a style defined as follows in a WordprocessingML document:
<w:style w:styleId="TestParagraphStyle" ... >
<w:name w:val="Test Paragraph Style"/>
<w:next w:val="AnotherParagraphStyle"/>
<w:rPr>
<w:b/>
</w:rPr>
...
</w:style>
This style specifies via the use of the next element that the style for the next paragraph in the document shall be the paragraph style whose styleId attribute value is AnotherParagraphStyle (if such a paragraph style exists). end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 that the parent style, when in use in the context of an e-mail message, was used by default to format all message text from one or more users. [Note: This setting does not provide any additional semantic about the style, but may be used in the context of e-mail to automatically reformat the contents of the e-mail message while ignoring any content to which styles were deliberately applied (since this style was implicitly applied to message text without user interaction). end note]
If this element is specified on a style of any type other than a character style, this element shall be ignored. If no style whose styleId matches the val attribute of this element exists or that style is not a character style, this element shall be ignored.
If this element is omitted, then the current style shall not be considered a message text style in the context of e-mail messages.
[Example: Consider a style defined as follows in a WordprocessingML document:
<w:style w:styleId="EmailText" w:type="character" >
<w:name w:val="EmailText"/>
<w:personal w:val="true" />
<w:rPr>
...
</w:rPr>
</w:style>
This style specifies via the use of the personal element that this style is a style used to format message text in the context of e-mail. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 parent style, when in use in the context of an e-mail message, may be used by default to format new message text within the e-mail message. [Note: This setting does not provide any additional semantic about the style, but may be used in the context of e-mail to automatically format the contents of new test in the e-mail message. end note]
If this element is specified on a style of any type other than a character style, this element shall be ignored. If no style whose styleId matches the val attribute of this element exists or that style is not a character style, this element shall be ignored.
If this element is omitted, then the current style shall not be considered a message composition text style in the context of e-mail messages.
[Example: Consider a style defined as follows in a WordprocessingML document:
<w:style w:styleId="EmailText" w:type="character" >
<w:name w:val="EmailText"/>
<w:personalCompose w:val="true" />
<w:rPr>
...
</w:rPr>
</w:style>
This style specifies via the use of the personalCompose element that this style is a style used to format new message text in the context of e-mail. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 parent style, when in use in the context of an e-mail message, may be used by default to format existing message text within the e-mail message when a new reply is generated. [Note: This setting does not provide any additional semantic about the style, but may be used in the context of e-mail to automatically format the contents of existing test in the e-mail message. end note]
If this element is specified on a style of any type other than a character style, this element shall be ignored. If no style whose styleId matches the val attribute of this element exists or that style is not a character style, this element shall be ignored.
If this element is omitted, then the current style shall not be considered a message reply text style in the context of e-mail messages.
[Example: Consider a style defined as follows in a WordprocessingML document:
<w:style w:styleId="EmailText" w:type="character" >
<w:name w:val="EmailText"/>
<w:personalReply w:val="true" />
<w:rPr>
...
</w:rPr>
</w:style>
This style specifies via the use of the personalReply element that this style is a style used to format existing message text in the context of e-mail. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 this style shall be treated as a primary style when this document is loaded by an application. If this element is set, then this style has been designated as being particularly important for the current document, and this information may be used by an application in any means desired. [Note: This setting does not imply any behavior for the style, only that the style is of particular significance for this document. end note]
If this element is omitted, then the style shall not be considered a primary style for this document.
[Example: Consider a style with a primary name of PrimaryStyleExample that should be treated as a primary style for the document. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="PStyle">
<w:name w:val="PrimaryStyleExample"/>
<w:qFormat/>
...
</w:style>
The qFormat element specifies that this style definition shall be treated as a primary style for this document. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 a unique four digit number which shall be used to determine the editing session in which this style definition was last modified. This value shall follow this following constraint: All document elements which specify the same rsid* values must correspond to changes made during the same editing session. An editing session is defined as the period of editing which takes place between any two subsequent save actions. [Note: This setting does not imply any behavior for the style, only that the style was last modified during one particular editing session. This information may be interpreted by an application in any manner desired. end note]
If this element is omitted, then no revision identifier shall be associated with the parent style definition.
[Example: Consider a style with a primary name of PrimaryStyleExample that is defined as follows:
<w:style ... w:styleId="PStyle">
<w:name w:val="PrimaryStyleExample"/>
<w:rsid w:val="3E412D01"/>
...
</w:style>
The rsid element specifies that this style definition was last edited in the editing session corresponding to the value 3E412D01. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
Attributes |
Description |
|---|---|
|
val (Long Hexadecimal Number Value) |
Specifies a number value specified as a four digit hexadecimal number), whose contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following value for an attribute of type ST_LongHexNumber: 00BE2C6C. This value is valid, as it contains four hexadecimal digits, each an encoding of an octet of the actual decimal number value. It may therefore be interpreted as desired in the context of the parent XML element, end example] The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_LongHexNumber">
<attribute name="val" type="ST_LongHexNumber" use="required"/>
</complexType>
This element specifies whether this style shall be hidden from the main user interface when this document is loaded by an application. If this element is set, then this style may be used to format content (i.e. any content which references this style shall have its properties as normal), but the style shall be hidden from the main user interface associated with that application.
[Note: The interpretation of a "main" user interface shall not be dictated by this Office Open XML Standard, and may be defined by an application as appropriate.
This setting is intended to define a style property which allows styles to be seen and modified in an advanced user interface, without exposing the style in a less advanced setting, for example, the style which is used to format the contents of a comment should typically not be shown in a simple user interface (as it is uncommon to want to modify it), but would be inappropriate to hide completely using the hidden element (§2.7.3.4), as very advanced users may want to change its appearance. end note]
If this element is omitted, then the style shall not be required to be hidden from the main user interface.
[Example: Consider a style with a primary name of Comment Style that should not be displayed in the main user interface. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="CStyle">
<w:name w:val="Comment Style"/>
<w:semiHidden/>
...
</w:style>
The semiHidden element specifies that this style definition should not be displayed in any main user interface associated with an application which processes this document. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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 definition of a single style within a WordprocessingML document. A style is a predefined set of table, numbering, paragraph, and/or character properties which can be applied to regions within a document.
The style definition for any style definition can be divided into three segments:
General style properties refers to the set of properties which can be used regardless of the type of style; for example, the style name, additional aliases for the style, a style ID (used by the document content to refer to the style), if style is hidden, if style is locked, etc.
[Example: Consider a style called Heading 1 in a document as follows:
<w:style w:type="paragraph" w:styleId="Heading1">
<w:name w:val="Heading 1"/>
<w:basedOn w:val="Normal"/>
<w:next w:val="Normal"/>
<w:link w:val="Heading1Char"/>
<w:priority w:val="1"/>
<w:qformat/>
<w:rsid w:val="00F303CE"/>
...
</w:style>
Above the formatting information specific to this style type are a set of general style properties which define information shared by all style types. end example]
Style types refers to the property on a style which defines the type of style created with this style definition. WordprocessingML supports six types of style definitions by the values for the style definition's type attribute:
[Example: Consider a style called Heading 1 in a document as follows:
<w:style w:type="paragraph" w:styleId="Heading1">
<w:name w:val="heading 1"/>
<w:basedOn w:val="Normal"/>
<w:next w:val="Normal"/>
<w:link w:val="Heading1Char"/>
<w:priority w:val="1"/>
<w:qformat/>
<w:rsid w:val="00F303CE"/>
...
</w:style>
The type attribute has a value of paragraph, which indicates that the following style definition is a paragraph style. end example]
Type-specific properties refers to the payload of the style: its formatting information as well as any properties which apply only to that type of style.
[Example: Consider a table style with primary name Normal Table defined as follows:
<w:style w:type="table" w:default="1" w:styleId="TableNormal">
<w:name w:val="Normal Table"/>
...
<w:tblPr>
<w:tblInd w:w="0" w:type="dxa"/>
<w:tblCellMar>
<w:top w:w="0" w:type="dxa"/>
<w:left w:w="108" w:type="dxa"/>
<w:bottom w:w="0" w:type="dxa"/>
<w:right w:w="108" w:type="dxa"/>
</w:tblCellMar>
</w:tblPr>
</w:style>
The tblPr element contains the formatting payload for this table style, which is only applicable to a table style. end example]
|
Parent Elements |
|
styles (§2.7.3.18) |
|
Child Elements |
Subclause |
|---|---|
|
aliases (Alternate Style Names) |
|
|
autoRedefine (Automatically Merge User Formatting Into Style Definition) |
|
|
basedOn (Parent Style ID) |
|
|
hidden (Hide Style From User Interface) |
|
|
link (Linked Style Reference) |
|
|
locked (Style Cannot Be Applied) |
|
|
name (Primary Style Name) |
|
|
next (Style For Next Paragraph) |
|
|
personal (E-Mail Message Text Style) |
|
|
personalCompose (E-Mail Message Composition Style) |
|
|
personalReply (E-Mail Message Reply Style) |
|
|
pPr (Style Paragraph Properties) |
|
|
qFormat (Primary Style) |
|
|
rPr (Run Properties) |
|
|
rsid (Revision Identifier for Style Definition) |
|
|
semiHidden (Hide Style From Main User Interface) |
|
|
tblPr (Style Table Properties) |
|
|
tblStylePr (Style Conditional Table Formatting Properties) |
|
|
tcPr (Style Table Cell Properties) |
|
|
trPr (Style Table Row Properties) |
|
|
uiPriority (Optional User Interface Sorting Order) |
|
|
unhideWhenUsed (Remove Semi-Hidden Property When Style Is Used) |
|
Attributes |
Description |
|---|---|
|
customStyle (User-Defined Style) |
Specifies that this style is a user-defined style (i.e. it is not a style which was automatically generated by an application). This setting (specifically a value of true or its equivalents) shall not allow the formatting associated with the style to be changed automatically by an application, but may be used to specify that if the associated style ID is known, certain user interface behaviors may be applied to its definition. [Example: The style's primary name may be localized to match the current user interface language. end example] If this attribute is omitted, then the style shall be assumed to be a built-in style. [Example: Consider a paragraph style defined as follows:
This paragraph style specifies that it is a user-defined style using the The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
default (Default Style) |
Specifies that this style is the default for this type of style. This property is used in conjunction with the If this attribute is not specified for any style, then no properties shall be applied to objects of the specified type. If this attribute is specified by multiple styles, then the last instance of a style with this property shall be used. [Example: Consider a paragraph style defined as follows:
This paragraph style specifies that it is the default paragraph style, and therefore all paragraphs which do not explicitly reference a paragraph style shall have this style applied. For example, consider the following paragraphs from the same WordprocessingML document:
The contents of the first paragraph shall have the Normal paragraph style applied to them, while the contents of the second paragraph shall have the MyStyle paragraph style applied, since it does not explicitly reference a paragraph style and therefore inherits the default. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
styleId (Style ID) |
Specifies a unique identifier for the parent style definition. This identifier shall be used in multiple contexts to uniquely reference this style definition within the document. [Example: The following are examples of elements which reference a style via its
end example] If multiple style definitions each declare the same value for their If this attribute is not specified, then a style ID may be assigned in any manner desired. [Example: Consider a paragraph style defined as follows:
This paragraph style specifies that its style identifier shall be MyStyle using the Now consider the following paragraphs from the same WordprocessingML document:
The contents of the first paragraph shall have the bold paragraph property applied to them because their paragraph properties specify that they shall inherit the paragraph style whose The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
type (Style Type) |
Specifies the type of style definition defined by this element. WordprocessingML supports six types of style definitions:
Each of the first four types corresponds to a different value in this attribute, and therefore defines the type of the current style. [Note: The last two types are unique in that they are not simply a style type: a linked style is a pairing of a character and paragraph style via the link element (§2.7.3.6); and the document default properties are defined via the docDefaults element (§2.7.4.1). end note] If this attribute is not specified, then the default value shall be assumed to be paragraph. [Example: Consider a style defined as follows:
The The possible values for this attribute are defined by the ST_StyleType simple type (§2.18.90). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Style">
<sequence>
<element name="name" type="CT_String" minOccurs="0" maxOccurs="1"/>
<element name="aliases" type="CT_String" minOccurs="0"/>
<element name="basedOn" type="CT_String" minOccurs="0"/>
<element name="next" type="CT_String" minOccurs="0"/>
<element name="link" type="CT_String" minOccurs="0"/>
<element name="autoRedefine" type="CT_OnOff" minOccurs="0"/>
<element name="hidden" type="CT_OnOff" minOccurs="0"/>
<element name="uiPriority" type="CT_DecimalNumber" minOccurs="0"/>
<element name="semiHidden" type="CT_OnOff" minOccurs="0"/>
<element name="unhideWhenUsed" type="CT_OnOff" minOccurs="0"/>
<element name="qFormat" type="CT_OnOff" minOccurs="0"/>
<element name="locked" type="CT_OnOff" minOccurs="0"/>
<element name="personal" type="CT_OnOff" minOccurs="0"/>
<element name="personalCompose" type="CT_OnOff" minOccurs="0"/>
<element name="personalReply" type="CT_OnOff" minOccurs="0"/>
<element name="rsid" type="CT_LongHexNumber" minOccurs="0"/>
<element name="pPr" type="CT_PPr" minOccurs="0" maxOccurs="1"/>
<element name="rPr" type="CT_RPr" minOccurs="0" maxOccurs="1"/>
<element name="tblPr" type="CT_TblPrBase" minOccurs="0" maxOccurs="1"/>
<element name="trPr" type="CT_TrPr" minOccurs="0" maxOccurs="1"/>
<element name="tcPr" type="CT_TcPr" minOccurs="0" maxOccurs="1"/>
<element name="tblStylePr" type="CT_TblStylePr" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="type" type="ST_StyleType" use="optional"/>
<attribute name="styleId" type="ST_String" use="optional"/>
<attribute name="default" type="ST_OnOff" use="optional"/>
<attribute name="customStyle" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies all of the style information stored in the WordprocessingML document: style definitions as well as latent style information.
[Example: The Normal paragraph style in a word processing document can have any number of formatting properties, e.g. font face = Times New Roman; font size = 12pt; paragraph justification = left). All paragraphs which reference this paragraph style would automatically inherit these properties. end example]
|
Parent Elements |
|
Root element of WordprocessingML Style Definitions part |
|
Child Elements |
Subclause |
|---|---|
|
docDefaults (Document Default Paragraph and Run Properties) |
|
|
latentStyles (Latent Style Information) |
|
|
style (Style Definition) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Styles">
<sequence>
<element name="docDefaults" type="CT_DocDefaults" minOccurs="0"/>
<element name="latentStyles" type="CT_LatentStyles" minOccurs="0" maxOccurs="1"/>
<element name="style" type="CT_Style" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
This element specifies a number which may be used to sort the set of style definitions in a user interface when this document is loaded by an application and the recommended setting is specified in the stylePaneSortMethod element (§2.15.1.87). If this element is set, then this priority shall be used to sort all available styles in ascending value order.
If this element is omitted, then the style shall not have an associated priority value and shall be sorted to the end of the list of style definitions (more or less equivalent to a priority value of infinity) when the recommended sort order setting is specified.
[Example: Consider a style with a primary name of Comment Style that should have an associated priority value of ten. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="CStyle">
<w:name w:val="Comment Style"/>
<w:uiPriority w:val="10"/>
...
</w:style>
The uiPriority element specifies that this style definition should be sorted into the list of styles using a value of 10 when the styles are listed in recommended order using the stylePaneSortMethod element (§2.15.1.87). end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
Attributes |
Description |
|---|---|
|
val (Decimal Number Value) |
Specifies that the contents of this attribute will contain a decimal number. The contents of this decimal number are interpreted based on the context of the parent XML element. [Example: Consider the following numeric WordprocessingML property of type ST_DecimalNumber: <w:... w:val="1512645511" /> The value of 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_DecimalNumber">
<attribute name="val" type="ST_DecimalNumber" use="required"/>
</complexType>
This element specifies whether the semiHidden property (§2.7.3.16) shall be removed when this style is used by the content of the document. If this element is set, then an application shall ensure that even if the semiHidden element is specified on a style, that this property is removed when the document is resaved if the style is referenced by any content in the document.
If this element is omitted, then the style shall not automatically lose the semi-hidden property when it is used in the document contents.
[Example: Consider a style with a primary name of Test Paragraph Style that should not be displayed in the main user interface until it is used. This requirement would be specified using the following WordprocessingML:
<w:style ... w:styleId="TestStyle">
<w:name w:val="Test Paragraph Style"/>
<w:semiHidden/>
<w:unhideWhenUsed/>
...
</w:style>
The unhideWhenUsed element specifies that this style definition should not be displayed in any main user interface associated with an application which processes this document until it is referenced by document content. If a paragraph was added to the document which referenced this style:
<w:p>
<w:pPr>
<w:pStyle w:val="TestStyle"/>
</w:pPr>
...
</w:p>
This style is now referenced by the document's contents and would have the semiHidden element removed on save. end example]
|
Parent Elements |
|
style (§2.7.3.17) |
|
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>