Struct EmbeddedChart 

pub struct EmbeddedChart {
    pub chart_space: ChartSpace,
    pub width_emu: i64,
    pub height_emu: i64,
    pub name: String,
}

An inline chart (<w:drawing><wp:inline>..), embedded in a run — RunContent::Chart’s payload. Structurally the same wp:inline skeleton as Image (wp:extent/wp:docPr, wrapping an a:graphic/a:graphicData), but the a:graphicData wraps a <c:chart r:id=".."> graphic frame instead of a pic:pic (see writer.rs::write_embedded_chart) — its own graphic-frame wiring rather than a picture’s, even though both live under wp:inline on the Word side.

A deliberate scope decision, since chart-in-document support is still an evolving corner of the format: cached values only, no embedded .xlsx workbook as a data source. This crate’s chart::ChartSpace already carries every series’ cached values directly (chart::NumericDataSource/StringDataSource), so a Word chart embedded this way renders correctly in Word without any companion workbook part — it just can’t be “edited” via Word’s “Edit Data in Excel” feature the way a real Word-native chart (created through Word’s own UI) can.

Fields

chart_space: ChartSpace

width_emu: i64

The width the chart is displayed at, in EMUs (wp:extent’s cx).

height_emu: i64

The height the chart is displayed at, in EMUs (cy).

name: String

Alt text / description (wp:docPr’s descr/name attributes). May be empty.

Implementations

impl EmbeddedChart

pub fn new( chart_space: ChartSpace, width_emu: i64, height_emu: i64, ) -> EmbeddedChart

Creates an embedded chart with an explicit display size in EMUs.

Examples found in repository

examples/docx_images_and_charts.rs (line 25)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("docx_images_and_charts.docx");
    let image_bytes = std::fs::read(image_fixture_path())?;

    // 2 inches wide, 1.5 inches tall (914,400 EMU per inch).
    let image = Image::new(image_bytes, ImageFormat::Png, 1_828_800, 1_371_600)
        .with_description("Project test image");
    let chart = EmbeddedChart::new(sample_chart_space(), 4_572_000, 2_743_200)
        .with_name("Quarterly revenue");

    let document = Document::new()
        .with_paragraph(heading("An inline image", false))
        .with_paragraph(Paragraph::new().with_run(Run::with_image(image)))
        .with_paragraph(heading("An embedded bar chart", true))
        .with_paragraph(Paragraph::new().with_run(Run::with_chart(chart)));

    document.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_name(self, name: impl Into<String>) -> EmbeddedChart

Sets the chart’s alt text / name and returns it for chaining.

Examples found in repository

examples/docx_images_and_charts.rs (line 26)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("docx_images_and_charts.docx");
    let image_bytes = std::fs::read(image_fixture_path())?;

    // 2 inches wide, 1.5 inches tall (914,400 EMU per inch).
    let image = Image::new(image_bytes, ImageFormat::Png, 1_828_800, 1_371_600)
        .with_description("Project test image");
    let chart = EmbeddedChart::new(sample_chart_space(), 4_572_000, 2_743_200)
        .with_name("Quarterly revenue");

    let document = Document::new()
        .with_paragraph(heading("An inline image", false))
        .with_paragraph(Paragraph::new().with_run(Run::with_image(image)))
        .with_paragraph(heading("An embedded bar chart", true))
        .with_paragraph(Paragraph::new().with_run(Run::with_chart(chart)));

    document.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

Trait Implementations

impl Clone for EmbeddedChart

fn clone(&self) -> EmbeddedChart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddedChart

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

Formats the value using the given formatter.

impl PartialEq for EmbeddedChart

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for EmbeddedChart