internal_margin_top property

TextBox.internal_margin_top property

Specifies the inner top margin in points for a shape.

@property
def internal_margin_top(self) -> float:
    ...

@internal_margin_top.setter
def internal_margin_top(self, value: float):
    ...

Remarks

The default value is 1/20 inch.

Examples

Shows how to set internal margins for a text box.

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

# Insert another textbox with specific margins.
text_box_shape = builder.insert_shape(aw.drawing.ShapeType.TEXT_BOX, 100, 100)
text_box = text_box_shape.text_box
text_box.internal_margin_top = 15
text_box.internal_margin_bottom = 15
text_box.internal_margin_left = 15
text_box.internal_margin_right = 15

builder.move_to(text_box_shape.last_paragraph)
builder.write("Text placed according to textbox margins.")

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

See Also