fit_shape_to_text property

TextBox.fit_shape_to_text property

Determines whether Microsoft Word will grow the shape to fit text.

@property
def fit_shape_to_text(self) -> bool:
    ...

@fit_shape_to_text.setter
def fit_shape_to_text(self, value: bool):
    ...

Remarks

The default value is False.

Examples

Shows how to get a text box to resize itself to fit its contents tightly.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

text_box_shape = builder.insert_shape(aw.drawing.ShapeType.TEXT_BOX, 150, 100)
text_box = text_box_shape.text_box

# Apply these values to both these members to get the parent shape to fit
# tightly around the text contents, ignoring the dimensions we have set.
text_box.fit_shape_to_text = True
text_box.text_box_wrap_mode = aw.drawing.TextBoxWrapMode.NONE

builder.move_to(text_box_shape.last_paragraph)
builder.write("Text fit tightly inside textbox.")

doc.save(ARTIFACTS_DIR + "Shape.text_box_fit_shape_to_text.docx")

See Also

TextBox.internal_margin_bottom property