2.2.9 Comments

  • Article

Comments are plain text annotations in a web drawing. Each comment has an associated author and drawing page.  It can have an associated shape on the drawing page. A collection of comments in a web drawing is specified by a Comments XML part.

A Comments_Type element in a Comments XML part contains the AuthorList_Type element and the CommentList_Type elements, which specifies the comment authors and comments respectively.

Each AuthorEntry_Type child of an AuthorList_Type parent element contains information for a single author. An author can be associated with one or more comments. The author is uniquely identified by the ID and ResolutionID attributes. Additional author information is provided by the Name and Initials attributes.

Each CommentEntry_Type child of a CommentList_Type parent element represents a single comment. The text runs associated with a comment are specified by the contents of a CommentEntry_Type element. The following attributes specify additional properties of the comment:

  • The AuthorID attribute specifies the author of a comment. This attribute is equal to the ID attribute of the AuthorEntry_Type element that corresponds to the author. 

  • The PageID attribute specifies the page a comment refers to. This attribute is equal to the ID attribute of a Page_Type element of the drawing page.

  • The ShapeID attribute can specify a shape on the drawing page that the comment refers to. When the ShapeID attribute exists, it is equal to the ID attribute of the ShapeSheet_Type element of the shape.