Paper Office
paper-pptxAPI referenceopc.oxml

CT_Relationships

paper-pptx 0.2.0 API reference

<Relationships> element, the root element in a .rels file.

Attributes

relationship

attributerelationship
= ZeroOrMore('pr:Relationship')

relationship_lst

attributerelationship_lstlist[CT_Relationship]

xml

attributexmlstr

XML string for this element, suitable for testing purposes.

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

xml_file_bytes

attributexml_file_bytesbytes

Return XML bytes, with XML-declaration, for this <Relationships> element.

Suitable for saving in a .rels stream, not pretty printed and with an XML declaration at the top.

Functions

add_rel

funcadd_rel(rId: str, reltype: str, target: str, is_external: bool = False) -> CT_Relationship

Add a child <Relationship> element with attributes set as specified.

paramrIdstr
paramreltypestr
paramtargetstr
paramis_externalbool
= False

Returns

pptx.opc.oxml.CT_Relationship

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
= ()

new

funcnew() -> CT_Relationships

Return a new <Relationships> element.

Returns

pptx.opc.oxml.CT_Relationships

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