Paper Office
paper-docxAPI referenceoxml.text.run

CT_Cr

paper-docx 0.2.0 API reference

<w:cr> element, representing a carriage-return (0x0D) character within a run.

In Word, this represents a "soft carriage-return" in the sense that it does not end the paragraph the way pressing Enter (aka. Return) on the keyboard does. Here the text equivalent is considered to be newline (" ") since in plain-text that's the closest Python equivalent.

NOTE: this complex-type name does not exist in the schema, where w:tab maps to CT_Empty. This name was added to give it distinguished behavior. CT_Empty is used for many elements.

Attributes

xml

attributexmlstr

XML string for this element, suitable for testing purposes.

Pretty printed for readability and without an XML declaration at the top.

Functions

first_child_found_in

funcfirst_child_found_in(*tagnames: str) -> _Element | None

First child with tag in tagnames, or None if not found.

paramtagnamesstr
= ()

Returns

lxml.etree._Element | None

insert_element_before

funcinsert_element_before(elm: ElementBase, *tagnames: str)
paramelmElementBase
paramtagnamesstr
= ()

remove_all

funcremove_all(*tagnames: str) -> None

Remove child elements with tagname (e.g. "a:p") in tagnames.

paramtagnamesstr
= ()

Returns

None

xpath

funcxpath(xpath_str: str) -> Any

Override of lxml _Element.xpath() method.

Provides standard Open XML namespace mapping (nsmap) in centralized location.

paramxpath_strstr

Returns

typing.Any

On this page