Struct ColorScheme 

pub struct ColorScheme {
    pub dark1: String,
    pub light1: String,
    pub dark2: String,
    pub light2: String,
    pub accent1: String,
    pub accent2: String,
    pub accent3: String,
    pub accent4: String,
    pub accent5: String,
    pub accent6: String,
    pub hyperlink: String,
    pub followed_hyperlink: String,
}

A theme’s 12-color palette (<a:clrScheme>, CT_ColorScheme): two dark/ light pairs, six accents, and two hyperlink colors — the palette behind Word’s “Theme Colors” swatches and w:themeColor-based direct formatting (CT_Color’s theme-color choice, not modeled on Run/ Style itself, which only ever carry literal RGB colors).

Every slot is stored as a plain 6-digit RGB hex string (no leading #, e.g. "4F81BD"), written as <a:srgbClr val="..">. CT_Color’s other choice, <a:sysClr> (binding a slot to a live Windows system color, with a fallback RGB for non-Windows renderers) — what Word’s own default theme actually uses for dk1/lt1 (bound to windowText/window) — is not modeled for writing; a plain srgbClr is schema-valid in its place and renders identically outside of that live system-color binding, which this crate has no way to honor anyway (a document it writes isn’t tied to any running Windows session). Reading back a real, externally-authored theme that does use <a:sysClr> for a slot still works: its fallback RGB (lastClr) is captured instead of the live binding, which is lost on a round trip — see reader.rs.

Fields

dark1: String

light1: String

dark2: String

light2: String

accent1: String

accent2: String

accent3: String

accent4: String

accent5: String

accent6: String

hyperlink: String

followed_hyperlink: String

Implementations

impl ColorScheme

pub fn new( dark1: impl Into<String>, light1: impl Into<String>, dark2: impl Into<String>, light2: impl Into<String>, accent1: impl Into<String>, accent2: impl Into<String>, accent3: impl Into<String>, accent4: impl Into<String>, accent5: impl Into<String>, accent6: impl Into<String>, hyperlink: impl Into<String>, followed_hyperlink: impl Into<String>, ) -> ColorScheme

Creates a color scheme from its 12 slots, each a 6-digit RGB hex string (no leading #).

Examples found in repository

examples/docx_theme.rs (lines 27-30)

fn main() -> office_toolkit::Result<()> {
    let default_theme_document = Document::new()
        .with_theme(Theme::office_default())
        .with_paragraph(Paragraph::with_text("Office's built-in default theme."))
        .with_paragraph(Paragraph::with_text(
            "Cambria for headings, Calibri for body text, the classic Office palette.",
        ));
    let default_path = output_path("docx_theme_default.docx");
    default_theme_document.save_to_file(&default_path)?;
    println!("Wrote {}", default_path.display());

    // A custom, branded theme: a dark navy/orange palette and a different
    // heading/body font pairing.
    let custom_colors = ColorScheme::new(
        "1B1B1B", "FFFFFF", "0A2540", "F5F5F5", "0A2540", "E8622C", "2E86AB", "6FB98F", "F4A259",
        "8E4585", "1155CC", "6B3FA0",
    );
    let custom_fonts = FontScheme::new("Georgia", "Verdana");
    let custom_theme_document = Document::new()
        .with_theme(Theme::new("Custom Brand", custom_colors, custom_fonts))
        .with_paragraph(Paragraph::with_text("A custom, branded theme."))
        .with_paragraph(Paragraph::with_text(
            "Georgia for headings, Verdana for body text, a navy/orange palette.",
        ));
    let custom_path = output_path("docx_theme_custom.docx");
    custom_theme_document.save_to_file(&custom_path)?;
    println!("Wrote {}", custom_path.display());

    Ok(())
}

pub fn office_default() -> ColorScheme

Office’s own built-in default 12-color palette (the classic “Office” theme colors: dk1/lt1 as plain black/white rather than Word’s own live sysClr binding — see ColorScheme’s doc comment).

Trait Implementations

impl Clone for ColorScheme

fn clone(&self) -> ColorScheme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorScheme

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

Formats the value using the given formatter.

impl Eq for ColorScheme

impl PartialEq for ColorScheme

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ColorScheme