Struct AutoShape 

pub struct AutoShape {
    pub id: u32,
    pub name: String,
    pub properties: ShapeProperties,
    pub text_body: Option<TextBody>,
    pub placeholder: Option<Placeholder>,
    pub is_text_box: bool,
    pub hyperlink: Option<SlideHyperlinkTarget>,
}

An autoshape or text box (<p:sp>, CT_Shape).

Real PowerPoint title/content slides overwhelmingly use placeholder shapes (position/formatting inherited from the slide layout/master, see Placeholder) rather than freestanding ones. placeholder is None for a freestanding shape and Some for one that plays a placeholder role; either way, properties/text_body describe the shape’s own content exactly the same way.

Fields

id: u32

<p:cNvPr id=".."> — must be unique within the slide, and must not collide with 1, always reserved by this crate’s writer for the slide’s own group shape (<p:nvGrpSpPr><p:cNvPr id="1"../>) — mirrors word-ooxml’s existing convention of caller-managed numeric ids (see e.g. Bookmark::new(id)/NoteReference::new(id)).

name: String

<p:cNvPr name=".."> — a human-readable shape name (e.g. “Zone de texte 1”), purely cosmetic (shown in PowerPoint’s Selection Pane).

properties: ShapeProperties

<p:spPr>’s content — position/size, outline geometry, fill, line. Reuses drawing::ShapeProperties verbatim (see this module’s own doc comment). When transform is unset, the writer still always emits a fixed zero-valued <a:xfrm> and a default rect <a:prstGeom> — the same “always write geometry, never delegate silently” fix this project already had to apply twice to excel-ooxml’s picture writing (missing geometry, then missing <a:xfrm>, both making a shape invisible in real Excel) — applied here proactively rather than rediscovered.

Unlike excel-ooxml’s picture reader (which unconditionally clears transform/demotes a plain rect geometry back to None on read, because a picture’s real position always comes from its separate two-cell anchor, never from spPr’s own xfrm), this crate’s reader makes no such attempt for a freestanding shape: xfrm is its only source of position/size, so a real, non-zero transform must round-trip faithfully. This means an AutoShape written with properties left at its ShapeProperties::new() default reads back with an explicit zero-offset/zero-extent transform and a rect geometry, not None — a known, deliberate round-trip asymmetry for this specific case, not a bug. A placeholder shape (<p:spPr/> empty, position/formatting inherited) reads back with properties at that same default, for the exact same textual reason — genuinely indistinguishable from the freestanding zero-sized case by this crate, another accepted limitation of not modeling slide layout inheritance yet.

text_body: Option<TextBody>

<p:txBody> — this shape’s text content, if any. Reuses drawing::TextBody verbatim.

placeholder: Option<Placeholder>

<p:nvSpPr>/<p:nvPr>/<p:ph> — this shape’s placeholder role, if any. None for a freestanding shape.

is_text_box: bool

<p:nvSpPr>/<p:cNvSpPr txBox="1"> — marks this shape as a genuine text box rather than an ordinary autoshape. Purely a hint real PowerPoint itself uses (e.g. to decide whether the shape gets a default outline/fill when the user starts typing into an empty one) — this crate doesn’t otherwise treat a text box specially; properties/text_body describe its content exactly the same way regardless. Grounded against a real fixture confirming the exact <p:cNvSpPr txBox="1"/> shape.

hyperlink: Option<SlideHyperlinkTarget>

<p:nvSpPr>/<p:cNvPr>/<a:hlinkClick> (including the internal-target/relative-jump variants) — a clickable hyperlink on this whole shape (as opposed to a hyperlink on an individual text run, drawing::Hyperlink on drawing::TextRunProperties, which this crate does reuse for run text but doesn’t yet resolve to a real relationship — see writer.rs’s own doc comment on hyperlinks for why shape-level support came first). None for no link. See SlideHyperlinkTarget’s own doc comment for the target kinds.

Implementations

impl AutoShape

pub fn new(id: u32, name: impl Into<String>) -> AutoShape

Creates a freestanding shape with no explicit position/size/fill/ line, no text, no placeholder role, not a text box, and no hyperlink (use AutoShape::with_properties/ AutoShape::with_text_body/AutoShape::with_placeholder/ AutoShape::with_text_box/AutoShape::with_hyperlink/ AutoShape::with_hyperlink_target to fill those in).

Examples found in repository

examples/hello_world_pptx.rs (line 17)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("hello_world.pptx");

    let text_box = AutoShape::new(2, "Hello box")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 1_365_250)
                    .with_extent(7_772_400, 1_200_150),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Hello, world!"))),
        );

    // `Presentation` and `Slide` both come from `office_toolkit::prelude`.
    let presentation =
        Presentation::new().with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)));
    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());

    // Read the file back to confirm it is a valid .pptx.
    let reopened = Presentation::open_file(&path)?;
    println!("Slide count: {}", reopened.slides.len());

    Ok(())
}

examples/pptx_notes_and_comments.rs (line 16)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_notes_and_comments.pptx");

    let title = |text: &str| {
        AutoShape::new(2, "Title")
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(8_000_000, 1_000_000),
                ),
            )
            .with_text_body(
                TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
            )
    };

    let notes_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with speaker notes")))
        .with_notes(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Remember to mention the Q3 numbers here.")),
            ),
        );

    let commented_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with reviewer comments")))
        .with_comment(
            SlideComment::new(
                "Reviewer",
                "RV",
                "2026-07-21T10:00:00",
                "This claim needs a source.",
            )
            .with_position(1_000_000, 2_000_000),
        )
        .with_comment(
            SlideComment::new(
                "Editor",
                "ED",
                "2026-07-21T11:30:00",
                "Looks good otherwise.",
            )
            .with_position(3_000_000, 2_000_000),
        );

    let presentation = Presentation::new()
        .with_slide(notes_slide)
        .with_slide(commented_slide);

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

examples/pptx_shapes_and_placeholders.rs (line 17)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_theme_and_metadata.rs (line 57)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

examples/pptx_grouping_and_connectors.rs (line 27)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

examples/pptx_text_formatting.rs (line 22)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_text_formatting.pptx");

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_properties(self, properties: ShapeProperties) -> AutoShape

Sets this shape’s position/size/outline/fill/line.

Examples found in repository

examples/hello_world_pptx.rs (lines 18-24)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("hello_world.pptx");

    let text_box = AutoShape::new(2, "Hello box")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 1_365_250)
                    .with_extent(7_772_400, 1_200_150),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Hello, world!"))),
        );

    // `Presentation` and `Slide` both come from `office_toolkit::prelude`.
    let presentation =
        Presentation::new().with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)));
    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());

    // Read the file back to confirm it is a valid .pptx.
    let reopened = Presentation::open_file(&path)?;
    println!("Slide count: {}", reopened.slides.len());

    Ok(())
}

examples/pptx_notes_and_comments.rs (lines 17-23)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_notes_and_comments.pptx");

    let title = |text: &str| {
        AutoShape::new(2, "Title")
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(8_000_000, 1_000_000),
                ),
            )
            .with_text_body(
                TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
            )
    };

    let notes_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with speaker notes")))
        .with_notes(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Remember to mention the Q3 numbers here.")),
            ),
        );

    let commented_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with reviewer comments")))
        .with_comment(
            SlideComment::new(
                "Reviewer",
                "RV",
                "2026-07-21T10:00:00",
                "This claim needs a source.",
            )
            .with_position(1_000_000, 2_000_000),
        )
        .with_comment(
            SlideComment::new(
                "Editor",
                "ED",
                "2026-07-21T11:30:00",
                "Looks good otherwise.",
            )
            .with_position(3_000_000, 2_000_000),
        );

    let presentation = Presentation::new()
        .with_slide(notes_slide)
        .with_slide(commented_slide);

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

examples/pptx_shapes_and_placeholders.rs (lines 18-24)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_theme_and_metadata.rs (lines 58-66)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

examples/pptx_grouping_and_connectors.rs (lines 27-35)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

examples/pptx_text_formatting.rs (lines 23-29)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_text_formatting.pptx");

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_text_body(self, text_body: TextBody) -> AutoShape

Sets this shape’s text content.

Examples found in repository

examples/hello_world_pptx.rs (lines 25-28)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("hello_world.pptx");

    let text_box = AutoShape::new(2, "Hello box")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 1_365_250)
                    .with_extent(7_772_400, 1_200_150),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Hello, world!"))),
        );

    // `Presentation` and `Slide` both come from `office_toolkit::prelude`.
    let presentation =
        Presentation::new().with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)));
    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());

    // Read the file back to confirm it is a valid .pptx.
    let reopened = Presentation::open_file(&path)?;
    println!("Slide count: {}", reopened.slides.len());

    Ok(())
}

examples/pptx_notes_and_comments.rs (lines 24-26)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_notes_and_comments.pptx");

    let title = |text: &str| {
        AutoShape::new(2, "Title")
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(8_000_000, 1_000_000),
                ),
            )
            .with_text_body(
                TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
            )
    };

    let notes_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with speaker notes")))
        .with_notes(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Remember to mention the Q3 numbers here.")),
            ),
        );

    let commented_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with reviewer comments")))
        .with_comment(
            SlideComment::new(
                "Reviewer",
                "RV",
                "2026-07-21T10:00:00",
                "This claim needs a source.",
            )
            .with_position(1_000_000, 2_000_000),
        )
        .with_comment(
            SlideComment::new(
                "Editor",
                "ED",
                "2026-07-21T11:30:00",
                "Looks good otherwise.",
            )
            .with_position(3_000_000, 2_000_000),
        );

    let presentation = Presentation::new()
        .with_slide(notes_slide)
        .with_slide(commented_slide);

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

examples/pptx_shapes_and_placeholders.rs (lines 25-28)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_theme_and_metadata.rs (lines 67-77)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

examples/pptx_grouping_and_connectors.rs (lines 46-49)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

examples/pptx_text_formatting.rs (lines 30-44)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_text_formatting.pptx");

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_placeholder(self, placeholder: Placeholder) -> AutoShape

Marks this shape as playing the given placeholder role.

Examples found in repository

examples/pptx_shapes_and_placeholders.rs (line 44)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

pub fn with_text_box(self, is_text_box: bool) -> AutoShape

Marks (or unmarks) this shape as a genuine text box (txBox="1").

Examples found in repository

examples/pptx_shapes_and_placeholders.rs (line 31)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_text_formatting.rs (line 77)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_text_formatting.pptx");

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_hyperlink(self, url: impl Into<String>) -> AutoShape

Attaches a clickable hyperlink to this whole shape, given its target URL — sugar for with_hyperlink_target(SlideHyperlinkTarget::External(url)).

Examples found in repository

examples/pptx_shapes_and_placeholders.rs (line 71)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

pub fn with_hyperlink_target(self, target: SlideHyperlinkTarget) -> AutoShape

Attaches a clickable hyperlink to this whole shape, given any SlideHyperlinkTarget — the general form of AutoShape::with_hyperlink, also covering internal slide jumps.

Trait Implementations

impl Clone for AutoShape

fn clone(&self) -> AutoShape

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AutoShape

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

Formats the value using the given formatter.

impl PartialEq for AutoShape

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AutoShape