<lsdException> (Latent Style Exception)

This element specifies the properties which shall be applied a single latent style for this document. refer to any set of known style definitions which have not been included in the current document.

example:

However, if the <documentProtection> element (§2.15.1.28) specifies that the hosting application shall prevent the use of any style whose <locked> element (§2.7.3.7) is set to false, then the locking state of all styles known to that application become useful and necessary to maintain the current state of the document. Using latent styles, this information may be stored without storing any formatting properties for those styles.

For example, if all styles which are not stored in the document shall be locked except for the style with a primary name (§2.7.3.9) of Heading 2. This requirement would be specified using latent styles as follows:

<w:latentStyles … w:defLockedState="true">
  <w:lsdException w:name="Heading 2" w:locked="false"/>
</w:latentStyles>

The <lsdException> element specifies that the latent style with a primary name of Heading 2 shall have a locked state setting of false. ]

Parent Elements

<latentStyles> (§2.7.3.5)

Attributes

Description

<locked> (Latent Style Locking Setting)

Specifies the default setting for the <locked> element (§2.7.3.7) which shall be applied to the latent style with the matching style @name value.

If this element is omitted, the default <locked> state for this latent style shall be determined by the @defLockedState attribute on the parent <latentStyles> element.

<w:latentStyles … w:defLockedState="true">
  <w:lsdException w:name="TestStyle" w:locked="false"/>
</w:latentStyles>

The @locked attribute on the latent style exception specifies that the TestStyle style shall have a <locked> element setting of false by default. ]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

<name> (Primary Style Name)

Specifies the primary name for the style which shall inherit this set of latent style property exceptions.

If the current application does not know of an internal primary style with the current name, then this set of latent style exceptions may be ignored.

<w:latentStyles … w:defLockedState="true">
  <w:lsdException w:name="TestStyle" w:locked="false"/>
</w:latentStyles>

The @name attribute on the latent style exception specifies that the TestStyle style shall have this set of latent style properties (if the application knows of a style with this name). ]

The possible values for this attribute are defined by the ST_String simple type (§2.18.89).

<qFormat> (Latent Style Primary Style Setting)

Specifies the default setting for the <qFormat> element (§2.7.3.14) which shall be applied to the latent style with the matching style @name value.

If this element is omitted, the default <qFormat> state for this latent style shall be determined by the @defQFormat attribute on the parent <latentStyles> element.

<w:latentStyles … w:defQFormat="false">
  <w:lsdException w:name="TestStyle" w:qFormat="true"/>
</w:latentStyles>

The @qFormat attribute on the latent style exception specifies that the TestStyle style shall have a <qFormat> element setting of true by default. ]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

<semiHidden> (Semi hidden text override)

Specifies the default setting for the <semiHidden> element (§2.7.3.16) which shall be applied to the latent style with the matching style @name value.

If this element is omitted, the default <semiHidden> state for this latent style shall be determined by the @defSemiHidden attribute on the parent <latentStyles> element.

<w:latentStyles … w:defSemiHidden="false">
  <w:lsdException w:name="TestStyle" w:semiHidden="true"/>
</w:latentStyles>

The @semiHidden attribute on the latent style exception specifies that the TestStyle style shall have a <semiHidden> element setting of true by default. ]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

<uiPriority> (Override default sorting order)

Specifies the default setting for the <uiPriority> element (§2.7.3.19) which shall be applied to the latent style with the matching style @name value.

If this element is omitted, the default <uiPriority> state for this latent style shall be determined by the @defUIPriority attribute on the parent <latentStyles> element.

<w:latentStyles … w:defUIPriority="10">
  <w:lsdException w:name="TestStyle" w:uiPriority="25"/>
</w:latentStyles>

The @uiPriority attribute on the latent style exception specifies that the TestStyle style shall have a <uiPriority> element setting of 25 by default. ]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16).

<unhideWhenUsed> (Unhide when used)

Specifies the default setting for the <unhideWhenUsed> element (§2.7.3.20) which shall be applied to the latent style with the matching style @name value.

If this element is omitted, the default <unhideWhenUsed> state for this latent style shall be determined by the @defUnhideWhenUsed attribute on the parent <latentStyles> element.

<w:latentStyles … w:defUnhideWhenUsed="true">
  <w:lsdException w:name="TestStyle" w:unhideWhenUsed="false"/>
</w:latentStyles>

The @unhideWhenUsed attribute on the latent style exception specifies that the TestStyle style shall have an <unhideWhenUsed> element setting of false by default. ]

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_LsdException">
	<attribute name="name" type="ST_String" use="required"/>
	<attribute name="locked" type="ST_OnOff"/>
	<attribute name="uiPriority" type="ST_DecimalNumber"/>
	<attribute name="semiHidden" type="ST_OnOff"/>
	<attribute name="unhideWhenUsed" type="ST_OnOff"/>
	<attribute name="qFormat" type="ST_OnOff"/>
</complexType>