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 |