+
    i*(                       R t ^ RIHt ^ RIHtHtHtHt ^ RIH	t	 ^ RI
Ht ^ RIHt ^ RIHt ^ RIHt ^ RIHt ^ R	IHt ^ R
IHt ^ RIHt ^ RIHt ]'       d   ^ RIHt ^ RIHt ^ RI H!t!H"t" ^ RIH#t#  ! R R]4      t$ ! R R4      t%R# )z=Run-related proxy objects for python-docx, Run in particular.)annotations)IOTYPE_CHECKINGIteratorcast)Drawing)WD_STYLE_TYPE)WD_BREAK)
CT_Drawing)CT_LastRenderedPageBreak)InlineShape)
StoryChild)CharacterStyle)Font)RenderedPageBreakN)WD_UNDERLINE)CT_RCT_Text)Lengthc                  
  a  ] tR t^tRtR V 3R llt]P                  3R R lltR*R R llt	R R	 lt
R
 R lt]R R l4       t]P                  R R l4       tR t]R R l4       t]R R l4       t]R R l4       t]P                  R R l4       tR R ltR R lt]R R l4       t]P                  R R  l4       t]R! R" l4       t]P                  R# R$ l4       t]R% R& l4       t]P                  R' R( l4       tR)tV ;t# )+Runa5  Proxy object wrapping `<w:r>` 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.
c                    V ^8  d   QhRRRR/# )   rr   parentzt.ProvidesStoryPart )formats   "T/Users/agent/.openclaw/workspace/.venv/lib/python3.14/site-packages/docx/text/run.py__annotate__Run.__annotate__"   s     3 3$ 3(; 3    c                	P   < \         SV `  V4       V;V n        ;V n        V n        R # N)super__init___r_elementelement)selfr   r   	__class__s   &&&r   r$   Run.__init__"   s%     1222$-$,r    c                   V ^8  d   QhRR/# )r   
break_typer	   r   )r   s   "r   r   r   &   s      H r    c                <   \         P                  R\         P                  R\         P                  R\         P                  R\         P
                  R\         P                  R/V,          w  r#V P                  P                  4       pVe   W$n	        Ve	   W4n
        R# R# )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`.
NNN)pageN)columnN)textWrappingleft)r1   right)r1   all)r	   LINEPAGECOLUMNLINE_CLEAR_LEFTLINE_CLEAR_RIGHTLINE_CLEAR_ALLr%   add_brtypeclear)r(   r,   type_r=   brs   &&   r   	add_breakRun.add_break&   s     MM<MM>OO-$$&>%%'@##%<
  WW^^GH r    c               (    V ^8  d   QhRRRRRRRR/# )r   image_path_or_streamzstr | IO[bytes]widthzint | Length | Noneheightreturnr   r   )r   s   "r   r   r   ;   s2     # #-# ## $	#
 
#r    c                    V P                   P                  WV4      pV P                  P                  V4       \	        V4      # )a  Return |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.
)partnew_pic_inliner%   add_drawingr   )r(   rC   rD   rE   inlines   &&&& r   add_pictureRun.add_picture;   s8    ( ))*>vNF#6""r    c                   V ^8  d   QhRR/# )r   rF   Noner   )r   s   "r   r   r   S   s       r    c                :    V P                   P                  4        R# )z[Add a ``<w:tab/>`` element at the end of the run, which Word interprets as a
tab character.N)r%   add_tabr(   s   &r   rQ   Run.add_tabS   s     	r    c                   V ^8  d   QhRR/# r   textstrr   )r   s   "r   r   r   X   s      S r    c                N    V P                   P                  V4      p\        V4      # )zReturns a newly appended |_Text| object (corresponding to a new ``<w:t>``
child element) to the run, containing `text`.

Compare with the possibly more friendly approach of assigning text to the
:attr:`Run.text` property.
)r%   add_t_Text)r(   rV   ts   && r   add_textRun.add_textX   s     GGMM$Qxr    c                   V ^8  d   QhRR/# r   rF   bool | Noner   )r   s   "r   r   r   c   s      k r    c                .    V P                   P                  # )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.
fontboldrR   s   &r   rd   Run.boldb   s     yy~~r    c                   V ^8  d   QhRR/# r   valuer`   r   )r   s   "r   r   r   m   s      + r    c                	&    WP                   n        R # r"   rb   r(   rh   s   &&r   rd   re   l   s    		r    c                :    V P                   P                  4        V # )z_Return reference to this run after removing all its content.

All run formatting is preserved.
)r%   clear_contentrR   s   &r   r=   	Run.clearp   s    
 	r    c                   V ^8  d   QhRR/# )r   rF   boolr   )r   s   "r   r   r   y   s     
4 
4T 
4r    c                @    \        V P                  P                  4      # )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.
)ro   r%   lastRenderedPageBreaksrR   s   &r   contains_page_breakRun.contains_page_breakx   s     DGG2233r    c                   V ^8  d   QhRR/# )r   rF   r   r   )r   s   "r   r   r      s     # #d #r    c                ,    \        V P                  4      # )zsThe |Font| object providing access to the character formatting properties for
this run, such as font name and size.)r   r&   rR   s   &r   rc   Run.font   s     DMM""r    c                   V ^8  d   QhRR/# r_   r   )r   s   "r   r   r      s          r    c                .    V P                   P                  # )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.
rc   italicrR   s   &r   rz   
Run.italic   s     yyr    c                   V ^8  d   QhRR/# rg   r   )r   s   "r   r   r      s     ! !K !r    c                	&    WP                   n        R # r"   ry   rj   s   &&r   rz   r{      s     		r    c                   V ^8  d   QhRR/# )r   rF   z+Iterator[str | Drawing | RenderedPageBreak]r   )r   s   "r   r   r      s     * *$O *r    c              #    "   V P                   P                   Fi  p\        V\        4      '       d   Vx  K  \        V\        4      '       d   \        W4      x  KD  \        V\        4      '       g   K\  \        W4      x  Kk  	  R# 5i)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)r%   inner_content_items
isinstancerW   r   r   r
   r   )r(   items   & r   iter_inner_contentRun.iter_inner_content   s^      GG//D$$$
D":;;'33D*--d)) 0s   A.B5Bc               $    V ^8  d   QhRRRRRR/# )r   last_runr   
comment_idintrF   rO   r   )r   s   "r   r   r      s&     
M 
M3 
MC 
MD 
Mr    c                r    V P                   P                  V4       VP                   P                  V4       R# )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(   r   r   s   &&&r   mark_comment_rangeRun.mark_comment_range   s*     	00< 	@@Lr    c                   V ^8  d   QhRR/# )r   rF   r   r   )r   s   "r   r   r      s     	\ 	\~ 	\r    c                    V P                   P                  p\        \        V P                  P                  V\        P                  4      4      # )a9  Read/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.
)r%   styler   r   rH   	get_styler   	CHARACTER)r(   style_ids   & r   r   	Run.style   s5     77==NDII$7$7-BYBY$Z[[r    c                   V ^8  d   QhRR/# )r   style_or_namezstr | CharacterStyle | Noner   )r   s   "r   r   r      s     ! !#> !r    c                	z    V P                   P                  V\        P                  4      pW P                  n        R # r"   )rH   get_style_idr   r   r%   r   )r(   r   r   s   && r   r   r      s'    99))-9P9PQ r    c                   V ^8  d   QhRR/# )r   rF   rW   r   )r   s   "r   r   r      s      c r    c                .    V P                   P                  # )a  String formed by concatenating the text equivalent of each run.

Each `<w:t>` element adds the text characters it contains. A `<w:tab/>` element
adds a `\t` character. A `<w:cr/>` or `<w:br>` element each add a `\n`
character. Note that a `<w:br>` element can indicate a page break or column
break as well as a line break. Only line-break `<w:br>` elements translate to
a `\n` character. Others are ignored. All other content child elements, such as
`<w:drawing>`, are ignored.

Assigning text to this property has the reverse effect, translating each `\t`
character to a `<w:tab/>` element and each `\n` or `\r` character to a
`<w:cr/>` element. Any existing run content is replaced. Run formatting is
preserved.
r%   rV   rR   s   &r   rV   Run.text   s      ww||r    c                   V ^8  d   QhRR/# rU   r   )r   s   "r   r   r      s       r    c                	&    WP                   n        R # r"   r   )r(   rV   s   &&r   rV   r      s    r    c                   V ^8  d   QhRR/# )r   rF   bool | WD_UNDERLINE | Noner   )r   s   "r   r   r      s     # #5 #r    c                .    V P                   P                  # )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.
rc   	underlinerR   s   &r   r   Run.underline   s    $ yy"""r    c                   V ^8  d   QhRR/# )r   rh   r   r   )r   s   "r   r   r      s     $ $9 $r    c                	&    WP                   n        R # r"   r   rj   s   &&r   r   r      s    #		r    )r&   r%   r'   r.   )__name__
__module____qualname____firstlineno____doc__r$   r	   r5   r@   rL   rQ   r\   propertyrd   setterr=   rr   rc   rz   r   r   r   rV   r   __static_attributes____classcell__r)   s   @r   r   r      sG   3 3 08}} *#0
   
[[  
4 
4 # #
     ]]! !*.
M 	\ 	\ \\! !  " 
[[  # #& $ $r    r   c                  2   a  ] tR t^tRtR V 3R lltRtV ;t# )rZ   z&Proxy object wrapping `<w:t>` element.c                   V ^8  d   QhRR/# )r   t_elmr   r   )r   s   "r   r   _Text.__annotate__   s      g r    c                	8   < \         \        V `  4        Wn        R # r"   )r#   rZ   r$   _t)r(   r   r)   s   &&r   r$   _Text.__init__   s    eT#%r    )r   )r   r   r   r   r   r$   r   r   r   s   @r   rZ   rZ      s    0 r    rZ   )&r   
__future__r   typingr   r   r   r   docx.drawingr   docx.enum.styler   docx.enum.textr	   docx.oxml.drawingr
   docx.oxml.text.pagebreakr   
docx.shaper   docx.sharedr   docx.styles.styler   docx.text.fontr   docx.text.pagebreakr   
docx.typestypesr[   r   docx.oxml.text.runr   r   r   r   rZ   r   r    r   <module>r      sW    C " 4 4   ) # ( = " " ,  1+0"`$* `$F r    