17.7.4.20 unhideWhenUsed

This element specifies whether the semiHidden property (17.7.4.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: Consider a style with a primary name of Test Paragraph Style that should not be displayed in the main user interface until it is used. This requirement would be specified using the following WordprocessingML:

<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. end example]

This element’s content model is defined by the common boolean property definition in 17.17.4.