o Ð'féã@s dZddlmZddlmZmZmZddlmZ ddl m Z ddl m Z ddlmZmZerFddlmZdd lmZdd lmZdd lmZGd d „d e ƒZdS)z |StoryPart| and related objects.é)Ú annotations)ÚIOÚ TYPE_CHECKINGÚTuple)ÚRELATIONSHIP_TYPE)ÚXmlPart)Ú CT_Inline)ÚLengthÚ lazyproperty)Ú WD_STYLE_TYPE)ÚImage)Ú DocumentPart)Ú BaseStylec@sZeZdZdZd dd„Zd!d d„Zd"dd„Z  d#d$dd„Zed%dd„ƒZ e d&dd„ƒZ dS)'Ú StoryPartz÷Base class for story parts. A story part is one that can contain textual content, such as the document-part and header or footer parts. These all share content behaviors like `.paragraphs`, `.add_paragraph()`, `.add_table()` etc. Úimage_descriptorústr | IO[bytes]ÚreturnúTuple[str, Image]cCs4|j}|dus J‚| |¡}| |tj¡}||jfS)a|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. N)Ú_packageÚget_or_add_image_partÚ relate_toÚRTÚIMAGEÚimage)ÚselfrÚpackageÚ image_partÚrId©rúH/home/ubuntu/flask/venv/lib/python3.10/site-packages/docx/parts/story.pyÚget_or_add_images    zStoryPart.get_or_add_imageÚstyle_idú str | NoneÚ style_typer rcCó|j ||¡S)zÆ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`. )Ú_document_partÚ get_style)rr!r#rrrr&)szStoryPart.get_styleÚ style_or_nameúBaseStyle | str | NonecCr$)a2Return 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. )r%Ú get_style_id)rr'r#rrrr)1s zStoryPart.get_style_idNÚwidthú Length | NoneÚheightrc Cs>| |¡\}}| ||¡\}}|j|j}} t ||| ||¡S)z¾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`. )r Úscaled_dimensionsÚnext_idÚfilenamerÚnew_pic_inline) rrr*r,rrÚcxÚcyÚshape_idr/rrrr0<s zStoryPart.new_pic_inlineÚintcCs.|j d¡}dd„|Dƒ}|sdSt|ƒdS)aBNext 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. z//@idcSsg|] }| ¡rt|ƒ‘qSr)Úisdigitr4)Ú.0Úid_strrrrÚ Usz%StoryPart.next_id..é)Ú_elementÚxpathÚmax)rÚ id_str_lstÚused_idsrrrr.Ls  zStoryPart.next_idr cCs|j}|dus J‚|jS)z'|DocumentPart| object for this package.N)rÚmain_document_part)rrrrrr%Zs zStoryPart._document_part)rrrr)r!r"r#r rr)r'r(r#r rr")NN)rrr*r+r,r+rr)rr4)rr ) Ú__name__Ú __module__Ú __qualname__Ú__doc__r r&r)r0Úpropertyr.r r%rrrrrs    ü  rN)rCÚ __future__rÚtypingrrrÚdocx.opc.constantsrrÚ docx.opc.partrÚdocx.oxml.shaperÚ docx.sharedr r Údocx.enum.styler Údocx.image.imager Údocx.parts.documentr Údocx.styles.stylerrrrrrÚs