Struct ExtendedProperties 

pub struct ExtendedProperties {
    pub company: Option<String>,
    pub manager: Option<String>,
}

This document’s extended properties (docProps/app.xml, CT_Properties — confirmed via ECMA-376’s own schema fragment to be an xsd:all group, same “no fixed order” shape as CT_CoreProperties). Only Company/Manager are modeled here: the two fields a user actually edits (shown right next to Title/Author/Category in Word’s own Summary tab, alongside the docProps/core.xml fields already modeled by DocumentProperties). CT_Properties has many more children (Words, Pages, Characters, Lines, Paragraphs, TotalTime, Application, AppVersion, DocSecurity, ScaleCrop, LinksUpToDate..) — these are statistics/environment fields Word itself computes when it saves a document, not meaningful for a generation library to set by hand, so they’re deliberately left out (this crate’s writer.rs still always sets Application to identify itself as the producer, same as before this struct existed, but that value isn’t exposed as a settable field here).

Fields

company: Option<String>

The document’s associated company/organization (Company).

manager: Option<String>

The document’s manager (Manager).

Implementations

impl ExtendedProperties

pub fn new() -> ExtendedProperties

Creates an empty set of extended properties (every field None).

Examples found in repository

examples/docx_metadata_and_protection.rs (line 25)

fn main() -> office_toolkit::Result<()> {
    let properties = DocumentProperties::new()
        .with_title("Quarterly Report")
        .with_subject("Q3 results")
        .with_creator("Jane Doe")
        .with_keywords("finance, quarterly, report")
        .with_description("An example document showing document properties.")
        .with_category("Finance")
        .with_content_status("Draft");
    let extended_properties = ExtendedProperties::new()
        .with_company("Acme Corp.")
        .with_manager("Jane Manager");

    let metadata_document = Document::new()
        .with_properties(properties)
        .with_extended_properties(extended_properties)
        .with_custom_property("ProjectCode", CustomPropertyValue::Text("Q3-2026".to_string()))
        .with_custom_property("Budget", CustomPropertyValue::Number(125_000.0))
        .with_custom_property("Approved", CustomPropertyValue::Bool(false))
        .with_custom_property("RevisionCount", CustomPropertyValue::Int(3))
        .with_track_changes(true)
        .with_paragraph(Paragraph::with_text(
            "This document carries standard properties (title/author/subject/...), four custom properties, \
             and has track changes turned on — check File > Info in Word to see them.",
        ));
    let metadata_path = output_path("docx_metadata.docx");
    metadata_document.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    let protected_document = Document::new()
        .with_protection(ProtectionKind::ReadOnly)
        .with_paragraph(Paragraph::with_text(
            "This document is protected as read-only — Word will ask for a password before allowing edits.",
        ));
    let protected_path = output_path("docx_protected.docx");
    protected_document.save_to_file(&protected_path)?;
    println!("Wrote {}", protected_path.display());

    Ok(())
}

pub fn with_company(self, company: impl Into<String>) -> ExtendedProperties

Sets the document’s company and returns it for chaining.

Examples found in repository

examples/docx_metadata_and_protection.rs (line 26)

fn main() -> office_toolkit::Result<()> {
    let properties = DocumentProperties::new()
        .with_title("Quarterly Report")
        .with_subject("Q3 results")
        .with_creator("Jane Doe")
        .with_keywords("finance, quarterly, report")
        .with_description("An example document showing document properties.")
        .with_category("Finance")
        .with_content_status("Draft");
    let extended_properties = ExtendedProperties::new()
        .with_company("Acme Corp.")
        .with_manager("Jane Manager");

    let metadata_document = Document::new()
        .with_properties(properties)
        .with_extended_properties(extended_properties)
        .with_custom_property("ProjectCode", CustomPropertyValue::Text("Q3-2026".to_string()))
        .with_custom_property("Budget", CustomPropertyValue::Number(125_000.0))
        .with_custom_property("Approved", CustomPropertyValue::Bool(false))
        .with_custom_property("RevisionCount", CustomPropertyValue::Int(3))
        .with_track_changes(true)
        .with_paragraph(Paragraph::with_text(
            "This document carries standard properties (title/author/subject/...), four custom properties, \
             and has track changes turned on — check File > Info in Word to see them.",
        ));
    let metadata_path = output_path("docx_metadata.docx");
    metadata_document.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    let protected_document = Document::new()
        .with_protection(ProtectionKind::ReadOnly)
        .with_paragraph(Paragraph::with_text(
            "This document is protected as read-only — Word will ask for a password before allowing edits.",
        ));
    let protected_path = output_path("docx_protected.docx");
    protected_document.save_to_file(&protected_path)?;
    println!("Wrote {}", protected_path.display());

    Ok(())
}

pub fn with_manager(self, manager: impl Into<String>) -> ExtendedProperties

Sets the document’s manager and returns it for chaining.

Examples found in repository

examples/docx_metadata_and_protection.rs (line 27)

fn main() -> office_toolkit::Result<()> {
    let properties = DocumentProperties::new()
        .with_title("Quarterly Report")
        .with_subject("Q3 results")
        .with_creator("Jane Doe")
        .with_keywords("finance, quarterly, report")
        .with_description("An example document showing document properties.")
        .with_category("Finance")
        .with_content_status("Draft");
    let extended_properties = ExtendedProperties::new()
        .with_company("Acme Corp.")
        .with_manager("Jane Manager");

    let metadata_document = Document::new()
        .with_properties(properties)
        .with_extended_properties(extended_properties)
        .with_custom_property("ProjectCode", CustomPropertyValue::Text("Q3-2026".to_string()))
        .with_custom_property("Budget", CustomPropertyValue::Number(125_000.0))
        .with_custom_property("Approved", CustomPropertyValue::Bool(false))
        .with_custom_property("RevisionCount", CustomPropertyValue::Int(3))
        .with_track_changes(true)
        .with_paragraph(Paragraph::with_text(
            "This document carries standard properties (title/author/subject/...), four custom properties, \
             and has track changes turned on — check File > Info in Word to see them.",
        ));
    let metadata_path = output_path("docx_metadata.docx");
    metadata_document.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    let protected_document = Document::new()
        .with_protection(ProtectionKind::ReadOnly)
        .with_paragraph(Paragraph::with_text(
            "This document is protected as read-only — Word will ask for a password before allowing edits.",
        ));
    let protected_path = output_path("docx_protected.docx");
    protected_document.save_to_file(&protected_path)?;
    println!("Wrote {}", protected_path.display());

    Ok(())
}

Trait Implementations

impl Clone for ExtendedProperties

fn clone(&self) -> ExtendedProperties

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtendedProperties

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

Formats the value using the given formatter.

impl Default for ExtendedProperties

fn default() -> ExtendedProperties

Returns the “default value” for a type.

impl Eq for ExtendedProperties

impl PartialEq for ExtendedProperties

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ExtendedProperties