Struct SlideComment 

pub struct SlideComment {
    pub author: String,
    pub initials: String,
    pub date: String,
    pub position_emu: (i64, i64),
    pub text: String,
}

A slide comment (ppt/comments/commentN.xml’s own <p:cm>, CT_Comment) — the legacy comment mechanism ECMA-376 itself defines (pre-2016 “modern threaded comments”, which PowerPoint now stores in a different, Microsoft-proprietary way this crate doesn’t model).

Not grounded on a real fixture — see this module’s own top-level doc comment. Structure follows ECMA-376’s CT_Comment/CT_CommentList/ CT_CommentAuthor/CT_CommentAuthorList directly (§19.4): a <p:cm>’s authorId attribute references a <p:cmAuthor> entry in the package-wide ppt/commentAuthors.xml by numeric id — this crate hides that indirection entirely, storing the author’s name/initials directly on each SlideComment and having the writer deduplicate/number authors automatically (an author appearing on several comments becomes one <p:cmAuthor> entry, matching how real PowerPoint itself avoids duplicate author entries).

Fields

author: String

<p:cmAuthor name=".."> — this comment’s author’s display name.

initials: String

<p:cmAuthor initials="..">.

date: String

<p:cm dt=".."> (ST_DateTime) — an ISO-8601 date/time string (e.g. "2024-01-15T10:30:00.000"). Stored as a plain string, same posture as every other date/time field in this workspace (no dedicated date/time type anywhere).

position_emu: (i64, i64)

<p:pos x=".." y="..">, in EMUs — where the comment’s marker sits on the slide.

text: String

<p:text> — the comment’s own body text (plain text only, unlike e.g. word_ooxml::Comment’s block-level content — CT_Comment’s text is a plain xsd:string, no rich formatting at all).

Implementations

impl SlideComment

pub fn new( author: impl Into<String>, initials: impl Into<String>, date: impl Into<String>, text: impl Into<String>, ) -> SlideComment

Creates a comment at position (0, 0).

Examples found in repository

examples/pptx_notes_and_comments.rs (lines 41-46)

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_position(self, x_emu: i64, y_emu: i64) -> SlideComment

Sets this comment’s marker position.

Examples found in repository

examples/pptx_notes_and_comments.rs (line 47)

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

Trait Implementations

impl Clone for SlideComment

fn clone(&self) -> SlideComment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlideComment

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

Formats the value using the given formatter.

impl PartialEq for SlideComment

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SlideComment