Struct Slide 

pub struct Slide {
    pub shapes: Vec<Shape>,
    pub notes: Option<TextBody>,
    pub comments: Vec<SlideComment>,
    pub background: Option<Fill>,
    pub hidden: bool,
    pub name: Option<String>,
    pub hide_master_graphics: bool,
}

A single slide: an ordered list of shapes (<p:spTree>’s children), plus optional speaker notes.

Fields

shapes: Vec<Shape>

notes: Option<TextBody>

This slide’s speaker notes (ppt/notesSlides/notesSlideN.xml’s own “body” placeholder text), if any. None (the default) means no notes part is written for this slide at all — real PowerPoint packages commonly have no notes for most slides, so this stays a genuinely optional, per-slide part rather than always-present boilerplate (mirrors word-ooxml’s header/footer, styles.xml, etc. — every optional part in this workspace follows the same “only written when actually set” convention). See Presentation’s writer for the fixed notes-master/notes-slide boilerplate this produces around the text itself.

comments: Vec<SlideComment>

This slide’s comments (ppt/comments/commentN.xml), if any — a genuinely optional part, only written when non-empty, same “only written when actually set” convention as notes. See SlideComment’s own doc comment for the caveat that this feature isn’t grounded on a real fixture.

background: Option<Fill>

<p:cSld>/<p:bg>/<p:bgPr> — this slide’s own background fill, overriding whatever the slide layout/master would otherwise show through. None (the default) omits <p:bg> entirely — the slide simply inherits its background from the layout/master chain, same “no override” default every other optional field in this crate uses. Only the direct fill choice (<p:bgPr>, EG_FillProperties) is modeled — <p:bgRef> (a reference into the theme’s own background style list) is not. Grounded against a real fixture (ppt/slides/slide2.xml), which confirmed <p:bg> as <p:cSld>’s very first child, directly wrapping <p:bgPr> before any fill.

hidden: bool

<p:sld show="0"> (CT_Slide’s own show attribute) — hides this slide from the normal slide-show sequence (it’s still present in the deck, just skipped when presenting; PowerPoint’s own “Hide Slide” toggle). false (the default) omits the attribute, matching the schema’s own default of a shown slide. Grounded against a real fixture.

name: Option<String>

<p:sld name="."> — an optional display name for this slide (distinct from its title placeholder’s own text), shown e.g. in PowerPoint’s Slide Navigator/Outline view. None omits the attribute entirely. Not grounded on a fixture — no corpus .pptx file examined actually sets it — modeled directly from CT_Slide’s schema anyway, the same posture already used for e.g. crate::model::SlideComment/crate::model::Connector.

hide_master_graphics: bool

<p:sld showMasterSp="0"> (CT_Slide’s own showMasterSp attribute, inverted here) — hides this slide’s inherited slide- master placeholder graphics/decorations (e.g. a logo or footer bar drawn directly on the master, not through a placeholder this slide overrides). The schema’s own default is showMasterSp="1" (shown) when the attribute is omitted — this field is named/stored inverted (false = shown, matching every other boolean “override” field in this crate, e.g. hidden) so that Slide::new’s all-false default already matches real PowerPoint’s own default behavior, and the attribute is only ever written (as "0") when explicitly hidden. Grounded against real fixtures.

Implementations

impl Slide

pub fn new() -> Slide

Creates an empty slide (no shapes, no notes, no comments, no background override, shown, unnamed, showing inherited master graphics).

Examples found in repository

examples/hello_world_pptx.rs (line 32)

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 29)

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_media.rs (line 70)

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

    let embedded_picture = Picture::new(
        2,
        "Embedded picture",
        image_bytes.clone(),
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_description("Project test image");

    let linked_picture = Picture::new(
        2,
        "Externally linked picture",
        image_bytes,
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_external_link("https://example.com/original-image.png");

    // Placeholder bytes — a real .pptx would carry a genuine video file
    // here. This example only demonstrates the model/writer plumbing.
    let poster_image = vec![0x89, 0x50, 0x4E, 0x47]; // fake, just enough bytes to have *some* data
    let media = SlideMedia::new(
        2,
        "Video clip",
        vec![0u8; 16],
        MediaFormat::Mp4,
        4_000_000,
        2_250_000,
    )
    .with_offset(838_200, 838_200)
    .with_poster_image(poster_image, PictureFormat::Png);

    let chart = SlideChart::new(
        2,
        "Quarterly revenue",
        sample_chart_space(),
        6_000_000,
        3_500_000,
    )
    .with_offset(838_200, 838_200);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Picture(embedded_picture)))
        .with_slide(Slide::new().with_shape(Shape::Picture(linked_picture)))
        .with_slide(Slide::new().with_shape(Shape::Media(media)))
        .with_slide(Slide::new().with_shape(Shape::Chart(Box::new(chart))));

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

examples/pptx_tables.rs (line 92)

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

    let plain_table = SlideTable::new(2, "Plain table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Name"))
                .with_cell(cell("Score")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Alice"))
                .with_cell(cell("92")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Bob"))
                .with_cell(cell("87")),
        );

    let merged_table = SlideTable::new(2, "Merged cells", 5_000_000, 1_000_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![1_667_000, 1_667_000, 1_666_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Spanning header").with_horizontal_span(3))
                .with_cell(TableCell::horizontally_merged())
                .with_cell(TableCell::horizontally_merged()),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("A"))
                .with_cell(cell("B"))
                .with_cell(cell("C")),
        );

    let styled_table = SlideTable::new(2, "Styled table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_style_id("{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}")
        .with_style_first_row(true)
        .with_style_band_rows(true)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Header A"))
                .with_cell(cell("Header B")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("1"))
                .with_cell(cell("2")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("3"))
                .with_cell(cell("4")),
        );

    let presentation = Presentation::new()
        .with_table_style(
            SlideTableStyle::new(
                "{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}",
                "Custom Table Style",
            )
            .with_first_row(
                TableStylePart::new()
                    .with_fill(Fill::Solid(Color::Rgb("2E74B5".to_string())))
                    .with_bold(true)
                    .with_text_color(Color::Rgb("FFFFFF".to_string())),
            )
            .with_band1_horizontal(
                TableStylePart::new().with_fill(Fill::Solid(Color::Rgb("F2F2F2".to_string()))),
            ),
        )
        .with_slide(Slide::new().with_shape(Shape::Table(plain_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(merged_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(styled_table)));

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

examples/pptx_shapes_and_placeholders.rs (line 84)

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 82)

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(())
}

Additional examples can be found in:

• examples/pptx_grouping_and_connectors.rs
• examples/pptx_text_formatting.rs

pub fn with_shape(self, shape: Shape) -> Slide

Appends a shape.

Examples found in repository

examples/hello_world_pptx.rs (line 32)

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 30)

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_media.rs (line 70)

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

    let embedded_picture = Picture::new(
        2,
        "Embedded picture",
        image_bytes.clone(),
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_description("Project test image");

    let linked_picture = Picture::new(
        2,
        "Externally linked picture",
        image_bytes,
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_external_link("https://example.com/original-image.png");

    // Placeholder bytes — a real .pptx would carry a genuine video file
    // here. This example only demonstrates the model/writer plumbing.
    let poster_image = vec![0x89, 0x50, 0x4E, 0x47]; // fake, just enough bytes to have *some* data
    let media = SlideMedia::new(
        2,
        "Video clip",
        vec![0u8; 16],
        MediaFormat::Mp4,
        4_000_000,
        2_250_000,
    )
    .with_offset(838_200, 838_200)
    .with_poster_image(poster_image, PictureFormat::Png);

    let chart = SlideChart::new(
        2,
        "Quarterly revenue",
        sample_chart_space(),
        6_000_000,
        3_500_000,
    )
    .with_offset(838_200, 838_200);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Picture(embedded_picture)))
        .with_slide(Slide::new().with_shape(Shape::Picture(linked_picture)))
        .with_slide(Slide::new().with_shape(Shape::Media(media)))
        .with_slide(Slide::new().with_shape(Shape::Chart(Box::new(chart))));

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

examples/pptx_tables.rs (line 92)

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

    let plain_table = SlideTable::new(2, "Plain table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Name"))
                .with_cell(cell("Score")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Alice"))
                .with_cell(cell("92")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Bob"))
                .with_cell(cell("87")),
        );

    let merged_table = SlideTable::new(2, "Merged cells", 5_000_000, 1_000_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![1_667_000, 1_667_000, 1_666_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Spanning header").with_horizontal_span(3))
                .with_cell(TableCell::horizontally_merged())
                .with_cell(TableCell::horizontally_merged()),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("A"))
                .with_cell(cell("B"))
                .with_cell(cell("C")),
        );

    let styled_table = SlideTable::new(2, "Styled table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_style_id("{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}")
        .with_style_first_row(true)
        .with_style_band_rows(true)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Header A"))
                .with_cell(cell("Header B")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("1"))
                .with_cell(cell("2")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("3"))
                .with_cell(cell("4")),
        );

    let presentation = Presentation::new()
        .with_table_style(
            SlideTableStyle::new(
                "{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}",
                "Custom Table Style",
            )
            .with_first_row(
                TableStylePart::new()
                    .with_fill(Fill::Solid(Color::Rgb("2E74B5".to_string())))
                    .with_bold(true)
                    .with_text_color(Color::Rgb("FFFFFF".to_string())),
            )
            .with_band1_horizontal(
                TableStylePart::new().with_fill(Fill::Solid(Color::Rgb("F2F2F2".to_string()))),
            ),
        )
        .with_slide(Slide::new().with_shape(Shape::Table(plain_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(merged_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(styled_table)));

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

examples/pptx_shapes_and_placeholders.rs (line 84)

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 82)

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(())
}

Additional examples can be found in:

• examples/pptx_grouping_and_connectors.rs
• examples/pptx_text_formatting.rs

pub fn add_shape(&mut self, shape: Shape) -> &mut Shape

Appends a shape and returns a mutable reference to it. A &mut self counterpart to Self::with_shape, same rationale as Presentation::add_slide.

pub fn with_hidden(self, hidden: bool) -> Slide

Hides this slide from the normal slide-show sequence (show="0").

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

Sets this slide’s display name (<p:sld name="..">).

pub fn with_notes(self, notes: TextBody) -> Slide

Sets this slide’s speaker notes.

Examples found in repository

examples/pptx_notes_and_comments.rs (lines 31-36)

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(())
}

pub fn with_comment(self, comment: SlideComment) -> Slide

Appends a comment.

Examples found in repository

examples/pptx_notes_and_comments.rs (lines 40-48)

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(())
}

pub fn with_background(self, background: Fill) -> Slide

Sets this slide’s own background fill, overriding the layout/master.

pub fn with_hide_master_graphics(self, hide: bool) -> Slide

Hides this slide’s inherited slide-master graphics (showMasterSp="0").

Trait Implementations

impl Clone for Slide

fn clone(&self) -> Slide

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Slide

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

Formats the value using the given formatter.

impl Default for Slide

fn default() -> Slide

Returns the “default value” for a type.

impl PartialEq for Slide

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Slide