DocumentID: ECMA-376/Part4/2.3.2 Title: ECMA-376, Part4: 2.3.2 Run 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 level of the document hierarchy is the run, which defines a region of text with a common set of properties, represented by the r element (§2.3.2.23). An r element allows the producer to specify a single set of formatting properties, applying the same information to all the contents of the run.
Just as a paragraph can have properties, so too can a run. All of the elements inside an r element have their properties controlled by a corresponding optional rPr run properties element (§2.7.8.1; §2.3.2.26), which must be the first child of the r element. In turn, the rPr element is a container for a set of property elements that are applied to the rest of the children of the r element. [Note: The elements inside the rPr container element allow the consumer to control whether the content in the following run content is bold, underlined, or visible, for example. end note]
[Example: Consider the following run within a WordprocessingML document:
<w:r>
<w:rPr>
<w:b/>
<w:i/>
</w:rPr>
<w:t>quick</w:t>
</w:r>
The run specifies two formatting properties in its run contents: bold and italic. These properties are therefore applied to all content within this run. end example]
This element specifies whether the bold property shall be applied to all non-complex script characters in the contents of this run when displayed in a document.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then bold shall not be applied to non-complex script characters.
[Example: Consider a run of text which shall have the b property explicitly turned off for the non complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:b w:val="false"/>
</w:rPr>
This run explicitly declares that the b property is false for the non-complex script contents of this run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 the bold property shall be applied to all complex script characters in the contents of this run when displayed in a document.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then bold shall not be applied to complex script characters.
[Example: Consider a run of text which shall have the bCs property (bold) explicitly turned on for the complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:bCs w:val="true"/>
</w:rPr>
This run explicitly declares that the bCs property is true , so bold is turned on for the complex script contents of this run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 information about the border applied to the text in the current run.
The first piece of information specified by the bdr element is that the current shall have a border when displayed. This information is specified simply by the presence of the bdr element in run's properties.
The second piece of information concerns the set of runs which share the current run border. This is determined based on the attributes on the bdr element. If the set of attribute values specifies on two adjacent runs is identical, then those two runs shall be considered to be part of the same run border group and rendered within the same set of borders in the document.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then no run border shall be applied to the text in this run.
[Example: Consider a document in which the following two runs are located adjacent to one another:
<w:r>
<w:rPr>
<w:bdr w:val="single" w:sz="36" w:space="0" w:color="B8CCE4" w:themeColor="accent1" w:themeTint="66" />
</w:rPr>
<w:t xml:space="preserve">run one</w:t>
</w:r>
<w:r >
<w:rPr>
<w:b />
<w:bdr w:val="single" w:sz="36" w:space="0" w:color="B8CCE4" w:themeColor="accent1" w:themeTint="66" />
</w:rPr>
<w:t>run two</w:t>
</w:r>
These two runs, although each is distinct, are combined when rendering the text border because the bdr elements are identical between the two runs. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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.3.2.3-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.3-2) [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.3.2.3-3) 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.3.2.3-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.3-5) [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.3.2.3-6) 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 any lowercase characters in this text run shall be formatted for display only as their capital letter character equivalents. This property does not affect any non-alphabetic character in this run, and does not change the Unicode character for lowercase text, only the method in which it is displayed.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the characters are not formatted as capital letters.
This element shall not be present with the smallCaps (§2.3.2.31) property on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider the words Hello World, which shall be displayed in all capital letters in a document. This constraint is specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:caps w:val="true" />
</w:rPr>
<w:t>Hello World</w:t>
</w:r>
This run will display as HELLO WORLD, even though the lowercase characters are used in the run contents due to the use of the caps element. If this property is removed, the original character forms will be displayed (they are not lost). end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 color which shall be used to display the contents of this run in the document.
This color may be explicitly specified, or set to allow the consumer to automatically choose an appropriate color based on the background color behind the run's content.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the characters are set to allow the consumer to automatically choose an appropriate color based on the background color behind the run's content.
[Example: Consider a run of text which should be displayed using the accent3 theme color from the document's Theme part. This requirement would be specified as follows in the resulting WordprocessingML:
<w:rPr>
<w:color w:themeColor="accent3" />
</w:rPr>
The color attribute specifies that the run shall use the accent3 theme color. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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.3.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.3.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.3.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.3.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 whether the contents of this run shall be treated as complex script text regardless of their Unicode character values when determining the formatting for this run.
This means that a consumer shall use the complex script formatting applied to the run [Example: The bCs value (§2.3.2.2), not the b value (§2.3.2.1). end example] when determining the resulting formatting properties.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the run contents are set to complex script based on the Unicode character positions of the content.
[Example: Consider the following run of English text in a WordprocessingML document:
<w:r>
<w:rPr>
<w:bCs/>
<w:i/>
<w:cs/>
</w:rPr>
<w:t>some English text</w:t>
</w:r>
This run has bold applied to complex script characters, and italics applied to non-complex script characters. However, since the cs property is set, the text in this run shall be treated as complex script text when determining the resulting formatting. Therefore, the run will have bold formatting, but no italic formatting when displayed. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run shall be displayed with two horizontal lines through each character displayed on the line.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then double strikethrough shall not be applied to the contents of this run.
This element shall not be present with the strike (§2.3.2.35) property on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the dstrike property explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:dstrike w:val="true"/>
</w:rPr>
This run explicitly declares that the dstrike property is true, so the contents of this run will have two horizontal strikethrough lines. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 any East Asian typography settings which shall be applied to the contents of the run.
The specific typography settings represented by this element include the two lines in one and horizontal in vertical text options.
The two lines in one setting specifies that the characters in this run should be written out on a single line in the document by creating two sub-lines within the regular line, and laying out this text equally between those sub lines.
[Example: Consider a paragraph with the text two lines in one, which shall be displayed within a single logical line in the document. This constraint would be specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:eastAsianLayout w:id="1" w:combine="on" />
</w:rPr>
<w:t>two lines in one</w:t>
</w:r>
The resulting text would be displayed on two sub lines within the other text on this line, like this:
end example]
The horizontal in vertical setting specifies that characters in this run should be rendered with a 90 degree rotation to the left from all other contents of the line when displayed in the document, while keeping the text on the same line as all other text in the paragraph.
[Example: Consider a paragraph with the text this word is vertical, of which the word vertical shall be displayed vertically within the document. This constraint would be specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:eastAsianLayout w:id="2" w:vert="on" />
</w:rPr>
<w:t>vertical</w:t>
</w:r>
The resulting text would be displayed with a 90 degree rotation from the other text content. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
combine (Two Lines in One) |
Specifies whether the contents of the current run should be combined into one line using the two lines in one logic described above in the parent element. If this attribute is omitted, then this run shall not be displayed on two sub lines. [Example: Consider a paragraph with the text
The resulting text would be displayed on two sub lines within the other text on this line. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
combineBrackets (Display Brackets Around Two Lines in One) |
Specifies that the two lines in one text should be enclosed within a pair of brackets when displayed. This attribute's values determine the bracket style to put around combined text. If this attribute is not specified, then no brackets shall be placed around this content when displayed in the document. If the [Example: Consider a paragraph with the text
The resulting text would be displayed on two sub lines within the other text on this line and enclosed within curly brackets when displayed. end example] The possible values for this attribute are defined by the ST_CombineBrackets simple type (§2.18.13). |
|
id (East Asian Typography Run ID) |
Specifies a unique ID which shall b used to link multiple runs containing eastAsianLayout element to each other to ensure that their contents are correctly displayed in the document. This means that multiple runs which are broken apart due to differences in formatting can be identified as belonging to the same grouping in terms of eastAsianLayout properties, although they are separated into multiple runs of text. [Example: Consider the following three runs in a document:
Although there are three runs of content, all three regions shall be combined into a single two lines in one region based on the identical value used in the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
vert (Horizontal in Vertical (Rotate Text)) |
Specifies that characters in this run should be rendered with a 270 degree rotation to the left from all other contents of the line when displayed in the document as described above. If this attribute is omitted, then the contents of this run shall not be rotated with respect to the normal text flow. [Example: Consider a paragraph with the text
The resulting text would be displayed with a 270 degree rotation from the other text content. end example] The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
|
vertCompress (Compress Rotated Text to Line Height) |
Specifies whether the rotated text shall be compressed at display time in order to ensure that it fits into the existing line height without increasing the overall height of the line. If the [Example: Consider a paragraph with the text
The resulting text would be compressed in order to fit the height of the line as defined by all non-compressed characters. end example] 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_EastAsianLayout">
<attribute name="id" type="ST_DecimalNumber" use="optional"/>
<attribute name="combine" type="ST_OnOff" use="optional"/>
<attribute name="combineBrackets" type="ST_CombineBrackets" use="optional"/>
<attribute name="vert" type="ST_OnOff" use="optional"/>
<attribute name="vertCompress" type="ST_OnOff" use="optional"/>
</complexType>
This element specifies an animated text effect which should be displayed when rendering the contents of this run. This effect is rendered around the extents of the text in the run in the same location as a run border with zero pixels of padding would be rendered (if such a run border was present).
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then no text effect shall be applied to the contents of this run.
[Example: Consider a run of text which shall have an animated text effect consisting of multiple colored flashing lights (see possible attribute values for descriptions of each effect). This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:effect w:val="lights"/>
</w:rPr>
This run explicitly declares that the effect property is lights, so the contents of this run will have an animated lights text effect. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Animated Text Effect Type) |
Specifies the type of animated text effect which shall be applied to this text run. [Example: Consider a run of text which shall have an animated text effect consisting of multiple colored flashing lights. This constraint is specified using the following WordprocessingML:
This run explicitly declares a type of text effect, using the val property, of The possible values for this attribute are defined by the ST_TextEffect simple type (§2.18.101). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextEffect">
<attribute name="val" type="ST_TextEffect" use="required"/>
</complexType>
This element specifies the emphasis mark which shall be displayed for each non-space character in this run. An emphasis mark is an additional character that is rendered above or below the main character glyph as specified by the contents of the val attribute.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then no emphasis mark shall be added to each character in the contents of this run.
[Example: Consider a run of text which shall have a dot underneath each character as an emphasis mark. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:em w:val="dot"/>
</w:rPr>
This run explicitly declares that the emphasis mark type is dot, so the contents of this run will have a dot emphasis mark above each character. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Emphasis Mark Type) |
Specifies the emphasis mark type used for each character in this run. [Example: Consider a run of text which shall have a dot underneath each character as an emphasis mark. This constraint is specified using the following WordprocessingML:
This run explicitly declares that the em type is The possible values for this attribute are defined by the ST_Em simple type (§2.18.28). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Em">
<attribute name="val" type="ST_Em" use="required"/>
</complexType>
This element specifies that the contents of this run should be displayed as if embossed, which makes text appear as if it is raised off the page in relief.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then embossing shall not be applied to the contents of this run.
This element shall not be present with either the imprint (§2.3.2.16) or outline (§2.3.2.21) properties on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the emboss property explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:emboss w:val="true"/>
</w:rPr>
This run explicitly declares that the emboss property is true, so the contents of this run will appear embossed. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run shall not be automatically displayed based on the width of its contents, rather its contents shall be resized to fit the width specified by the val attribute. This expansion/contraction shall be performed by equally increasing/decreasing the size of each character in this run's contents when displayed.
If this element is omitted, then the contents of this run shall be displayed based on the size of its contents.
[Example: Consider a document with a run which shall be displayed in exactly one-half inch of space, regardless of its contents. This constraint would be specified using the following WordprocessingML:
<w:r>
<w:rPr>
<w:fitText w:id="50" w:val="720" />
</w:rPr>
<w:t>This text shall be displayed in one-half of an inch.</w:t>
</w:r>
The resulting run contents shall be displayed in exactly 720 twentieths of a point (one half of an inch) when displayed in a document. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
id (Fit Text Run ID) |
Specifies a unique ID which shall be used to link multiple contiguous runs containing fitText elements to each other to ensure that their contents are correctly merged into the specified width in the document. This means that multiple runs which are broken apart due to differences in formatting can be identified as belonging to the same grouping in terms of fitText properties, although they are multiple runs of text in the WordprocessingML. If the runs are not contiguous, then the If this attribute is omitted, then this run has no id and shall not be linked with any other run in the parent paragraph. [Example: Consider the following three runs in a document, which should be fit into exactly one inch at display time:
Although there are three runs of content, all three regions shall be combined into a single fit text region (e.g. they all fit into one inch, rather than one inch each) based on the identical value used in the The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
|
val (Value) |
This attribute specifies the exact width of space which this run shall be fit into when displayed in the document. [Example: Consider a document with a run which shall be displayed in exactly one-half inch of space, regardless of its contents. This constraint would be specified using the following WordprocessingML:
The resulting run contents shall be displayed in exactly The possible values for this attribute are defined by the ST_TwipsMeasure simple type (§2.18.105). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FitText">
<attribute name="val" type="ST_TwipsMeasure" use="required"/>
<attribute name="id" type="ST_DecimalNumber" use="optional"/>
</complexType>
This element specifies a highlighting color which is applied as a background behind the contents of this run.
If this run has any background shading specified using the shd element (§2.3.2.30), then the background shading shall be superseded by the highlighting color when the contents of this run are displayed.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then text highlighting shall not be applied to the contents of this run.
[Example: Consider a run within a paragraph which has run shading applied as well as yellow text highlighting using the highlight element. This formatting is specified using the following WordprocessingML:
<w:rPr>
<w:highlight w:val="yellow" />
<w:shd w:themeFill="accent2" w:themeFillTint="66" />
</w:rPr>
The resulting run would have yellow highlighting visible over its contents, as the highlighting supersedes the shading for the contents of the run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Highlighting Color) |
Specifies the color of the text highlighting which shall be applied to the contents of this run. [Example: Consider a text run which shall be displayed with colored text highlighting. This highlighting would be specified using the following WordprocessingML:
The resulting text highlighting would be red, as this is the color specified by the The possible values for this attribute are defined by the ST_HighlightColor simple type (§2.18.46). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Highlight">
<attribute name="val" type="ST_HighlightColor" use="required"/>
</complexType>
This element specifies whether the italic property should be applied to all non-complex script characters in the contents of this run when displayed in a document.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy .If this element is never applied in the style hierarchy, then italics shall not be applied to non-complex script characters.
[Example: Consider a run of text which shall have the i property explicitly turned on for the non-complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:i />
</w:rPr>
This run explicitly declares that the i property is true for the non-complex script contents of this run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 the italic property should be applied to all complex script characters in the contents of this run when displayed in a document.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then italics shall not be applied to complex script characters.
[Example: Consider a run of text which shall have the iCs property explicitly turned on for the complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:iCs w:val="true"/>
</w:rPr>
This run explicitly declares that the iCs property is true, so italics are turned on for the complex script contents of this run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run should be displayed as if imprinted, which makes text appear to be imprinted or pressed into page (also referred to as 'engrave').
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then imprinting shall not be applied to the contents of this run.
This element shall not be present with either the emboss (§2.3.2.11) or outline (§2.3.2.21) properties on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the imprint property explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:imprint w:val="true"/>
</w:rPr>
This run explicitly declares that the imprint property is true, so the contents of this run will appear imprinted. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 font kerning shall be applied to the contents of this run. If it is specified, then kerning shall be automatically adjusted when displaying characters in this run as needed.
The val attribute specifies the smallest font size which shall have its kerning automatically adjusted if this setting is specified. If the font size in the sz element (§2.3.2.36) is smaller than this value, then no font kerning shall be performed.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then font kerning shall not be applied to the contents of this run.
[Example: Consider the following WordprocessingML run which has font kerning properties specified:
<w:r>
<w:rPr>
<w:sz w:val="22" />
<w:kern w:val="28" />
</w:rPr>
</w:r>
Even though font kerning is turned on via the kern element, the contents of this run shall not be kerned because that settings only applied to font sizes of 14 points (28 half-points) or larger. If the kern element's val attribute was less than or equal to the sz element's val attribute, then kerning would be applied:
<w:r>
<w:rPr>
<w:sz w:val="22" />
<w:kern w:val="22" />
</w:rPr>
</w:r>
end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Half Point Measurement) |
Specifies a positive measurement specified in half-points (1/144 of an inch). The contents of this attribute value 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 value in the In each case, the value is interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_HpsMeasure simple type (§2.18.48). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_HpsMeasure">
<attribute name="val" type="ST_HpsMeasure" use="required"/>
</complexType>
This element specifies the languages which shall be used to check spelling and grammar (if requested) when processing the contents of this run.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the languages for the contents of this run shall be automatically determined based on their contents using any method desired.
[Example: Consider a run which contains both Latin and complex script characters in its contents. If those contents should be interpreted as French (Canada) and Hebrew, respectively, that requirement would be specified as follows in the resulting WordprocessingML:
<w:r>
<w:rPr>
<w:lang w:val="fr-CA" w:bidi="he-IL" />
</w:rPr>
</w:r>
The resulting run specifies that any complex script contents shall be spell and grammar checked as if they were Hebrew, and any Latin character contents shall be spell and grammar checked as if they were French (Canada). end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
bidi (Complex Script Language) |
Specifies the language which shall be used when processing the contents of this run which use complex script characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using complex script characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains complex script characters in its contents. If those contents should be interpreted as Hebrew, that requirement would be specified as follows in the resulting WordprocessingML:
The resulting run specifies that any complex script contents shall be spell and grammar checked using a Hebrew dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§2.18.51). |
|
eastAsia (East Asian Language) |
Specifies the language which shall be used when processing the contents of this run which use East Asian characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using East Asian characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains East Asian characters in its contents. If those contents should be interpreted as Korean, that requirement would be specified as follows in the resulting WordprocessingML:
The resulting run specifies that any complex script contents shall be spell and grammar checked using a Korean dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§2.18.51). |
|
val (Latin Language) |
Specifies the language which shall be used to check spelling and grammar (if requested) when processing the contents of this run which use Latin characters, as determined by the Unicode character values of the run content. If this attribute is omitted, then the languages for the contents of this run using Latin characters shall be automatically determined based on their contents using any appropriate method. [Example: Consider a run which contains Latin characters in its contents. If those contents should be interpreted as English (Canada), that requirement would be specified as follows in the resulting WordprocessingML:
The resulting run specifies that any complex script contents shall be spell and grammar checked using a English (Canada) dictionary and grammar engine, if one is available. end example] The possible values for this attribute are defined by the ST_Lang simple type (§2.18.51). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Language">
<attribute name="val" type="ST_Lang" use="optional"/>
<attribute name="eastAsia" type="ST_Lang" use="optional"/>
<attribute name="bidi" type="ST_Lang" use="optional"/>
</complexType>
This element specifies that the contents of this run shall not report any errors when the document is scanned for spelling and grammar. [Note: It is entirely at the consumer's/producer's discretion whether this is done by not checking the region for spelling and grammar, or simply by suppressing the results. end note]
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then spelling and grammar error shall not be suppressed on the contents of this run.
[Example: Consider a run of text which shall not ever have spelling or grammar errors reported for the contents of the run, for example, the XML fragments included in this Specification. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:noProof w:val="true"/>
</w:rPr>
This run explicitly declares that the noProof property is true, so the contents of this run will never report spelling or grammar errors. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 this run contains WordprocessingML which shall be handled as though it was Office Open XML Math.
[Rationale: Like other run properties may be applied to the glyph representing the paragraph mark, it is possible to create an Office Open XML Math equation on an empty paragraph as well. Since that paragraph mark must be defined by WordprocessingML, it is not possible to store the paragraph using the Office Open XML Math markup. Instead, this run property is stored on the paragraph mark's run properties to indicate that the paragraph mark is part of an Office Open XML Math equation. For example, the first paragraph below is stored as Office Open XML Math:
The paragraph must be a p (§2.3.1.22) element, but that would mean the data loss of the Math markup when saving as a WordprocessingML package. In order to prevent that data loss, this property stores the Math property as a run property. end rationale]
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then this run shall not be treated as Office Open XML Math.
This property may be applied to any run, but that should only introduce the semantic that the run is math in the user interface, and shall not change the appearance of the text.
[Example: Consider a paragraph in WordprocessingML where the paragraph mark glyph (the pilcrow mark - ¶) has been formatted as Math. Since this mark is not an actual run, it cannot be written out in the Office Open XML Math syntax, and must be written out as a property on the actual run as follows:
<w:pPr>
<w:rPr>
<w:oMath />
</w:rPr>
</w:pPr>
This property is therefore used to roundtrip the math setting on this paragraph mark character. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run should be displayed as if they have an outline, by drawing a one pixel wide border around the inside and outside borders of each character glyph in the run.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then outline shall not be applied to the contents of this run.
This element shall not be present with either the emboss (§2.3.2.11) or imprint (§2.3.2.16) properties on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the outline property explicitly turned off for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:outline w:val="false"/>
</w:rPr>
This run explicitly declares that the outline property is false, so the contents of this run will not appear as if they have an exterior outline around them. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 amount by which text shall be raised or lowered for this run in relation to the default baseline of the surrounding non-positioned text. This allows the text to be repositioned without altering the font size of the contents.
If the val attribute is positive, then the parent run shall be raised above the baseline of the surrounding text by the specified number of half-points. If the val attribute is negative, then the parent run shall be lowered below the baseline of the surrounding text by the specified number of half-points.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the text shall not be raised or lowered relative to the default baseline location for the contents of this run.
[Example: Consider a run which shall be positioned 12 points above the default baseline location when displaying its contents. This requirement would be specified using the following WordprocessingML:
<w:rPr>
<w:position w:val="24" />
</w:rPr>
The resulting run is positioned 24 half-points above the default baseline location because the contents of the val attribute are positive. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Signed Half-Point Measurement) |
Specifies a positive or negative measurement in half-points (1/144 of an inch). The contents of this attribute value are interpreted based on the context of the parent XML element. [Example: Consider the following WordprocessingML fragment:
In this case, the value in the In all cases, the value is interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_SignedHpsMeasure simple type (§2.18.87). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_SignedHpsMeasure">
<attribute name="val" type="ST_SignedHpsMeasure" use="required"/>
</complexType>
This element specifies a run of content in the parent field, hyperlink, custom XML element, structured document tag, smart tag, or paragraph.
The contents of a run in a WordprocessingML document shall consist of any combination of run content.
[Example: Consider a basic WordprocessingML paragraph with a pair of runs. This run would be expressed as follows:
<w:document>
<w:body>
<w:p>
<w:r>
<w:t>Text</w:t>
</w:r>
<w:fldSimple w:instr="AUTHOR">
<w:r>
<w:t>Author Name</w:t>
</w:r>
</w:fldSimple>
</w:p>
</w:body>
</w:document>
The r element is the container for all of the content in the run, which in this example includes both a run in the paragraph and a run within a simple field. end example]
|
Parent Elements |
|
customXml (§2.5.1.5); del (§2.13.5.12); fldSimple (§2.16.21); hyperlink (§2.16.24); ins (§2.13.5.20); moveFrom (§2.13.5.21); moveTo (§2.13.5.26); p (§2.3.1.22); rt (§2.3.3.23); rubyBase (§2.3.3.26); sdtContent (§2.5.2.35); smartTag (§2.5.1.9) |
|
Child Elements |
Subclause |
|---|---|
|
annotationRef (Comment Information Block) |
|
|
br (Break) |
|
|
commentReference (Comment Content Reference Mark) |
|
|
continuationSeparator (Continuation Separator Mark) |
|
|
cr (Carriage Return) |
|
|
dayLong (Date Block - Long Day Format) |
|
|
dayShort (Date Block - Short Day Format) |
|
|
delInstrText (Deleted Field Code) |
|
|
delText (Deleted Text) |
|
|
drawing (DrawingML Object) |
|
|
endnoteRef (Endnote Reference Mark) |
|
|
endnoteReference (Endnote Reference) |
|
|
fldChar (Complex Field Character) |
|
|
footnoteRef (Footnote Reference Mark) |
|
|
footnoteReference (Footnote Reference) |
|
|
instrText (Field Code) |
|
|
lastRenderedPageBreak (Position of Last Calculated Page Break) |
|
|
monthLong (Date Block - Long Month Format) |
|
|
monthShort (Date Block - Short Month Format) |
|
|
noBreakHyphen (Non Breaking Hyphen Character) |
|
|
object (Inline Embedded Object) |
|
|
pgNum (Page Number Block) |
|
|
pict (VML Object) |
|
|
ptab (Absolute Position Tab Character) |
|
|
rPr (Run Properties) |
|
|
ruby (Phonetic Guide) |
|
|
separator (Footnote/Endnote Separator Mark) |
|
|
softHyphen (Optional Hyphen Character) |
|
|
sym (Symbol Character) |
|
|
t (Text) |
|
|
tab (Tab Character) |
|
|
yearLong (Date Block - Long Year Format) |
|
|
yearShort (Date Block - Short Year Format) |
|
Attributes |
Description |
|---|---|
|
rsidDel (Revision Identifier for Run Deletion) |
Specifies a unique identifier used to track the editing session when the run was deleted from the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidR (Revision Identifier for Run) |
Specifies a unique identifier used to track the editing session when the run was added to the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
|
rsidRPr (Revision Identifier for Run Properties) |
Specifies a unique identifier used to track the editing session when the run properties were last modified in the main document. All A producer may choose to increment the revision save ID value to indicate subsequent editing sessions to indicate the order of the modifications relative to other modifications in this document. 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_R">
<sequence>
<group ref="EG_RPr" minOccurs="0"/>
<group ref="EG_RunInnerContent" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="rsidRPr" type="ST_LongHexNumber"/>
<attribute name="rsidDel" type="ST_LongHexNumber"/>
<attribute name="rsidR" type="ST_LongHexNumber"/>
</complexType>
This element specifies the fonts which shall be used to display the text contents of this run. Within a single run, there may be up to four types of content present which shall each be allowed to use a unique font:
The use of each of these fonts shall be determined by the Unicode character values of the run content, unless manually overridden via use of the cs element (§2.3.2.6).
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the text shall be displayed in any default font which supports each type of content.
[Example: Consider a single text run with both Arabic and English text, as follows:
English العربية
This content may be expressed in a single WordprocessingML run:
<w:r>
<w:t>English العربية</w:t>
</w:r>
Although it is in the same run, the contents are in different font faces by specifying a different font for ASCII and CS characters in the run:
<w:r>
<w:rPr>
<w:rFonts w:ascii="Courier New" w:cs="Times New Roman" />
</w:rPr>
<w:t>English العربية</w:t>
</w:r>
This text run shall therefore use the Courier New font for all characters in the ASCII range, and shall use the Times New Roman font for all characters in the Complex Script range. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
ascii (ASCII Font) |
Specifies a font which shall be used to format all characters in the ASCII range (0 - 127) within the parent run. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports ASCII content. [Example: Consider a run of ASCII text which shall be displayed using the Courier New font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
asciiTheme (ASCII Theme Font) |
Specifies a theme font which shall be used to format all characters in the ASCII range (0 - 127) within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the [Example: Consider a run of ASCII text which shall be displayed using the majorASCII theme font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_Theme simple type (§2.18.103). |
|
cs (Complex Script Font) |
Specifies a font which shall be used to format all characters in a complex script Unicode range within the parent run. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports complex script content. [Example: Consider a run of Arabic text which shall be displayed using the Arial Unicode MS font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
cstheme (Complex Script Theme Font) |
Specifies a theme font which shall be used to format all characters in a complex script Unicode range within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the [Example: Consider a run of Arabic text which shall be displayed using the majorBidi theme font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_Theme simple type (§2.18.103). |
|
eastAsia (East Asian Font) |
Specifies a font which shall be used to format all characters in an East Asian Unicode range within the parent run. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports East Asian content. [Example: Consider a run of Japanese text which shall be displayed using the MS Mincho font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
eastAsiaTheme (East Asian Theme Font) |
Specifies a theme font which shall be used to format all characters in an East Asian Unicode range within the parent run. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the [Example: Consider a run of Japanese text which shall be displayed using the minorEastAsia theme font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_Theme simple type (§2.18.103). |
|
hAnsi (High ANSI Font) |
Specifies a font which shall be used to format all characters in a Unicode range within the parent run which does not fall into one of the three categories defined above, which is called the high ANSI range in WordprocessingML. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in any default font which supports high ANSI content. [Example: Consider a run of text which falls into a high ANSI range, and shall be displayed using the Bauhaus 93 font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
|
hAnsiTheme (High ANSI Theme Font) |
Specifies a theme font which shall be used to format all characters in a Unicode range within the parent run which does not fall into one of the three categories defined above, which is called the high ANSI range in WordprocessingML. This theme font is a reference to one of the predefined theme fonts, located in the document's Theme part,which allows for font information to be set centrally in the document. If the If this attribute is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this attribute is never applied in the style hierarchy, then the text shall be displayed in the font specified by the [Example: Consider a run of text which falls into a high ANSI range, and shall be displayed using the minorHAnsi theme font. This requirement would be specified as follows in the resulting WordprocessingML:
The The possible values for this attribute are defined by the ST_Theme simple type (§2.18.103). |
|
hint (Font Content Type) |
Specifies the font type which shall be used to format any ambiguous characters in the current run. There are certain characters which are not explicitly stored in the document, and may be mapped into multiple categories of the four mentioned above. This attribute shall be used to arbitrate that conflict, and determine how ambiguities in this run shall be handled. [Note: This is primarily used to handle the formatting on the paragraph mark glyph, and other characters that are not stored as text in the WordprocessingML document. end note] If this attribute is omitted, then this ambiguity may be resolved by any means available. [Example: Consider the run representing the paragraph mark glyph, which is not stored as a physical character. Since this could therefore be formatted with any of the fonts specified for the run, this ambiguity is resolved using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Hint simple type (§2.18.47). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Fonts">
<attribute name="hint" type="ST_Hint"/>
<attribute name="ascii" type="ST_String"/>
<attribute name="hAnsi" type="ST_String"/>
<attribute name="eastAsia" type="ST_String"/>
<attribute name="cs" type="ST_String"/>
<attribute name="asciiTheme" type="ST_Theme"/>
<attribute name="hAnsiTheme" type="ST_Theme"/>
<attribute name="eastAsiaTheme" type="ST_Theme"/>
<attribute name="cstheme" type="ST_Theme"/>
</complexType>
This element specifies a set of run properties which shall be applied to the contents of the parent run after all style formatting has been applied to the text. These properties are defined as direct formatting, since they are directly applied to the run and supersede any formatting from styles.
This formatting is applied at the following location in the style hierarchy:
[Example: Consider a run which should have a set of run formatting properties. This set of properties is specified in the run properties as follows:
<w:r>
<w:rPr>
<w:b />
<w:imprint />
<w:lang w:val="en-ca" />
</w:rPr>
</w:r>
The rPr element specifies the properties which are applied to the current run - in this case, bold formatting on the run contents using the b element (§2.3.2.1), an imprinted (engraved) text effect using the imprint element (§2.3.2.16), and that this text should be interpreted as English (Canada) when spell or grammar checking the run text using the lang element (§2.3.2.18). end example]
|
Parent Elements |
|
Child Elements |
Subclause |
|---|---|
|
b (Bold) |
|
|
bCs (Complex Script Bold) |
|
|
bdr (Text Border) |
|
|
caps (Display All Characters As Capital Letters) |
|
|
color (Run Content Color) |
|
|
cs (Use Complex Script Formatting on Run) |
|
|
dstrike (Double Strikethrough) |
|
|
eastAsianLayout (East Asian Typography Settings) |
|
|
effect (Animated Text Effect) |
|
|
em (Emphasis Mark) |
|
|
emboss (Embossing) |
|
|
fitText (Manual Run Width) |
|
|
highlight (Text Highlighting) |
|
|
i (Italics) |
|
|
iCs (Complex Script Italics) |
|
|
imprint (Imprinting) |
|
|
kern (Font Kerning) |
|
|
lang (Languages for Run Content) |
|
|
noProof (Do Not Check Spelling or Grammar) |
|
|
oMath (Office Open XML Math) |
|
|
outline (Display Character Outline) |
|
|
position (Vertically Raised or Lowered Text) |
|
|
rFonts (Run Fonts) |
|
|
rPrChange (Revision Information for Run Properties) |
|
|
rStyle (Referenced Character Style) |
|
|
rtl (Right To Left Text) |
|
|
shadow (Shadow) |
|
|
shd (Run Shading) |
|
|
smallCaps (Small Caps) |
|
|
snapToGrid (Use Document Grid Settings For Inter-Character Spacing) |
|
|
spacing (Character Spacing Adjustment) |
|
|
specVanish (Paragraph Mark Is Always Hidden) |
|
|
strike (Single Strikethrough) |
|
|
sz (Font Size) |
|
|
szCs (Complex Script Font Size) |
|
|
u (Underline) |
|
|
vanish (Hidden Text) |
|
|
vertAlign (Subscript/Superscript Text) |
|
|
w (Expanded/Compressed Text) |
|
|
webHidden (Web Hidden Text) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_RPr">
<sequence>
<group ref="EG_RPrContent" minOccurs="0"/>
</sequence>
</complexType>
This element specifies a set of run properties which shall be attributed to a revision by a particular author and at a particular time. This element contains the set of properties which have been tracked as a specific set of revisions by one author.
[Example: Consider a run which has a set of run formatting properties that were added with revision tracking turned on. This set of revised properties is specified in the run properties as follows:
<w:r>
<w:rPr>
<w:b />
<w:imprint />
<w:lang w:val="en-ca" />
<w:rPrChange w:author="user1">
<w:rPr>
<w:i />
<w:dstrike w:val="false" />
</w:rPr>
</w:rPrChange>
</w:rPr>
</w:r>
The rPr element under rPrChange specifies the properties which were applied to the current run before revision tracking was turned on - in this case, italics using the i element (§2.3.2.14), and that any double strikethrough which was applied based on the style hierarchy shall be turned off using the dstrike element (§2.3.2.7). end example]
|
Parent Elements |
|
del (§2.13.5.15); ins (§2.13.5.17); rPrChange (§2.13.5.32) |
|
Child Elements |
Subclause |
|---|---|
|
b (Bold) |
|
|
bCs (Complex Script Bold) |
|
|
bdr (Text Border) |
|
|
caps (Display All Characters As Capital Letters) |
|
|
color (Run Content Color) |
|
|
cs (Use Complex Script Formatting on Run) |
|
|
dstrike (Double Strikethrough) |
|
|
eastAsianLayout (East Asian Typography Settings) |
|
|
effect (Animated Text Effect) |
|
|
em (Emphasis Mark) |
|
|
emboss (Embossing) |
|
|
fitText (Manual Run Width) |
|
|
highlight (Text Highlighting) |
|
|
i (Italics) |
|
|
iCs (Complex Script Italics) |
|
|
imprint (Imprinting) |
|
|
kern (Font Kerning) |
|
|
lang (Languages for Run Content) |
|
|
noProof (Do Not Check Spelling or Grammar) |
|
|
oMath (Office Open XML Math) |
|
|
outline (Display Character Outline) |
|
|
position (Vertically Raised or Lowered Text) |
|
|
rFonts (Run Fonts) |
|
|
rStyle (Referenced Character Style) |
|
|
rtl (Right To Left Text) |
|
|
shadow (Shadow) |
|
|
shd (Run Shading) |
|
|
smallCaps (Small Caps) |
|
|
snapToGrid (Use Document Grid Settings For Inter-Character Spacing) |
|
|
spacing (Character Spacing Adjustment) |
|
|
specVanish (Paragraph Mark Is Always Hidden) |
|
|
strike (Single Strikethrough) |
|
|
sz (Font Size) |
|
|
szCs (Complex Script Font Size) |
|
|
u (Underline) |
|
|
vanish (Hidden Text) |
|
|
vertAlign (Subscript/Superscript Text) |
|
|
w (Expanded/Compressed Text) |
|
|
webHidden (Web Hidden Text) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_RPrOriginal">
<sequence>
<group ref="EG_RPrBase" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
This element specifies the style ID of the character style which shall be used to format the contents of this paragraph.
This formatting is applied at the following location in the style hierarchy:
This means that all properties specified in the style element (§2.7.3.17) with a styleId which corresponds to the value in this element's val attribute are applied to the run at the appropriate level in the hierarchy.
If this element is omitted, or it references a style which does not exist, then no character style shall be applied to the current paragraph. As well, this property is ignored if the run properties are part of a character style.
[Example: Consider the following WordprocessingML fragment:
<w:rPr>
<w:pStyle w:val="TestCharacterStyle" />
<w:b />
<w:i />
</w:rPr>
This run specifies that it will inherit all of the run properties specified by the paragraph style with a styleId of TestCharacterStyle, which will then have any bold or italics settings overridden and set to be applied to the run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 alignment and reading order for this run shall be right to left. This setting determines the way in which the run contents are presented in the document when punctuation characters are part of the run's contents. When this property is specified, each part of the run between a punctuation mark shall be laid out right to left on the line.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then right to left alignment shall not be applied to the contents of this run.
[Example: Consider the following run of English text: This is a list: one, two, three. Typically, each region of text between a punctuation mark is presented in a left to right reading order in the document (as shown above). If the right to left property is set on this text, as follows:
<w:rPr>
<w:rtl v:val="on"/>
</w:rPr>
This run shall now have a right to left reading order, as follows:
.three ,two ,one :This is a list
In a right to left language, this would result in the correct placement of the punctuation with respect to each region of right to left text. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run shall be displayed as if each character has a shadow, displayed beneath the text and to its right.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then shadowing shall not be applied to the contents of this run.
This element shall not be present with either the emboss (§2.3.2.11) or imprint (§2.3.2.16) properties on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the shadow property explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:shadow w:val="true"/>
</w:rPr>
This run explicitly declares that the shadow property is true, so the contents of this run will appear with a shadow. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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>
Like paragraph shading, this element specifies the shading applied to the contents of the run.
This shading consists of three components:
The resulting shading is applied by setting the background color behind the paragraph, then applying the pattern color using the mask supplied by the pattern over that background.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then run shading shall not be applied to the contents of this run.
[Example: Consider a run which shall have a background consisting of a theme color accent6 with a theme color text2 overlaid using a 20% fill pattern. This requirement is specified using the following WordprocessingML:
<w:pPr>
<w:shd w:val="pct20" w:themeColor="text2" w:themeFill="accent6" />
</w:pPr>
The resulting run will use the background color accent6 under the foreground pattern color text2 as specified by the pct20 pattern mask. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
color (Shading Pattern Color) |
Specifies the color used for any foreground pattern specified for this shading using the This color may either be presented as a hex value (in RRGGBB format), or If the shading style (the If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider a shading of type pct20 with a foreground color value of auto, as follows:
The foreground color for this shading pattern therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the shading color 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). |
|
fill (Shading Background Color) |
Specifies the color used for the background for this shading. This color may either be presented as a hex value (in RRGGBB format), or If this attribute is omitted, then its value shall be assumed to be auto. [Example: Consider a shading using a background color of hex value C3D69B, using the following WordprocessingML:
The background color for this shading therefore will be a color with a hex value of C3D69B. end example] If the shading specifies the use of a theme color via the The possible values for this attribute are defined by the ST_HexColor simple type (§2.18.43). |
|
themeColor (Shading Pattern Theme Color) |
Specifies a theme color which should be applied to any foreground pattern specified for this shading using the The specified theme color is a reference to one of the predefined theme colors, located in the document's themes part, which allows for color information to be set centrally in the document. If this element is omitted, then no theme color is applied, and the [Example: Consider a paragraph which shall have a background consisting of a theme color accent3 with a theme color accent6 overlaid using a 20% fill pattern. This requirement is specified using the following WordprocessingML:
The resulting paragraph will use the foreground pattern color accent6 in the region specified by the pct20 pattern mask. end example] The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeFill (Shading Background Theme Color) |
Specifies a theme color which should be applied to the background for this shading. The specified theme color is a reference to one of the predefined theme colors, located in the document's themes part, which allows for color information to be set centrally in the document. If this element is omitted, then no theme color is applied, and the [Example: Consider a paragraph which shall have a background consisting of a theme color
The resulting shading will use the background color specified by the The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeFillShade (Shading Background Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this shading color. If the The [Example: Consider a shade of 40% applied to a background shading color in a document. This shade is calculated as follows: (missing picture formula-2.3.2.30-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.30-2) [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.3.2.30-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeFillTint (Shading Background Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this shading 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.3.2.30-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.30-5) [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.3.2.30-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeShade (Shading Pattern Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this shading color. If the The [Example: Consider a shade of 40% applied to a background shading color in a document. This shade is calculated as follows: (missing picture formula-2.3.2.30-7) Te resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.30-8) [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.3.2.30-9) 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 (Shading Pattern Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this shading 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.3.2.30-10) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.30-11) [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.3.2.30-12) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting shading's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Shading Pattern) |
Specifies the pattern which shall be used to lay the pattern color over the background color for this paragraph shading. This pattern consists of a mask which is applied over the background shading color to get the locations where the pattern color should be shown. Each of these possible masks are shown in the simple type values referenced below. [Example: Consider a shaded paragraph which uses a 10 percent foreground fill, resulting in the following WordprocessingML:
This shading The possible values for this attribute are defined by the ST_Shd simple type (§2.18.85). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Shd">
<attribute name="val" type="ST_Shd" 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="fill" type="ST_HexColor" use="optional"/>
<attribute name="themeFill" type="ST_ThemeColor" use="optional"/>
<attribute name="themeFillTint" type="ST_UcharHexNumber" use="optional"/>
<attribute name="themeFillShade" type="ST_UcharHexNumber" use="optional"/>
</complexType>
This element specifies that all small letter characters in this text run shall be formatted for display only as their capital letter character equivalents in a font size two points smaller than the actual font size specified for this text. This property does not affect any non-alphabetic character in this run, and does not change the Unicode character for lowercase text, only the method in which it is displayed. If this font cannot be made two point smaller than the current size, then it shall be displayed as the smallest possible font size in capital letters.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the characters are not formatted as capital letters.
This element shall not be present with the caps (§2.3.2.4) property on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider the words Hello World, which shall be displayed in small capital letters in a document. This constraint is specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:sz w:val="24" />
<w:smallCaps w:val="true" />
</w:rPr>
<w:t>Hello World</w:t>
</w:r>
This run will display using a 12 point capital letter for the capital letter H and W, and a 10 point capital letter for the lowercase letters in the run, even though the lowercase characters are used in actual run contents. If this property is removed, the original character forms will be displayed (they are not lost). end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 the current run should use the document grid characters per line settings defined in the docGrid element (§2.6.5) when laying out the contents in this run. This setting determines whether the additional character pitch specified in the document grid shall be added to each character in this run as specified by the document grid.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the run shall use the document grid setting to lay out text when a document grid is defined for the parent section.
[Example: Consider two runs in a section with a document grid set to allow 20 characters per line. This document grid would effectively specifies that an additional character pitch shall be added to each line in order to ensure that the resulting line contains only 20 East Asian characters.
If this property is set on the first run, but turned off on the second run, as follows:
<w:r>
<w:t>Run One</w:t>
</w:r>
<w:r>
<w:rPr>
<w:snapToGrid w:val="off" />
</w:rPr>
<w:t>Run Two</w:t>
</w:r>
The resulting document shall have the required additional character pitch added to each character in run one, but zero additional character pitch added to each character in run two, since the snapToGrid property is turned off. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 amount of character pitch which shall be added or removed after each character in this run before the following character is rendered in the document. This property has an effect equivalent to the additional character pitched added by a document grid applied to the contents of a run.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the run shall not have any additional character pitch applied to any character in its contents.
[Example: Consider a run of text which shall have ten points of additional character spacing explicitly added to each character within the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:spacing w:val="200"/>
</w:rPr>
This run explicitly declares that the spacing value is 200, so the contents of this run will appear as if they have 10 additional points of spacing added between them. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 that the given run shall always behave as if it is hidden, even when hidden text is being displayed in the current document.
This property shall only be used to specify that a paragraph mark shall never be used to break the end of a paragraph for display, even if it is being shown on the document, as would be the case if a regularly hidden paragraph was not being displayed in the document. [Note: This property was typically used to ensure that a paragraph style can be applied to a part of a paragraph, and still appear as in the Table of Contents (which in previous word processors would ignore the use of the style if it were being used as a character style. end note] If this element is applied to any other run, it may be ignored.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the run properties for the paragraph mark shall not always be treated as if hidden.
[Example: Consider a paragraph mark which never be used to break the end of the paragraph in the document. This constraint is specified using the following WordprocessingML:
<w:pPr>
<w:rPr>
<w:specVanish />
</w:rPr>
</w:pPr>
The presence of the specVanish element means that this paragraph mark shall always be treated as hidden (shall never be used to end the paragraph for display), but may be used to mark the end of use of a paragraph style. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 contents of this run shall be displayed with a single horizontal line through the center of the line.
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then strikethrough shall not be applied to the contents of this run.
This element shall not be present with the dstrike (§2.3.2.7) property on the same run, since they are mutually exclusive in terms of appearance.
[Example: Consider a run of text which shall have the strike property explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:strike w:val="true"/>
</w:rPr>
This run explicitly declares that the strike property is true, so the contents of this run will have a single horizontal strikethrough line. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 font size which shall be applied to all non complex script characters in the contents of this run when displayed.
If this element is not present, the default value is to leave the value applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then any appropriate font size may be used for non complex script characters.
[Example: Consider a run of text which shall have an explicit font size of 13.5 points for the non complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:sz w:val="27"/>
</w:rPr>
This run explicitly declares that the sz property is 27 half-point for the non-complex script contents of this run, so the text will be displayed in 13.5 point font size. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Half Point Measurement) |
Specifies a positive measurement specified in half-points (1/144 of an inch). The contents of this attribute value 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 value in the In each case, the value is interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_HpsMeasure simple type (§2.18.48). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_HpsMeasure">
<attribute name="val" type="ST_HpsMeasure" use="required"/>
</complexType>
This element specifies the font size which shall be applied to all complex script characters in the contents of this run when displayed.
If this element is not present, the default value is to leave the value applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then any appropriate font size may be used for complex script characters.
[Example: Consider a run of text which shall have an explicit font size of 10 points for the complex script contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:szCs w:val="20"/>
</w:rPr>
This run explicitly declares that the sz property is 20 half-point for the non-complex script contents of this run, so the text will be displayed in 10 point font size. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Half Point Measurement) |
Specifies a positive measurement specified in half-points (1/144 of an inch). The contents of this attribute value 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 value in the In each case, the value is interpreted in the context of the parent element. end example] The possible values for this attribute are defined by the ST_HpsMeasure simple type (§2.18.48). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_HpsMeasure">
<attribute name="val" type="ST_HpsMeasure" use="required"/>
</complexType>
This element specifies that the contents of this run should be displayed along with an underline appearing directly below the character height (less all spacing above and below the characters on the line).
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then an underline shall not be applied to the contents of this run.
[Example: Consider a run of text which shall have a double underline explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:u w:val="double"/>
</w:rPr>
This run explicitly declares an underline using the u property. The val of that underline is double, so the style of the underline on this run shall be a double line. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
color (Underline Color) |
Specifies the color for the underlining on this run. This color may either be presented as a hex value (in RRGGBB format), or If the underline 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 underline 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). |
|
themeColor (Underline Theme Color) |
Specifies a theme color which should be applied to the current underline. 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 an underlined run of text whose underline should be displayed using the
The The possible values for this attribute are defined by the ST_ThemeColor simple type (§2.18.104). |
|
themeShade (Underline Theme Color Shade) |
Specifies the shade value applied to the supplied theme color (if any) for this underline. If the The [Example: Consider a shade of 40% applied to a underline in a document. This shade is calculated as follows: (missing picture formula-2.3.2.38-1) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.38-2) [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.3.2.38-3) Taking the resulting HSL color value of and converting back to RGB, we get 943634. This transformed value can be seen in the resulting underline's
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
themeTint (Underline Theme Color Tint) |
Specifies the tint value applied to the supplied theme color (if any) for this underline's contents. If the The [Example: Consider a tint of 60% applied to an underline in a document. This tint is calculated as follows: (missing picture formula-2.3.2.38-4) The resulting Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:
(missing picture formula-2.3.2.38-5) [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.3.2.38-6) Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7. This transformed value can be seen in the resulting underline formatting's WordprocessingML
end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
|
val (Underline Style) |
Specifies the pattern which shall be used to create the underline applied beneath the text in this run. Each of these possible patterns are shown in the simple type referenced below. [Example: Consider a run of text which shall have a double underline explicitly turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Underline simple type (§2.18.107). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Underline">
<attribute name="val" type="ST_Underline" use="optional"/>
<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"/>
</complexType>
This element specifies whether the contents of this run shall be hidden from display at display time in a document. [Note: The setting should affect the normal display of text, but an application may have settings to force hidden text to be displayed. end note]
This formatting property is a toggle property, which specifies that its behavior differs between its use within a style definition and its use as direct formatting. When used as part of a style definition, setting this property shall toggle the current state of that property as specified up to this point in the hierarchy (i.e. applied to not applied, and vice versa). Setting it to false (or an equivalent) shall result in the current setting remaining unchanged. However, when used as direct formatting, setting this property to true or false shall set the absolute state of the resulting property.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy .If this element is never applied in the style hierarchy, then this text shall not be hidden when displayed in a document.
[Example: Consider a run of text which shall have the hidden text property turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:vanish />
</w:rPr>
This run declares that the vanish property is set for the contents of this run, so the contents of this run will be hidden when the document contents are displayed. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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 alignment which shall be applied to the contents of this run in relation to the default appearance of the run's text. This allows the text to be repositioned as subscript or superscript without altering the font size of the run properties.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the text shall not be subscript or superscript relative to the default baseline location for the contents of this run.
[Example: Consider a run which shall be positioning as superscript when displaying its contents. This requirement would be specified using the following WordprocessingML:
<w:rPr>
<w:vertAlign w:val="superscript" />
</w:rPr>
The resulting run is positioned as superscript, therefore it is rendered in a smaller size above the default baseline location for the contents of the run. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Subscript/Superscript Value) |
Specifies the type of vertical alignment applied to the contents of the current run. [Example: Consider a run which shall be positioning as superscript when displaying its contents. This requirement would be specified using the following WordprocessingML:
The value of the The possible values for this attribute are defined by the ST_VerticalAlignRun simple type (§2.18.110). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_VerticalAlignRun">
<attribute name="val" type="ST_VerticalAlignRun" use="required"/>
</complexType>
This element specifies the amount by which each character shall be expanded or when the character is rendered in the document. This property has an of stretching or compressing each character in the run, as opposed to the spacing element (§2.3.2.33) which expands/compresses the text by adding additional character pitch but not changing the width of the actual characters displayed on the line.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then the run shall be displayed at 100% of its normal width.
[Example: Consider a run of text which shall be expanded to 200% of its normal width when displaying each character within the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:w w:val="200"/>
</w:rPr>
This run explicitly declares that the w value is 200, so the contents of this run will appear at 200% of their normal character width by stretching the width of each character. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
Attributes |
Description |
|---|---|
|
val (Text Expansion/Compression Value) |
Specifies that the percentage by which the contents of this run shall be expanded or compressed with respect to its normal (100%) character width. If this attribute is omitted, then the contents of this run shall be displayed at 100% of its normal size. [Example: Consider a run of text which shall be compressed to 200% when displaying each character within the contents of the run. This constraint is specified using the following WordprocessingML:
This run explicitly declares that the w value is 50, so the contents of this run will appear at 50% of their normal character width by compressing the width of each character. end example] The possible values for this attribute are defined by the ST_TextScale simple type (§2.18.102). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TextScale">
<attribute name="val" type="ST_TextScale"/>
</complexType>
This element specifies whether the contents of this run shall be hidden from display at display time in a document when the document is being displayed in a web page view. [Note: The setting should affect the normal display of text in a web page view, but an application may have settings to force hidden text to be displayed. end note] As well, this setting should not affect a normal paginated view of the document.
If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy .If this element is never applied in the style hierarchy, then this text shall not be hidden when displayed in a document in a web page view.
[Example: Consider a run of text which shall have the hidden text property turned on for the contents of the run. This constraint is specified using the following WordprocessingML:
<w:rPr>
<w:webHidden />
</w:rPr>
This run declares that the webHidden property is set for the contents of this run, so the contents of this run will be hidden when the document contents are displayed in a web page view. end example]
|
Parent Elements |
|
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
|
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>