Share via


RevisionView Class

Visibility of Annotation Types.When the object is serialized out as xml, its qualified name is w:revisionView.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.RevisionView

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class RevisionView _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As RevisionView
public class RevisionView : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.69 revisionView (Visibility of Annotation Types)

This element specifies which forms of annotations shall be visible for a WordprocessingML document when it is displayed. This setting shall not affect whether annotations are added or persisted, it shall only affect the display of the annotations which exist in the document's contents (persisted or in memory).

If this element is omitted, then all forms of annotations shall be visible.

[Example: Consider the WordprocessingML below specifying that only formatting and ink annotations within a given WordprocessingML document must be displayed when the document is opened:

<w:revisionView w:markup="false" w:comments="false" w:insDel="false" />

The revisionView element specifies that the visibility of the markup region, comments and content additions/deletions must be suppressed by setting a value of false. Since the formatting and inkAnnotation attributes are omitted, they inherit the default of true and must be displayed. end example]

Parent Elements

settings (§17.15.1.78)

Attributes

Description

comments (Display Comments)

Specifies if comments should be included when the contents of this document are displayed.

If this attribute is omitted, then comments shall be displayed when annotations are visible based on application-level settings.

[Example: Consider the WordprocessingML below specifying that comments must be displayed:

<w:revisionView w:comments="true" />

The comments attribute has a value of true, specifying that comments must be rendered when the document's annotations are displayed. end example]

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

formatting (Display Formatting Revisions)

Specifies if revisions to properties (i.e. formatting revisions) should be included when the contents of this document are displayed.

If this attribute is omitted, then formatting revisions shall be displayed when annotations are visible based on application-level settings.

[Example: Consider the WordprocessingML below specifying that formatting revisions must be displayed:

<w:revisionView w:formatting="true" />

The formatting attribute has a value of true, specifying that formatting revisions must be rendered when the document's annotations are displayed. end example]

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

inkAnnotations (Display Ink Annotations)

Specifies if ink annotations should be included when the contents of this document are displayed.

If this attribute is omitted, then ink annotations shall be displayed when annotations are visible based on application-level settings.

[Example: Consider the WordprocessingML below specifying that ink annotations must be displayed:

<w:revisionView w:inkAnnotations="true" />

The inkAnnotations attribute has a value of true, specifying that ink annotations must be rendered when the document's annotations are displayed. end example]

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

insDel (Display Content Revisions)

Specifies if revisions to content (i.e. insertions, deletions, and moves) should be included when the contents of this document are displayed.

If this attribute is omitted, then insertions, deletions, and moves shall be displayed when annotations are visible based on application-level settings.

[Example: Consider the WordprocessingML below specifying that insertions, deletions, and moves must be displayed:

<w:revisionView w:insDel="true" />

The insDel attribute has a value of true, specifying that insertions, deletions, and moves must be rendered when the document's annotations are displayed. end example]

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

markup (Display Visual Indicator Of Markup Area)

Specifies if the application shall visually indicate any additional non-printing area used to display annotations when the annotations in this document are displayed.

If this attribute is omitted, then any additional non-printing area shall be indicated when they are visible based on application-level settings.

[Example: Consider the WordprocessingML below specifying that no visual indicator must be displayed for non-printing regions holding annotations:

<w:revisionView w:markup="false" />

The markup attribute has a value of false, specifying that nothing must be rendered indicating when a non-printing region is added when the document's annotations are displayed. end example]

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

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

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

RevisionView Members

DocumentFormat.OpenXml.Wordprocessing Namespace