<vanish> (Hidden Text)

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.

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:
<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. ]

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.

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

The @val attribute explicitly declares that the property is turned off. ]

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>