Struct TableCell 

pub struct TableCell {
    pub text_body: Option<TextBody>,
    pub horizontal_span: Option<u32>,
    pub vertical_span: Option<u32>,
    pub horizontal_merge: bool,
    pub vertical_merge: bool,
    pub properties: Option<TableCellProperties>,
}

One cell of a TableRow (<a:tc>, CT_TableCell).

The merge fields are not grounded on a real fixture — see this module’s own top-level doc comment; none of this project’s real table fixtures happens to exercise a merged cell, only the base graphicFrame/tbl/tblGrid/tr/tc structure itself is fixture- confirmed. Built from ECMA-376’s own CT_TableCell attribute list, which is genuinely different from word_ooxml::TableCell’s merge model despite the conceptual overlap: WordprocessingML lets a spanned cell be omitted from its row entirely (gridSpan absorbs the columns, no placeholder w:tc needed for what it covers), but CT_TableCell has no such shortcut — every row must carry exactly one <a:tc> per <a:gridCol>, and a merge is expressed by marking the absorbed cells with hMerge/vMerge (plain booleans, not an enum) rather than omitting them, while the top/left cell of the merge carries gridSpan/rowSpan (the count, not a boolean). SlideTable’s writer enforces the “one cell per grid column, every row” shape by padding a short row with empty cells rather than silently producing an invalid .pptx.

Fields

text_body: Option<TextBody>

horizontal_span: Option<u32>

gridSpan — how many grid columns this cell spans (a horizontal merge, the top/left cell only). None means 1 (no merge), matching CT_TableCell’s own schema default.

vertical_span: Option<u32>

rowSpan — how many rows this cell spans (a vertical merge, the top/left cell only). None means 1.

horizontal_merge: bool

hMerge — true marks this cell as absorbed by a horizontal merge from the cell to its left (this cell must still be present in the row, typically with no text of its own).

vertical_merge: bool

vMerge — true marks this cell as absorbed by a vertical merge from the cell above it.

properties: Option<TableCellProperties>

<a:tcPr> (CT_TableCellProperties) — this cell’s own margins, vertical anchor, borders, and background fill, overriding whatever the table’s style would otherwise apply. None (the default) omits <a:tcPr> entirely — the cell simply inherits everything from the table style, same “no override” default every other optional field in this crate uses.

Implementations

impl TableCell

pub fn new() -> TableCell

Creates an empty cell (no text, no merge, no property overrides).

Examples found in repository

examples/pptx_tables.rs (line 102)

fn cell(text: &str) -> TableCell {
    TableCell::new().with_text_body(
        TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
    )
}

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

Sets this cell’s text content.

Examples found in repository

examples/pptx_tables.rs (lines 102-104)

fn cell(text: &str) -> TableCell {
    TableCell::new().with_text_body(
        TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
    )
}

pub fn with_properties(self, properties: TableCellProperties) -> TableCell

Sets this cell’s own margin/anchor/border/fill overrides (<a:tcPr>).

pub fn with_horizontal_span(self, span: u32) -> TableCell

Marks this cell as the top/left cell of a horizontal merge spanning span grid columns — the span - 1 cells to its right still need to be present in the row, each created via TableCell::horizontally_merged.

Examples found in repository

examples/pptx_tables.rs (line 43)

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

pub fn with_vertical_span(self, span: u32) -> TableCell

Marks this cell as the top/left cell of a vertical merge spanning span rows — the span - 1 cells below it (same column, following rows) still need to be present, each created via TableCell::vertically_merged.

pub fn horizontally_merged() -> TableCell

An empty placeholder cell absorbed by a horizontal merge from its left neighbor (hMerge="1").

Examples found in repository

examples/pptx_tables.rs (line 44)

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

pub fn vertically_merged() -> TableCell

An empty placeholder cell absorbed by a vertical merge from the cell above it (vMerge="1").

Trait Implementations

impl Clone for TableCell

fn clone(&self) -> TableCell

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TableCell

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

Formats the value using the given formatter.

impl Default for TableCell

fn default() -> TableCell

Returns the “default value” for a type.

impl PartialEq for TableCell

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TableCell