a ]j%5@sdZddlmZddlmZmZddlmZddlm Z ddl m Z m Z erpddlm Z ddlmZdd l mZGd d d e Zd S) zFont-related proxy objects.) annotations) TYPE_CHECKINGAny) ColorFormat) WD_UNDERLINE) ElementProxyEmu)WD_COLOR_INDEX)CT_R)LengthcsdeZdZdZdjdddfdd Zedd d d Zejdd d dd Zedd ddZejdd d ddZeddZ edd ddZ e jdd d ddZ edd ddZ e jdd d ddZ edd ddZ e jdd d ddZ edd ddZ e jdd d ddZ edd d d!Zejdd d d"d!Zedd d#d$Zejdd d d%d$Zed&d d'd(Zejd&d)d*d(Zedd d+d,Zejdd d d-d,Zedd d.d/Zejdd d d0d/Zedd d1d2Zejdd d d3d2Zed4d d5d6Zejd4d d d7d6Zedd d8d9Zejdd d d:d9Zedd d;d<Zejdd d d=d<Zedd d>d?Zejdd d d@d?Zedd dAdBZejdd d dCdBZedDd dEdFZejdGd dHdIdFZedd dJdKZejdd d dLdKZedd dMdNZejdd d dOdNZedd dPdQZejdd d dRdQZedd dSdTZejdd d dUdTZedd dVdWZejdd d dXdWZedd dYdZZejdd d d[dZZed\d d]d^Z e jd\d d d_d^Z edd d`daZ!e!jdd d dbdaZ!dcddddedfZ"dcddgdhdiZ#Z$S)kFontzProxy object for parent of a `` element and providing access to character properties such as font name, font size, bold, and subscript.Nr z Any | None)rparentcst||||_||_dSN)super__init___element_r)selfr r __class__J/var/www/html/assistant/venv/lib/python3.9/site-packages/docx/text/font.pyrsz Font.__init__z bool | None)returncCs |dS)zTRead/write. Causes text in this font to appear in capital letters. caps_get_bool_proprrrrall_capssz Font.all_capsNone)valuercCs|d|dS)Nr_set_bool_proprr rrrr"scCs |dS)zIRead/write. Causes text in this font to appear in bold. brrrrrbold&sz Font.boldcCs|d|dS)Nr$r!r#rrrr%.scCs t|jS)z[A |ColorFormat| object providing a way to get and set the text color for this font.)rrrrrrcolor2sz Font.colorcCs |dS)zRead/write tri-state value. When |True|, causes the characters in the run to be treated as complex script regardless of their Unicode values. csrrrrrcomplex_script8szFont.complex_scriptcCs|d|dS)Nr'r!r#rrrr(AscCs |dS)zRead/write tri-state value. When |True|, causes the complex script characters in the run to be displayed in bold typeface. bCsrrrrrcs_boldEsz Font.cs_boldcCs|d|dS)Nr)r!r#rrrr*NscCs |dS)zRead/write tri-state value. When |True|, causes the complex script characters in the run to be displayed in italic typeface. iCsrrrrr cs_italicRszFont.cs_italiccCs|d|dS)Nr+r!r#rrrr,[scCs |dS)zzRead/write tri-state value. When |True|, causes the text in the run to appear with double strikethrough. dstrikerrrrr double_strike_szFont.double_strikecCs|d|dS)Nr-r!r#rrrr.gscCs |dS)zRead/write tri-state value. When |True|, causes the text in the run to appear as if raised off the page in relief. embossrrrrrr/ksz Font.embosscCs|d|dS)Nr/r!r#rrrr/tscCs |dS)zRead/write tri-state value. When |True|, causes the text in the run to be hidden from display, unless applications settings force hidden text to be shown. vanishrrrrrhiddenxsz Font.hiddencCs|d|dS)Nr0r!r#rrrr1szWD_COLOR_INDEX | NonecCs|jj}|durdS|jS)z:Color of highlighing applied or |None| if not highlighted.N)rrPr highlight_valrr2rrrhighlight_colorszFont.highlight_color)r cCs|j}||_dSr)rget_or_add_rPrr3rr r2rrrr5s cCs |dS)zRead/write tri-state value. When |True|, causes the text of the run to appear in italics. |None| indicates the effective value is inherited from the style hierarchy. irrrrritalicsz Font.italiccCs|d|dS)Nr8r!r#rrrr9scCs |dS)z|Read/write tri-state value. When |True|, causes the text in the run to appear as if pressed into the page. imprintrrrrrr:sz Font.imprintcCs|d|dS)Nr:r!r#rrrr:scCs |dS)zRead/write tri-state value. When |True|, specifies this run contains WML that should be handled as though it was Office Open XML Math. oMathrrrrrmathsz Font.mathcCs|d|dS)Nr;r!r#rrrr<sz str | NonecCs|jj}|durdS|jS)zThe typeface name for this |Font|. Causes the text it controls to appear in the named font, if a matching font is found. |None| indicates the typeface is inherited from the style hierarchy. N)rr2 rFonts_asciir4rrrnamesz Font.namecCs|j}||_||_dSr)rr6r=Z rFonts_hAnsir7rrrr>s cCs |dS)zRead/write tri-state value. When |True|, specifies that the contents of this run should not report any errors when the document is scanned for spelling and grammar. noProofrrrrrno_proofsz Font.no_proofcCs|d|dS)Nr?r!r#rrrr@scCs |dS)zRead/write tri-state value. When |True| causes the characters in the run to appear as if they have an outline, by drawing a one pixel wide border around the inside and outside borders of each character glyph. outlinerrrrrrAsz Font.outlinecCs|d|dS)NrAr!r#rrrrAscCs |dS)z{Read/write tri-state value. When |True| causes the text in the run to have right-to-left characteristics. rtlrrrrrrBszFont.rtlcCs|d|dS)NrBr!r#rrrrBscCs |dS)zRead/write tri-state value. When |True| causes the text in the run to appear as if each character has a shadow. shadowrrrrrrCsz Font.shadowcCs|d|dS)NrCr!r#rrrrCsz Length | NonecCs|jj}|durdS|jS)aFont height in English Metric Units (EMU). |None| indicates the font size should be inherited from the style hierarchy. |Length| is a subclass of |int| having properties for convenient conversion into points or other length units. The :class:`docx.shared.Pt` class allows convenient specification of point values:: >>> font.size = Pt(24) >>> font.size 304800 >>> font.size.pt 24.0 N)rr2sz_valr4rrrsizesz Font.sizezint | Length | None)emurcCs$|j}|durdnt||_dSr)rr6rrD)rrFr2rrrrEs cCs |dS)zRead/write tri-state value. When |True| causes the lowercase characters in the run to appear as capital letters two points smaller than the font size specified for the run. smallCapsrrrrr small_capsszFont.small_capscCs|d|dS)NrGr!r#rrrrH!scCs |dS)zRead/write tri-state value. When |True| causes the run to use the document grid characters per line settings defined in the docGrid element when laying out the characters in this run. snapToGridrrrrr snap_to_grid%szFont.snap_to_gridcCs|d|dS)NrIr!r#rrrrJ.scCs |dS)u\Read/write tri-state value. When |True|, specifies that the given run shall always behave as if it is hidden, even when hidden text is being displayed in the current document. The property has a very narrow, specialized use related to the table of contents. Consult the spec (§17.3.2.36) for more details. specVanishrrrrr spec_vanish2s zFont.spec_vanishcCs|d|dS)NrKr!r#rrrrL=scCs |dS)zRead/write tri-state value. When |True| causes the text in the run to appear with a single horizontal line through the center of the line. strikerrrrrrMAsz Font.strikecCs|d|dS)NrMr!r#rrrrMJscCs|jj}|durdS|jS)zBoolean indicating whether the characters in this |Font| appear as subscript. |None| indicates the subscript/subscript value is inherited from the style hierarchy. N)rr2 subscriptr4rrrrNNszFont.subscriptcCs|j}||_dSr)rr6rNr7rrrrNZs cCs|jj}|durdS|jS)zBoolean indicating whether the characters in this |Font| appear as superscript. |None| indicates the subscript/superscript value is inherited from the style hierarchy. N)rr2 superscriptr4rrrrO_szFont.superscriptcCs|j}||_dSr)rr6rOr7rrrrOls zbool | WD_UNDERLINE | NonecCsH|jj}|durdS|j}|tjkr(dS|tjkr6dS|tjkrDdS|S)aThe underline style for this |Font|. The value is one of |None|, |True|, |False|, or a member of :ref:`WdUnderline`. |None| indicates the font inherits its underline value from the style hierarchy. |False| indicates no underline. |True| indicates single underline. The values from :ref:`WdUnderline` are used to specify other outline styles such as double, wavy, and dotted. NTF)rr2u_valrZ INHERITEDSINGLENONE)rr2valrrr underlineqs zFont.underlinecCs4|j}|durtjn|dur&tjn|}||_dS)NTF)rr6rrQrRrP)rr r2rSrrrrTs cCs |dS)zRead/write tri-state value. When |True|, specifies that the contents of this run shall be hidden when the document is displayed in web page view. webHiddenrrrrr web_hiddenszFont.web_hiddencCs|d|dS)NrUr!r#rrrrVsstr)r>rcCs|jj}|durdS||S)z;Return the value of boolean child of `w:rPr` having `name`.N)rr2Z _get_bool_val)rr>r2rrrrszFont._get_bool_prop)r>r cCs|j}|||dS)z6Assign `value` to the boolean child `name` of `w:rPr`.N)rr6Z _set_bool_val)rr>r r2rrrr"s zFont._set_bool_prop)N)%__name__ __module__ __qualname____doc__rpropertyrsetterr%r&r(r*r,r.r/r1r5r9r:r<r>r@rArBrCrErHrJrLrMrNrOrTrVrr" __classcell__rrrrr s       r N)r[ __future__rtypingrrZdocx.dml.colorrZdocx.enum.textrZ docx.sharedrrr Zdocx.oxml.text.runr r r rrrrs