Class CT_TableCell

src/pptx/oxml/table.py:176–360

`a:tc` custom element class

class CT_TableCell(BaseOxmlElement):
    """`a:tc` custom element class"""

    get_or_add_tcPr: Callable[[], CT_TableCellProperties]
    get_or_add_txBody: Callable[[], CT_TextBody]

    _tag_seq = ("a:txBody", "a:tcPr", "a:extLst")
    txBody: CT_TextBody | None = ZeroOrOne(  # pyright: ignore[reportAssignmentType]
        "a:txBody", successors=_tag_seq[1:]
    )
    tcPr: CT_TableCellProperties | None = ZeroOrOne(  # pyright: ignore[reportAssignmentType]
        "a:tcPr", successors=_tag_seq[2:]
    )
    del _tag_seq

    gridSpan: int = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
        "gridSpan", XsdInt, default=1
    )
    rowSpan: int = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
        "rowSpan", XsdInt, default=1
    )
    hMerge: bool = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
        "hMerge", XsdBoolean, default=False
    )
    vMerge: bool = OptionalAttribute(  # pyright: ignore[reportAssignmentType]
        "vMerge", XsdBoolean, default=False
    )

    @property
    def anchor(self) -> MSO_VERTICAL_ANCHOR | None:
        """String held in `anchor` attribute of `a:tcPr` child element of this `a:tc` element."""
        if self.tcPr is None:
            return None
        return self.tcPr.anchor

    @anchor.setter
    def anchor(self, anchor_enum_idx: MSO_VERTICAL_ANCHOR | None):
        """Set value of anchor attribute on `a:tcPr` child element."""
        if anchor_enum_idx is None and self.tcPr is None:
            return
        tcPr = self.get_or_add_tcPr()
        tcPr.anchor = anchor_enum_idx

    def append_ps_from(self, spanned_tc: CT_TableCell):
        """Append `a:p` elements taken from `spanned_tc`.

        Any non-empty paragraph elements in `spanned_tc` are removed and appended to the
        text-frame of this cell. If `spanned_tc` is left with no content after this process, a
        single empty `a:p` element is added to ensure the cell is compliant with the spec.
        """
        source_txBody = spanned_tc.get_or_add_txBody()
        target_txBody = self.get_or_add_txBody()

        # ---if source is empty, there's nothing to do---
        if source_txBody.is_empty:
            return

        # ---a single empty paragraph in target is overwritten---