Paper Office
paper-docxAPI referenceparts.hdrftr

FooterPart

paper-docx 0.2.0 API reference

Definition of a section footer.

Attributes

blob

attributeblob

content_type

attributecontent_type

Content type of this part.

element

attributeelement

The root XML element of this XML part.

next_id

attributenext_idint

Next available positive integer id value in this story XML document.

The value is determined by incrementing the maximum existing id value. Gaps in the existing id sequence are not filled. The id attribute value is unique in the document, without regard to the element type it appears on.

package

attributepackage

OpcPackage instance this part belongs to.

part

attributepart

Part of the parent protocol, "children" of the document will not know the part that contains them so must ask their parent object.

That chain of delegation ends here for child objects.

partname

attributepartname

PackURI instance holding partname of this part, e.g. '/ppt/slides/slide1.xml'.

attributerelated_parts

Dictionary mapping related parts by rId, so child objects can resolve explicit relationships present in the part XML, e.g. sldIdLst to a specific Slide instance.

rels

attributerels

Relationships instance holding the relationships for this part.

Functions

after_unmarshal

funcafter_unmarshal()

Entry point for post-unmarshaling processing, for example to parse the part XML.

May be overridden by subclasses without forwarding call to super.

before_marshal

funcbefore_marshal()

Entry point for pre-serialization processing, for example to finalize part naming if necessary.

May be overridden by subclasses without forwarding call to super.

drop_rel

funcdrop_rel(rId: str)

Remove the relationship identified by rId if its reference count is less than 2.

Relationships with a reference count of 0 are implicit relationships.

paramrIdstr

get_or_add_image

funcget_or_add_image(image_descriptor: str | IO[bytes]) -> Tuple[str, Image]

Return (rId, image) pair for image identified by image_descriptor.

rId is the str key (often like "rId7") for the relationship between this story part and the image part, reused if already present, newly created if not. image is an Image instance providing access to the properties of the image, such as dimensions and image type.

paramimage_descriptorstr | IO[bytes]

Returns

typing.Tuple[str, docx.image.image.Image]

get_style

funcget_style(style_id: str | None, style_type: WD_STYLE_TYPE) -> BaseStyle

Return the style in this document matching style_id.

Returns the default style for style_type if style_id is None or does not match a defined style of style_type.

paramstyle_idstr | None
paramstyle_typeWD_STYLE_TYPE

Returns

docx.styles.style.BaseStyle

get_style_id

funcget_style_id(style_or_name: BaseStyle | str | None, style_type: WD_STYLE_TYPE) -> str | None

Return str style_id for style_or_name of style_type.

Returns None if the style resolves to the default style for style_type or if style_or_name is itself None. Raises if style_or_name is a style of the wrong type or names a style not present in the document.

paramstyle_or_nameBaseStyle | str | None
paramstyle_typeWD_STYLE_TYPE

Returns

str | None

load

funcload(partname: PackURI, content_type: str, blob: bytes, package: Package)
parampartnamePackURI
paramcontent_typestr
paramblobbytes
parampackagePackage

load_rel

funcload_rel(reltype: str, target: Part | str, rId: str, is_external: bool = False)

Return newly added _Relationship instance of reltype.

The new relationship relates the target part to this part with key rId.

Target mode is set to RTM.EXTERNAL if is_external is True. Intended for use during load from a serialized package, where the rId is well-known. Other methods exist for adding a new relationship to a part when manipulating a part.

paramreltypestr
paramtargetPart | str
paramrIdstr
paramis_externalbool
= False

new

funcnew(package: Package)

Return newly created footer part.

parampackagePackage

new_pic_inline

funcnew_pic_inline(image_descriptor: str | IO[bytes], width: int | Length | None = None, height: int | Length | None = None) -> CT_Inline

Return a newly-created w:inline element.

The element contains the image specified by image_descriptor and is scaled based on the values of width and height.

paramimage_descriptorstr | IO[bytes]
paramwidthint | Length | None
= None
paramheightint | Length | None
= None

Returns

docx.oxml.shape.CT_Inline
funcpart_related_by(reltype: str) -> Part

Return part to which this part has a relationship of reltype.

Raises KeyError if no such relationship is found and ValueError if more than one such relationship is found. Provides ability to resolve implicitly related part, such as Slide -> SlideLayout.

paramreltypestr

Returns

docx.opc.part.Part

relate_to

funcrelate_to(target: Part | str, reltype: str, is_external: bool = False) -> str

Return rId key of relationship of reltype to target.

The returned rId is from an existing relationship if there is one, otherwise a new relationship is created.

paramtargetPart | str
paramreltypestr
paramis_externalbool
= False

Returns

str

target_ref

functarget_ref(rId: str) -> str

Return URL contained in target ref of relationship identified by rId.

paramrIdstr

Returns

str

On this page