Function fill_textframe

utils/pptx_utils.py:1375–1478

Given an existing shape (with a text frame) and a paragraphs_spec describing paragraphs and runs, populate the shape's text frame. 'paragraphs_spec' is a list of paragraphs, each containing: - bullet: bool - level: int (indent level) - alignment: str ("left", "center"

(shape, paragraphs_spec, vertical_anchor=None)

    return shape

def fill_textframe(shape, paragraphs_spec, vertical_anchor=None):
    """
    Given an existing shape (with a text frame) and a paragraphs_spec
    describing paragraphs and runs, populate the shape's text frame.

    'paragraphs_spec' is a list of paragraphs, each containing:
      - bullet: bool
      - level: int (indent level)
      - alignment: str ("left", "center", "right", or "justify")
      - font_size: int
      - runs: list of run dictionaries, each with:
          text: str
          bold: bool
          italic: bool
          color: [r,g,b] or None
          font_size: int (optional, overrides paragraph default)
          fill_color: [r,g,b] or None

    :param vertical_anchor: Optional MSO_ANCHOR constant or string ("top", "middle", "bottom")
                           to control vertical alignment of text within textbox
    """
    text_frame = shape.text_frame
    # Ensure stable layout
    text_frame.auto_size = MSO_AUTO_SIZE.NONE
    text_frame.word_wrap = True

    # Set vertical anchor if provided
    if vertical_anchor is not None:
        if isinstance(vertical_anchor, str):
            anchor_map = {
                "top": MSO_ANCHOR.TOP,
                "middle": MSO_ANCHOR.MIDDLE,
                "bottom": MSO_ANCHOR.BOTTOM,
            }
            text_frame.vertical_anchor = anchor_map.get(vertical_anchor.lower(), MSO_ANCHOR.TOP)
        else:
            text_frame.vertical_anchor = vertical_anchor

    # Clear out existing paragraphs
    text_frame.clear()

    for p_data in paragraphs_spec:
        p = text_frame.add_paragraph()
        
        # # bulleting
        # p.bullet = p_data.get("bullet", False)
        
        # bullet level (indent)
        p.level = p_data.get("level", 0)
        
        # paragraph alignment
        align_str = p_data.get("alignment", "left")
        p.alignment = _parse_alignment(align_str)
        
        # paragraph-level font size
        default_font_size = p_data.get("font_size", 24)
        p.font.size = Pt(default_font_size)