<legacy> (Legacy Numbering Level Properties)

This element specifies that a given numbering level is from an earlier word processing application which did not support the full richness of the numbering properties supported by WordprocessingML.

These properties shall be used to render any numbered paragraph which references this numbering level if the @legacy attribute is set.
Note: : Using this element in generated WordprocessingML documents is not recommended, as updated numbering structures in WordprocessingML should be used in its place. This element is provided solely to save and roundtrip the numbering properties of legacy word processing products in WordprocessingML such that they are recreated if the document is resaved in an older word processor format.
example:
<w:lvl w:ilvl="0">
  ...
  <w:legacy w:legacySpace="820" w:legacyIndent="960" /> 
  <w:lvlJc w:val="left" /> 
  <w:pPr>
    <w:ind w:left="360" w:hanging="360" /> 
  </w:pPr>
</w:lvl>

This level has the legacy element present, therefore the legacy numbering level properties shall be used to format all paragraphs which reference this level. ]

Parent Elements

<lvl>2.9.6); <lvl>2.9.7)

Attributes

Description

<legacy> (Use Legacy Numbering Properties)

Specifies whether the legacy numbering properties present for this numbering level shall be used to format the numbering for any paragraph which references it.

A value of on, 1, or true for this attribute value specifies that the legacy numbering properties shall be applied. This is the default value for this attribute, and is implied when the attribute is omitted.

A value of off, 0, or false for this attribute value specifies that the legacy numbering properties shall not be used, and shall be explicitly turned off.

<w:legacy w:legacy="off" w:legacySpace="820" w:legacyIndent="960" /> 

This set of legacy properties are explicitly not used when processing the numbering level via the fact that the @legacy attribute is turned off for this example. ]

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

<legacyIndent> (Legacy Indent)

Specifies the indentation which shall be applied to a legacy numbering symbol from the text margin of the document. This value is specified in twentieths of a point.

If this attribute is not present, then no indentation shall be applied with respect to the margin.

<w:legacy w:legacySpace="820" w:legacyIndent="960" /> 

This set of legacy properties specify that there shall be exactly 960 twentieths of a point (⅔ of an inch) between the text margin and the start of the numbering on the paragraph. ]

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

<legacySpace> (Legacy Spacing)

Specifies the indentation which shall be applied between a legacy numbering symbol and the accompanying text of the associated paragraph in the document. This value is specified in twentieths of a point.

If this attribute is not present, then no indentation shall be applied with respect to the paragraph text.

<w:legacy w:legacySpace="820" w:legacyIndent="960" /> 

This set of legacy properties specify that there shall be exactly 860 twentieths of a point between the end of the numbering on the paragraph and the associated paragraph text. ]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_LvlLegacy">
	<attribute name="legacy" type="ST_OnOff" use="optional"/>
	<attribute name="legacySpace" type="ST_TwipsMeasure" use="optional"/>
	<attribute name="legacyIndent" type="ST_SignedTwipsMeasure" use="optional"/>
</complexType>