o `TL@sxdZddlmZmZmZddlmZddlmZddl m Z ddl m Z dd l mZGd d d eZGd d d eZdS)z? Run-related proxy objects for python-docx, Run in particular. )absolute_importprint_functionunicode_literals) WD_STYLE_TYPE)WD_BREAK)Font) InlineShape)ParentedcseZdZdZfddZejfddZd ddZd d Z d d Z e d dZ e j ddZ ddZe ddZe ddZej ddZe ddZej ddZe ddZej ddZe ddZej ddZZS)!RunaO Proxy 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. cs&tt||||_|_|_dSN)superr __init___r_elementelement)selfrparent __class__=D:\Projects\ConvertPro\env\Lib\site-packages\docx\text\run.pyrsz Run.__init__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)ZpageN)columnN) textWrappingleft)rright)rallN) rLINEZPAGEZCOLUMNZLINE_CLEAR_LEFTZLINE_CLEAR_RIGHTZLINE_CLEAR_ALLrZadd_brtypeclear)rZ break_typetype_r"brrrr add_breaks  z Run.add_breakNcCs$|j|||}|j|t|S)a Return an |InlineShape| instance containing the image identified by *image_path_or_stream*, 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 )rZimage_path_or_streamwidthheightinlinerrr add_picture1s zRun.add_picturecCs|jdS)zu Add a ```` element at the end of the run, which Word interprets as a tab character. N)rZ_add_tabrrrradd_tabBsz Run.add_tabcCs|j|}t|S)a Returns 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)rtexttrrradd_textIs z Run.add_textcC|jjS)zK Read/write. Causes the text of the run to appear in bold. fontboldr+rrrr4SszRun.boldcC ||j_dSr r2rvaluerrrr4Z cCs|j|S)zw Return reference to this run after removing all its content. All run formatting is preserved. )r clear_contentr+rrrr"^s z Run.clearcCs t|jS)z The |Font| object providing access to the character formatting properties for this run, such as font name and size. )r rr+rrrr3fs zRun.fontcCr1)zs Read/write tri-state value. When |True|, causes the text of the run to appear in italics. r3italicr+rrrr;nsz Run.italiccCr5r r:r6rrrr;vr8cCs|jj}|j|tjS)aj 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. )rstyler&Z get_styler CHARACTER)rstyle_idrrrr<zs z Run.stylecCs|j|tj}||j_dSr )r&Z get_style_idrr=rr<)rZ style_or_namer>rrrr<s cCr1)a String formed by concatenating the text equivalent of each run content child element into a Python string. 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. All ```` elements translate to a single ``\n`` character regardless of their type. 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+rrrr.szRun.textcCr5r r?)rr.rrrr.r8cCr1)a The underline style for this |Run|, one of |None|, |True|, |False|, or a value from :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. r3 underliner+rrrrAs z Run.underlinecCr5r r@r6rrrrAr8r)__name__ __module__ __qualname____doc__rrr r%r*r,r0propertyr4setterr"r3r;r<r.rA __classcell__rrrrr s<            r cs eZdZdZfddZZS)r-z2 Proxy object wrapping ```` element. cstt|||_dSr )rr-rZ_t)rZt_elmrrrrs z_Text.__init__)rBrCrDrErrHrrrrr-sr-N)rEZ __future__rrrZ enum.stylerZ enum.textrr3r shaper sharedr r objectr-rrrrs     *