Function edit_textbox

demo/Paper2Poster/utils/pptx_utils.py:1481–1554

Edit properties of an existing textbox shape. :param shape: The shape object (textbox) to edit. :param text: New text to set. If None, leaves text unmodified. :param word_wrap: Boolean to enable/disable word wrap. If None, leaves unmodified. :param font_size: Font size (int/flo

(
    shape,
    text=None,
    word_wrap=None,
    font_size=None,
    bold=None,
    italic=None,
    alignment=None,
    fill_color=None,
    font_name=None
)

def edit_textbox(
    shape,
    text=None,
    word_wrap=None,
    font_size=None,
    bold=None,
    italic=None,
    alignment=None,
    fill_color=None,
    font_name=None
):
    """
    Edit properties of an existing textbox shape.

    :param shape: The shape object (textbox) to edit.
    :param text: New text to set. If None, leaves text unmodified.
    :param word_wrap: Boolean to enable/disable word wrap. If None, leaves unmodified.
    :param font_size: Font size (int/float or string like '12pt'). If None, leaves unmodified.
    :param bold: Boolean to set bold. If None, leaves unmodified.
    :param italic: Boolean to set italic. If None, leaves unmodified.
    :param alignment: One of 'left', 'center', 'right', 'justify'. If None, leaves unmodified.
    :param fill_color: A tuple (r, g, b) for background fill color, or None to leave unmodified.
    """

    text_frame = shape.text_frame
    text_frame.auto_size = MSO_AUTO_SIZE.NONE

    # Update fill color if provided
    if fill_color is not None:
        shape.fill.solid()
        shape.fill.fore_color.rgb = RGBColor(*fill_color)
    # else: If you'd like to remove any existing fill if None, you could:
    # else:
    #     shape.fill.background()

    # Update word wrap if provided
    if word_wrap is not None:
        text_frame.word_wrap = word_wrap

    # If text is provided, clear existing paragraphs and add the new text
    if text is not None:
        text_frame.clear()
        p = text_frame.add_paragraph()
        run = p.add_run()
        run.text = text

        # If alignment is provided, apply to the paragraph
        if alignment is not None:
            p.alignment = _parse_alignment(alignment)

        # If font formatting info is provided, apply to the run font
        font = run.font
        if font_size is not None:
            font.size = _parse_font_size(font_size)
        if bold is not None:
            font.bold = bold
        if italic is not None:
            font.italic = italic