*h*(SrSSKJr SSKJrJrJrJr SSKJ r SSK J r SSK J r SSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SS KJr \(aSSKJr SSK Jr SSK J!r!J"r" SSKJ#r# "SS\5r$"SS5r%g)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)Lengthc^\rSrSrSrSU4Sjjr\R4SSjjrSSSjjr SSjr SSjr \ SSj5r \ RSS j5r S r\ S S j5r\ S!S j5r\ SS j5r\RSSj5rS"SjrS#Sjr\ S$Sj5r\RS%Sj5r\ S&Sj5r\RSSj5r\ S'Sj5r\RS(Sj5rSrU=r$))Runa5Proxy 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. cN>[TU]U5 U=Ul=UlUlgN)super__init___r_elementelement)selfrparent __class__s J/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/text/run.pyr Run.__init__"s%  1222$-$,c ,[RS[RS[RS[RS[R S[R S0Uup#URR5nUbX$l UbX4l gg)zAdd 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 LINEPAGECOLUMNLINE_CLEAR_LEFTLINE_CLEAR_RIGHTLINE_CLEAR_ALLradd_brtypeclear)r break_typetype_r7brs r$ add_break Run.add_break&s MM< MM> OO-  $ $&>  % %'@  # #%<    WW^^   G  H r&cURRXU5nURRU5 [ U5$)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. )partnew_pic_inliner add_drawingr )r image_path_or_streamwidthheightinlines r$ add_pictureRun.add_picture;s8())*>vN F#6""r&c8URR5 g)z[Add a ```` element at the end of the run, which Word interprets as a tab character.N)radd_tabr s r$rH Run.add_tabSs r&cNURRU5n[U5$)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. )radd_t_Text)r textts r$add_text Run.add_textXs GGMM$ Qxr&c.URR$)zRead/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. fontboldrIs r$rURun.boldbsyy~~r&c$XRlgrrSr values r$rUrVls  r&c:URR5 U$)z_Return reference to this run after removing all its content. All run formatting is preserved. )r clear_contentrIs r$r7 Run.clearps  r&c@[URR5$)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. )boolrlastRenderedPageBreaksrIs r$contains_page_breakRun.contains_page_breakxsDGG2233r&c,[UR5$)zsThe |Font| object providing access to the character formatting properties for this run, such as font name and size.)rrrIs r$rTRun.fontsDMM""r&c.URR$)zRead/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. rTitalicrIs r$rf Run.italicsyyr&c$XRlgrrerXs r$rfrgs  r&c# # URRHfn[U[5(aUv M[U[5(a[ X5v MB[U[ 5(dMY[X5v Mh g7f)aGenerate 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)rinner_content_items isinstancestrr rr r)r items r$iter_inner_contentRun.iter_inner_contents^GG//D$$$ D":;;'33D*--d)) 0s A,B2BcpURRU5 URRU5 g)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)r insert_comment_range_start_above,insert_comment_range_end_and_reference_below)r last_run comment_ids r$mark_comment_rangeRun.mark_comment_ranges* 00<  @@Lr&cURRn[[URR U[ R55$)a9Read/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. )rstylerrr> get_styler CHARACTER)r style_ids r$rx Run.styles577==NDII$7$7-BYBY$Z[[r&cxURRU[R5nX Rlgr)r> get_style_idr rzrrx)r style_or_namer{s r$rxr|s'99))-9P9PQ  r&c.URR$)aString 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. rrNrIs r$rNRun.texts ww||r&c$XRlgrr)r rNs r$rNrs  r&c.URR$)a[The 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. rT underlinerIs r$r Run.underlines$yy"""r&c$XRlgrrrXs r$rrs # r&)rrr)r!rr"zt.ProvidesStoryPart)r8r r()rAzstr | IO[bytes]rBint | Length | NonerCrreturnr )rNone)rNrl)r bool | None)rYr)rr^)rr)rz+Iterator[str | Drawing | RenderedPageBreak])rsrrtintrr)rr)rzstr | CharacterStyle | None)rrl)rbool | WD_UNDERLINE | None)rYr)__name__ __module__ __qualname____firstlineno____doc__rr r/r;rErHrPpropertyrUsetterr7r`rTrfrnrurxrNr__static_attributes__ __classcell__r#s@r$rrsp308}}0&*&* #-###$ #  #0  [[ 4 4##    ]]!!*. M \ \ \\!!" [[##&$$r&rc0^\rSrSrSrSU4SjjrSrU=r$)rMz&Proxy object wrapping `` element.c6>[[U] 5 Xlgr)rrMr_t)r t_elmr#s r$r_Text.__init__s eT#%r&)r)rr)rrrrrrrrrs@r$rMrMs0r&rM)&r __future__rtypingrrrr docx.drawingrdocx.enum.styler docx.enum.textr docx.oxml.drawingr docx.oxml.text.pagebreakr docx.shaper docx.sharedrdocx.styles.stylerdocx.text.fontrdocx.text.pagebreakr docx.typestypesrOrdocx.oxml.text.runrrrrrMr&r$rsWC"44 )#(="",1+0"`$*`$Fr&