o P+ i*(@sdZddlmZddlmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZerlddlmZddl mZddl m!Z!m"Z"ddlm#Z#GdddeZ$GdddZ%dS)z=Run-related proxy objects for python-docx, Run in particular.) annotations)IO TYPE_CHECKINGIteratorcast)Drawing) WD_STYLE_TYPE)WD_BREAK) CT_Drawing)CT_LastRenderedPageBreak) InlineShape) StoryChild)CharacterStyle)Font)RenderedPageBreakN) WD_UNDERLINE)CT_RCT_Text)Lengthcs$eZdZdZdBfdd ZejfdCd d Z dDdEddZdFddZ dGddZ e dHddZ e j dId!dZ d"d#Ze dJd%d&Ze dKd(d)Ze dHd*d+Zej dId,d+ZdLd.d/ZdMd3d4Ze dNd6d7Zej dOd:d7Ze dPd;d<Zej dGd=d<Ze dQd?d@Zej dRdAd@ZZS)SRunaIProxy object wrapping `` element. Several of the properties on Run take a tri-state value, |True|, |False|, or |None|. |True| and |False| correspond to on and off respectively. |None| indicates the property is not specified directly on the run and its effective value is taken from the style hierarchy. rrparentt.ProvidesStoryPartcs"t|||_|_|_dSN)super__init___r_elementelement)selfrr __class__Y/home/app/PaddleOCR-VL-test/.venv_paddleocr/lib/python3.10/site-packages/docx/text/run.pyr"s z Run.__init__ break_typer c Cs^tjdtjdtjdtjdtjdtjdi|\}}|j}|dur$||_ |dur-||_ dSdS)a Add a break element of `break_type` to this run. `break_type` can take the values `WD_BREAK.LINE`, `WD_BREAK.PAGE`, and `WD_BREAK.COLUMN` where `WD_BREAK` is imported from `docx.enum.text`. `break_type` defaults to `WD_BREAK.LINE`. NN)pageN)columnN) textWrappingleft)r(right)r(allN) r LINEZPAGEZCOLUMNZLINE_CLEAR_LEFTZLINE_CLEAR_RIGHTZLINE_CLEAR_ALLrZadd_brtypeclear)rr$type_r.brr"r"r# add_break&s  z Run.add_breakNimage_path_or_streamstr | IO[bytes]widthint | Length | Noneheightreturnr cCs$|j|||}|j|t|S)aReturn |InlineShape| containing image identified by `image_path_or_stream`. The picture is added to the end of this run. `image_path_or_stream` can be a path (a string) or a file-like object containing a binary image. If neither width nor height is specified, the picture appears at its native size. If only one is specified, it is used to compute a scaling factor that is then applied to the unspecified dimension, preserving the aspect ratio of the image. The native size of the picture is calculated using the dots- per-inch (dpi) value specified in the image file, defaulting to 72 dpi if no value is specified, as is often the case. )partZnew_pic_inlinerZ add_drawingr )rr2r4r6inliner"r"r# add_picture;s zRun.add_pictureNonecCs|jdS)zcAdd a ```` element at the end of the run, which Word interprets as a tab character.N)radd_tabrr"r"r#r<Ssz Run.add_tabtextstrcCs|j|}t|S)zReturns a newly appended |_Text| object (corresponding to a new ```` child element) to the run, containing `text`. Compare with the possibly more friendly approach of assigning text to the :attr:`Run.text` property. )rZadd_t_Text)rr>tr"r"r#add_textXs z Run.add_text bool | NonecC|jjS)aRead/write tri-state value. When |True|, causes the text of the run to appear in bold face. When |False|, the text unconditionally appears non-bold. When |None| the bold setting for this run is inherited from the style hierarchy. fontboldr=r"r"r#rGbzRun.boldvaluecC ||j_dSrrErrIr"r"r#rGl cCs|j|S)zoReturn reference to this run after removing all its content. All run formatting is preserved. )r clear_contentr=r"r"r#r.ps z Run.clearboolcCs t|jjS)a`True` when one or more rendered page-breaks occur in this run. Note that "hard" page-breaks inserted by the author are not included. A hard page-break gives rise to a rendered page-break in the right position so if those were included that page-break would be "double-counted". It would be very rare for multiple rendered page-breaks to occur in a single run, but it is possible. )rNrZlastRenderedPageBreaksr=r"r"r#contains_page_breakxs zRun.contains_page_breakrcCs t|jS)z{The |Font| object providing access to the character formatting properties for this run, such as font name and size.)rrr=r"r"r#rFs zRun.fontcCrD)a Read/write tri-state value. When |True|, causes the text of the run to appear in italics. When |False|, the text unconditionally appears non-italic. When |None| the italic setting for this run is inherited from the style hierarchy. rFitalicr=r"r"r#rQrHz Run.italiccCrJrrPrKr"r"r#rQrL+Iterator[str | Drawing | RenderedPageBreak]ccsT|jjD]"}t|tr|Vqt|trt||Vqt|tr't||VqdS)a'Generate the content-items in this run in the order they appear. NOTE: only content-types currently supported by `python-docx` are generated. In this version, that is text and rendered page-breaks. Drawing is included but currently only provides access to its XML element (CT_Drawing) on its `._drawing` attribute. `Drawing` attributes and methods may be expanded in future releases. There are a number of element-types that can appear inside a run, but most of those (w:br, w:cr, w:noBreakHyphen, w:t, w:tab) have a clear plain-text equivalent. Any contiguous range of such elements is generated as a single `str`. Rendered page-break and drawing elements are generated individually. Any other elements are ignored. N)rZinner_content_items isinstancer?r rr r)ritemr"r"r#iter_inner_contents     zRun.iter_inner_contentlast_run comment_idintcCs|j||j|dS)zMark the range of runs from this run to `last_run` (inclusive) as belonging to a comment. `comment_id` identfies the comment that references this range. N)rZ insert_comment_range_start_aboveZ,insert_comment_range_end_and_reference_below)rrVrWr"r"r#mark_comment_ranges zRun.mark_comment_rangercCs|jj}tt|j|tjS)aaRead/write. A |CharacterStyle| object representing the character style applied to this run. The default character style for the document (often `Default Character Font`) is returned if the run has no directly-applied character style. Setting this property to |None| removes any directly-applied character style. )rstylerrr8 get_styler CHARACTER)rstyle_idr"r"r#rZs z Run.style style_or_namestr | CharacterStyle | NonecCs|j|tj}||j_dSr)r8Z get_style_idrr\rrZ)rr^r]r"r"r#rZs cCrD)a"String formed by concatenating the text equivalent of each run. Each `` element adds the text characters it contains. A `` element adds a `\t` character. A `` or `` element each add a `\n` character. Note that a `` element can indicate a page break or column break as well as a line break. Only line-break `` elements translate to a `\n` character. Others are ignored. All other content child elements, such as ``, are ignored. Assigning text to this property has the reverse effect, translating each `\t` character to a `` element and each `\n` or `\r` character to a `` element. Any existing run content is replaced. Run formatting is preserved. rr>r=r"r"r#r>szRun.textcCrJrr`)rr>r"r"r#r>rLbool | WD_UNDERLINE | NonecCrD)aThe underline style for this |Run|. Value is one of |None|, |True|, |False|, or a member of :ref:`WdUnderline`. A value of |None| indicates the run has no directly-applied underline value and so will inherit the underline value of its containing paragraph. Assigning |None| to this property removes any directly-applied underline value. A value of |False| indicates a directly-applied setting of no underline, overriding any inherited value. A value of |True| indicates single underline. The values from :ref:`WdUnderline` are used to specify other outline styles such as double, wavy, and dotted. rF underliner=r"r"r#rcsz Run.underlinecCrJrrbrKr"r"r#rcrL)rrrr)r$r r%)r2r3r4r5r6r5r7r )r7r;)r>r?)r7rC)rIrC)r7rN)r7r)r7rR)rVrrWrXr7r;)r7r)r^r_)r7r?)r7ra)rIra)__name__ __module__ __qualname____doc__rr r,r1r:r<rBpropertyrGsetterr.rOrFrQrUrYrZr>rc __classcell__r"r"r r#rsH               rcs"eZdZdZdfdd ZZS)r@z&Proxy object wrapping `` element.t_elmrcstt|||_dSr)rr@rZ_t)rrkr r"r#rs z_Text.__init__)rkr)rdrerfrgrrjr"r"r r#r@sr@)&rg __future__rtypingrrrrZ docx.drawingrZdocx.enum.stylerZdocx.enum.textr Zdocx.oxml.drawingr Zdocx.oxml.text.pagebreakr Z docx.shaper Z docx.sharedr Zdocx.styles.stylerZdocx.text.fontrZdocx.text.pagebreakrZ docx.typestypesrArZdocx.oxml.text.runrrrrr@r"r"r"r#s*              d