Enum ProtectionKind 

pub enum ProtectionKind {
    ReadOnly,
    Comments,
    TrackedChanges,
    Forms,
}

Which editing restrictions are enforced on a document (w:documentProtection/@w:edit, ST_DocProtect) once Document.protection is Some. ST_DocProtect’s "none" value isn’t modeled as its own variant — Document.protection: Option::None already expresses “no restriction”, same convention as Highlight’s "none"/ VerticalAlign’s "baseline"/UnderlineStyle’s "none" elsewhere in this crate.

Variants

ReadOnly

Edits are restricted to regions delimited by matching range permissions — in practice, with none declared (this crate doesn’t model range permissions), this means no editing at all.

Comments

Edits are restricted to inserting/deleting comments (plus the same range-permission carve-out as ReadOnly).

TrackedChanges

Edits are tracked as revisions, and applications shouldn’t allow turning tracking back off while this is enforced — per ECMA-376, this value “shall imply the presence of the trackRevisions element”, though this crate does not automatically set Document.track_changes when this variant is used (best-effort, not validated, same posture as Hyperlink::Internal’s anchor not being checked against a real bookmark).

Forms

Edits are restricted to form fields in sections marked as form-protected (this crate doesn’t model per-section formProt, so in practice this behaves like ReadOnly for any document it writes).

Implementations

impl ProtectionKind

pub fn attribute_value(self) -> &'static str

This kind’s w:edit attribute value (ST_DocProtect).

pub fn from_attribute_value(value: &str) -> Option<ProtectionKind>

Parses a w:edit attribute value (ST_DocProtect) into a ProtectionKind, or None for "none" or any unrecognized value — mirrors this crate’s usual forgiving-on-read policy.

Trait Implementations

impl Clone for ProtectionKind

fn clone(&self) -> ProtectionKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ProtectionKind

impl Debug for ProtectionKind

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for ProtectionKind

impl PartialEq for ProtectionKind

fn eq(&self, other: &ProtectionKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProtectionKind