17.13.5.32 sectPrChange

This element specifies the details about a single revision to a set of section properties in a WordprocessingML document.

This element stores this revision as follows:

• The child element of this element contains the complete set of section properties which were applied to
• the parent section before this revision
• The attributes of this element contain information about when this revision took place (i.e. when these
• properties became a ‘former’ set of section properties).

[Example: Consider a section in a WordprocessingML document which is set to be divided into three columns, and this change in the section properties is tracked as a revision. This revision would be specified using the following WordprocessingML markup:

<w:sectPr>
  <w:cols w:num="3" … >
    …
  </w:cols>
  <w:sectPrChange w:id="0" w:date="01-01-2006T12:00:00" w:author="John Doe">
    <w:sectPr/>
  </w:sectPrChange>
</w:sectPr>

The sectPrChange element specifies that there was a revision to the section properties at 01-01-2006 by John Doe, and the previous set of properties on the section were the null set (i.e. no section properties explicitly present under the sectPr element). end example]

Attributes

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 ISO/IEC 29500.

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:id="1" w:date="2006-01-01T10:00:00">
    …
  </…>

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

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

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:id="1" w:author="Example Author">
    …
  </…>

The author attribute specifies that the author of the current annotation is Example

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

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:id="1" … >
    …
  </…>

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 (17.18.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_SectPrChange) is located in A.1. end note]