DocumentPart

Comments object providing access to the comments added to this document.

Content type of this part.

A CoreProperties object providing read/write access to the core properties of this document.

A Document object providing access to the content of this document.

The root XML element of this XML part.

The InlineShapes instance containing the inline shapes in the document.

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.

A NumberingPart object providing access to the numbering definitions for this document.

Creates an empty numbering part if one is not present.

OpcPackage instance this part belongs to.

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.

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

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.

Relationships instance holding the relationships for this part.

A Settings object providing access to the settings in the settings part of this document.

A Styles object providing access to the styles in the styles part of this document.

Return (footer_part, rId) pair for newly-created footer part.

Return (header_part, rId) pair for newly-created header part.

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

May be overridden by subclasses without forwarding call to super.

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

May be overridden by subclasses without forwarding call to super.

Remove related header part identified by rId.

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

Relationships with a reference count of 0 are implicit relationships.

Return FooterPart related by rId.

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.

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.

Return the style_id (str) of the style of style_type matching style_or_name.

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.

Return HeaderPart related by rId.

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.

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.

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.

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.

Save this document to path_or_stream, which can be either a path to a filesystem location (a string) or a file-like object.

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