<unhideWhenUsed> (Remove Semi-Hidden Property When Style Is Used)

This element specifies whether the <semiHidden> property (§2.7.3.16) shall be removed when this style is used by the content of the document. If this element is set, then an application shall ensure that even if the <semiHidden> element is specified on a style, that this property is removed when the document is resaved if the style is referenced by any content in the document.

If this element is omitted, then the style shall not automatically lose the semi-hidden property when it is used in the document contents.

example: 
<w:style … w:styleId="TestStyle">
  <w:name w:val="Test Paragraph Style"/>
  <w:semiHidden/>
  <w:unhideWhenUsed/>
  …
</w:style>

The <unhideWhenUsed> element specifies that this style definition should not be displayed in any main user interface associated with an application which processes this document until it is referenced by document content. If a paragraph was added to the document which referenced this style:

<w:p>
  <w:pPr>
    <w:pStyle w:val="TestStyle"/>
  </w:pPr>
  …
</w:p>

This style is now referenced by the document's contents and would have the <semiHidden> element removed on save. ]

Parent Elements

<style> (§2.7.3.17)

Attributes

Description

<val> (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

<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>