[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
ins (Inserted Numbering Properties)
This element specifies that the numbering information defined by the parent element shall be treated as numbering information which was recorded as an insertion using revisions.
[Example: Consider two paragraphs in a WordprocessingML document, with the words one and two respectively, as follows:
If numbering is then applied to these two paragraphs, and this numbering is tracked as a revision, this revision is represented using the following WordprocessingML:
<w:p>
<w:pPr>
<w:numPr>
<w:ilvl w:val="0" />
<w:numId w:val="1" />
<w:ins w:id="0" w:author="Joe Smith" w:date="20050101T10:00:00Z" />
</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:ins w:id="0" w:author="Joe Smith" w:date="20050101T10:00:00Z" />
</w:numPr>
</w:pPr>
<w:r>
<w:t>two</w:t>
</w:r>
</w:p>
The ins element as a child of the numbering properties specifies that the paragraphs in this document have been given numbering properties by Joe Smith and that this change was marked as a revision. end example]
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.
[Example: Consider a comment represented using the following WordprocessingML fragment:
<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. end example]
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.
[Example: Consider a comment represented using the following WordprocessingML fragment:
<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. end example]
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.
[Example: Consider an annotation represented using the following WordprocessingML fragment:
<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. end example]
The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_TrackChange">
<complexContent>
<extension base="CT_Markup">
<attribute name="author" type="ST_String" use="required"/>
<attribute name="date" type="ST_DateTime" use="optional"/>
</extension>
</complexContent>
</complexType>