TextBoxes example

This example demonstrates how to use the TextBox class to add styled text boxes to a PowerPoint presentation.

It shows how to customize:

• Font family and size

• Text alignment (left, center, right)

• Vertical text orientation (via angle)

• Fill and stroke styles

• Font formatting (bold, italic, etc.)

Overview

This script:

• Adds five horizontally aligned text boxes with different fonts and alignments

• Adds one vertical, italic, dashed-bordered text box with background fill

Each text box uses:

• FontStyle — for font size, family, alignment, color

• FontFormat — for extra formatting like bold, italic, etc.

• FillStyle and StrokeStyle — for visual styling

• TextBox — to place and configure the text shape

Example Code

from pptx_shapes import Presentation
from pptx_shapes.enums import Align, LineDash
from pptx_shapes.shapes import TextBox
from pptx_shapes.style import FillStyle, FontFormat, FontStyle, StrokeStyle


def main() -> None:
    with Presentation(presentation_path="empty.pptx") as presentation:
        presentation.add(shape=TextBox(x=1, y=1, width=15, height=2, text="Calibri text", style=FontStyle(size=42, family="Calibri", align=Align.LEFT, color="#dd7373")))
        presentation.add(shape=TextBox(x=1, y=4, width=15, height=2, text="Arial text", style=FontStyle(size=42, family="Arial", align=Align.CENTER)))
        presentation.add(shape=TextBox(x=1, y=7, width=15, height=2, text="Times New Roman text", style=FontStyle(size=42, family="Times New Roman", align=Align.LEFT)))
        presentation.add(shape=TextBox(x=1, y=10, width=15, height=2, text="Consolas text", style=FontStyle(size=42, family="Consolas", align=Align.LEFT)))
        presentation.add(shape=TextBox(x=1, y=13, width=15, height=2, text="Привет, МИР!", style=FontStyle(size=42, family="Consolas", align=Align.RIGHT)))

        presentation.add(shape=TextBox(
            x=17, y=8,
            width=15, height=3,
            text="Two lines of\nitalic vertical text",
            angle=90,
            style=FontStyle(size=35),
            formatting=FontFormat(italic=True),
            fill=FillStyle(color="#ddd"),
            stroke=StrokeStyle(color="#222", dash=LineDash.DASHED)
        ))

        presentation.save("text_boxes.pptx")


if __name__ == "__main__":
    main()

Result

This example produces a PowerPoint file (text_boxes.pptx) with six text boxes on a blank slide.

• The left column demonstrates different font families and alignment styles.

• The right column features a vertically rotated, styled text box with custom fill and dashed border.