<numberingChange> (Previous Paragraph Numbering Properties)

This element specifies the previous state of the numbering on a paragraph when revisions are being tracked.

[: This mechanism is simply used to provide storage for revisions to numbering produced by legacy word processing applications, and applications are encouraged to use the <pPrChange> element to store these changes as changes to the paragraph properties instead. ]

example:

Consider a revision where the numbering definition is changed from Arabic numerals to Roman numerals, as follows:

This revision to the numbering definition would be stored as follows in the WordprocessingML:

<w:p>
	<w:pPr>
	<w:numPr>
	<w:ilvl w:val="0" />
	<w:numId w:val="1" />
	<w:numberingChange w:id="0" … w:original="%1:1:0:." />
	</w:numPr>
	</w:pPr>
	<w:r>
	<w:t>one</w:t>
	</w:r>
</w:p>
<w:p>
	<w:pPr>
	<w:numPr>
	<w:ilvl w:val="0" />
	<w:numId w:val="1" />
	<w:numberingChange w:id="1" … w:original="%1:2:0:." />
	</w:numPr>
	</w:pPr>
	<w:r>
	<w:t>two</w:t>
	</w:r>
</w:p>
<w:p>
	<w:pPr>
	<w:numPr>
	<w:ilvl w:val="0" />
	<w:numId w:val="1" />
	<w:numberingChange w:id="2" … w:original="%1:3:0:." />
	</w:numPr>
	</w:pPr>
	<w:r>
	<w:t>three</w:t>
	</w:r>
</w:p>

The <numberingChange> element specifies that the numbering definition was modified and this change was tracked as a revision. The previous Arabic numeral numbering definition is cached in the @original attribute. ]

For paragraph numbering, the @original attribute shall specify the previous numbering definition for an individual paragraph of text within a WordprocessingML document while revisions are being tracked.

The value of @original is represented as separate numbering level definitions defined as follows:

<%[numbering level]:[nfc value]:[numbering format]:[separator]>[repeat if more than one level]

where

  • numbering level – The level for which the numbering definition is defined

  • nfc value – The value of the numbering style at the specific numbering level

  • numbering format – The nfc value of the numbering format, as referenced in the table below.

  • separator – The separator used to separate the numbering level definitions

The numbering format values are mapped as follows:

nfc Value

ST_NumberFormat enumeration equivalent

0

decimal

1

upperRoman

2

lowerRoman

3

upperLetter

4

lowerLetter

5

ordinal

6

cardinalText

7

ordinalText

8

hex

9

chicago

10

ideographDigital

11

japaneseCounting

12

Aiueo

13

Iroha

14

decimalFullWidth

15

decimalHalfWidth

16

japaneseLegal

17

japaneseDigitalTenThousand

18

decimalEnclosedCircle

19

decimalFullWidth2

20

aiueoFullWidth

21

irohaFullWidth

22

decimalZero

23

bullet

24

ganada

25

chosung

26

decimalEnclosedFullstop

27

decimalEnclosedParen

28

decimalEnclosedCircleChinese

29

ideographEnclosedCircle

30

ideographTraditional

31

ideographZodiac

32

ideographZodiacTraditional

33

taiwaneseCounting

34

ideographLegalTraditional

35

taiwaneseCountingThousand

36

taiwaneseDigital

37

chineseCounting

38

chineseLegalSimplified

39

chineseCountingThousand

40

Application-defined. May be ignored.

41

koreanDigital

42

koreanCounting

43

koreanLegal

44

koreanDigital2

45

hebrew1

46

arabicAlpha

47

hebrew2

48

arabicAbjad

49

hindiVowels

50

hindiConsonants

51

hindiNumbers

52

hindiCounting

53

thaiLetters

54

thaiNumbers

55

thaiCounting

56

vietnameseCounting

57

numberInDash

58

russianLower

59

russianUpper

60 or above

Application-defined. May be ignored.
example:

This revision to the numbered paragraph would be stored as follows in the WordprocessingML:

<w:numPr>
  …
  <w:numberingChange … w:original="%1:1:0:.%2:1:2:.%3:1:0:." />
</w:numPr>

In the above example there are three levels in the original numbering definition, thus three numbering level definitions are needed to represent the original numbering definition.

The first level is specified by %1, and says that it was number value 1 in the nfc format 0 (arabic).

The @original attribute specifies that the previous numbering definition was made up of three levels whose value was 1.i.1.. ]

Parent Elements

<numPr> (§2.3.1.19)

Attributes

Description

<author> (Annotation Author)

Specifies the author for an annotation within a WordprocessingML document.

If this attribute is omitted, then no author shall be associated with the parent annotation type.

<w:… w:id="1" w:author="Example Author">
  …
</w:…>

The <author> attribute specifies that the author of the current annotation is Example Author, which may be used as desired. ]

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

<date> (Annotation Date)

Specifies the date information for an annotation within a WordprocessingML document. The use of this information is outside of the scope of this Office Open XML Standard.

If this attribute is omitted, then no date information shall be associated with the parent annotation type.

<w:… w:id="1" w:date="2006-01-01T10:00:00">
  …
</w:…>

The <date> attribute specifies that the date of the current annotation is January 1st 2006 at 10:00 AM, which may be used as desired. ]

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

<id> (Annotation Identifier)

Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the @id attribute, if any, are defined by the parent XML element.

If this attribute is omitted, then the document is non-conformant.

<w:… w:id="1" … >
  …
</w:…>

The <id> attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. ]

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

<original> (Previous Numbering Value)

Specifies the previous numbering displayed by the parent numbering change revision. Its format is specified by the parent element.

If this attribute is omitted, then no previous numbering value is implied and applications may choose to calculate this value, or display no previous numbering value.

This revision to the field result would be stored as follows in the WordprocessingML:

<w:fldChar w:type="begin">
  <w:numberingChange w:id="0" … w:original="1." />
</w:fldChar>

The @original attribute specifies that the previous numbering value of the field was 1. ]

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

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

<complexType name="CT_TrackChangeNumbering">
	<complexContent>
	<extension base="CT_TrackChange">
	<attribute name="original" type="ST_String" use="optional"/>
	</extension>
	</complexContent>
</complexType>