_Body

Proxy for <w:body> element in this document.

It's primary role is a container for document content.

_Body(body_elm: CT_Body, parent: t.ProvidesStoryPart)

Attributes

attributeparagraphs

A list containing the paragraphs in this container, in document order.

Read-only.

attributepartStoryPart

The package part containing this object.

attributetables

A list containing the tables in this container, in document order.

Read-only.

funcadd_paragraph(text: str = '', style: str | ParagraphStyle | None = None) -> Paragraph

Return paragraph newly added to the end of the content in this container.

The paragraph has text in a single run if present, and is given paragraph style style.

If style is None, no paragraph style is applied, which has the same effect as applying the 'Normal' style.

paramtextstr

= ''

paramstylestr | ParagraphStyle | None

= None

Returns

docx.text.paragraph.Paragraph

funcadd_table(rows: int, cols: int, width: Length) -> Table

Return table of width having rows rows and cols columns.

The table is appended appended at the end of the content in this container.

width is evenly distributed between the table columns.

paramrowsint

paramcolsint

paramwidthLength

Returns

docx.table.Table

funcclear_content() -> _Body

Return this _Body instance after clearing it of all content.

Section properties for the main document story, if present, are preserved.

Returns

docx.document._Body

funciter_inner_content() -> Iterator[Paragraph | Table]

Generate each Paragraph or Table in this container in document order.

Returns

typing.Iterator[docx.text.paragraph.Paragraph | docx.table.Table]