[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

ST_DocProtect (Document Protection Types)

This simple type specifies the possible set of editing restrictions which may be enforced on a given WordprocessingML document.

[Example: Consider a WordprocessingML document that contains the following WordprocessingML specifying that hosting applications shall enforce read-only protection for a given document:

<w:documentProtection w:edit="readOnly" w:enforcement="1" />

The edit attribute has a value of readOnly and an enforcement attribute with a value of 1, specifying that read-only document protection shall be enforced on the given document. end example]

This simple type's contents are a restriction of the XML Schema string datatype.

The following are possible enumeration values for this type:

Enumeration Value

Description

comments (Allow Editing of Comments)

Specifies that the edits made to this document shall be restricted to:

• The insertion and deletion of comments within the document

• The editing of regions delimited by range permissions which match the editing rights of the user account which is performing the editing.

forms (Allow Editing of Form Fields)

Specifies that the edits made to this document shall be restricted to:

• The editing of form fields in sections where the formProt element (§2.6.6) has a value of true.

• No restrictions in sections where the formProt element has a value of false.

none (No Editing Restrictions)

Specifies that no editing restrictions have been applied to the document.

readOnly (Allow No Editing)

Specifies that the edits made to this document shall be restricted to:

• The editing of regions delimited by range permissions which match the editing rights of the user account which is performing the editing.

trackedChanges (Allow Editing With Revision Tracking)

Specifies that the edits made to this document shall be tracked as revisions. This value shall imply the presence of the trackRevisions element (§2.15.1.90), and applications shall not allow that element's state to be changed to false.

 

Referenced By

documentProtection@edit (§2.15.1.28)

The following XML Schema fragment defines the contents of this simple type:

<simpleType name="ST_DocProtect">

   <restriction base="xsd:string">

   <enumeration value="none"/>

   <enumeration value="readOnly"/>

   <enumeration value="comments"/>

   <enumeration value="trackedChanges"/>

   <enumeration value="forms"/>

   </restriction>

</simpleType>