cs (Use Complex Script Formatting on Run)

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:

<w:… w:val="off"/>

The val attribute explicitly declares that the property is turned off. 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>