o Z*V.@sHdZddlmZmZmZmZddlmZddlm Z Gddde Z dS) z Font-related proxy objects. )absolute_importdivisionprint_functionunicode_literals) ColorFormat) ElementProxyc@seZdZdZdZeddZejddZeddZejddZed d Z ed d Z e jd d Z eddZ e jddZ eddZ e jddZ eddZ e jddZ eddZejddZeddZejddZeddZejddZed d!Zejd"d!Zed#d$Zejd%d$Zed&d'Zejd(d'Zed)d*Zejd+d*Zed,d-Zejd.d-Zed/d0Zejd1d0Zed2d3Zejd4d3Zed5d6Zejd7d6Zed8d9Zejd:d9Zed;d<Zejd=d<Zed>d?Zejd@d?ZedAdBZejdCdBZedDdEZejdFdEZedGdHZejdIdHZedJdKZejdLdKZedMdNZ e jdOdNZ edPdQZ!e!jdRdQZ!dSdTZ"dUdVZ#dWS)XFontz Proxy object wrapping the parent of a ```` element and providing access to character properties such as font name, font size, bold, and subscript. cC |dS)zT Read/write. Causes text in this font to appear in capital letters. caps_get_bool_propselfr r >D:\Projects\ConvertPro\env\Lib\site-packages\docx\text\font.pyall_caps z Font.all_capscC|d|dS)Nr _set_bool_proprvaluer r rrcCr )zI Read/write. Causes text in this font to appear in bold. br rr r rbold#rz Font.boldcCr)Nrrrr r rr*rcCs t|jS)zm A |ColorFormat| object providing a way to get and set the text color for this font. )r_elementrr r rcolor. z Font.colorcCr )z Read/write tri-state value. When |True|, causes the characters in the run to be treated as complex script regardless of their Unicode values. csr rr r rcomplex_script6 zFont.complex_scriptcCr)Nrrrr r rr ?rcCr )z Read/write tri-state value. When |True|, causes the complex script characters in the run to be displayed in bold typeface. bCsr rr r rcs_boldCrz Font.cs_boldcCr)Nr"rrr r rr#KrcCr )z Read/write tri-state value. When |True|, causes the complex script characters in the run to be displayed in italic typeface. iCsr rr r r cs_italicOrzFont.cs_italiccCr)Nr$rrr r rr%WrcCr )z Read/write tri-state value. When |True|, causes the text in the run to appear with double strikethrough. dstriker rr r r double_strike[rzFont.double_strikecCr)Nr&rrr r rr'crcCr )z Read/write tri-state value. When |True|, causes the text in the run to appear as if raised off the page in relief. embossr rr r rr(grz Font.embosscCr)Nr(rrr r rr(orcCr )z Read/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. vanishr rr r rhiddensr!z Font.hiddencCr)Nr)rrr r rr*|rcC|jj}|dur dS|jS)z A member of :ref:`WdColorIndex` indicating the color of highlighting applied, or `None` if no highlighting is applied. N)rrPr highlight_valrr,r r rhighlight_colorszFont.highlight_colorcC|j}||_dSN)rget_or_add_rPrr-rrr,r r rr/  cCr )z Read/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. ir rr r ritalicr!z Font.italiccCr)Nr5rrr r rr6rcCr )z Read/write tri-state value. When |True|, causes the text in the run to appear as if pressed into the page. imprintr rr r rr7rz Font.imprintcCr)Nr7rrr r rr7rcCr )z Read/write tri-state value. When |True|, specifies this run contains WML that should be handled as though it was Office Open XML Math. oMathr rr r rmathrz Font.mathcCr)Nr8rrr r rr9rcCr+)z Get or set the typeface name for this |Font| instance, causing 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)rr, rFonts_asciir.r r rnamesz Font.namecCs|j}||_||_dSr1)rr2r:Z rFonts_hAnsir3r r rr;s  cCr )z Read/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. noProofr rr r rno_proofr!z Font.no_proofcCr)Nr<rrr r rr=rcCr )z Read/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. outliner rr r rr>r!z Font.outlinecCr)Nr>rrr r rr>rcCr )z Read/write tri-state value. When |True| causes the text in the run to have right-to-left characteristics. rtlr rr r rr?rzFont.rtlcCr)Nr?rrr r rr?rcCr )z Read/write tri-state value. When |True| causes the text in the run to appear as if each character has a shadow. shadowr rr r rr@rz Font.shadowcCr)Nr@rrr r rr@rcCr+)a$ Read/write |Length| value or |None|, indicating the font 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)rr,sz_valr.r r rsizesz Font.sizecCr0r1)rr2rA)rZemur,r r rrBr4cCr )z Read/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. smallCapsr rr r r small_capsr!zFont.small_capscCr)NrCrrr r rrDrcCr )z Read/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. snapToGridr rr r r snap_to_grid!r!zFont.snap_to_gridcCr)NrErrr r rrF*rcCr )ud 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. specVanishr rr r r spec_vanish.s zFont.spec_vanishcCr)NrGrrr r rrH9rcCr )z Read/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. striker rr r rrI=r!z Font.strikecCr)NrIrrr r rrIFrcCr+)z Boolean indicating whether the characters in this |Font| appear as subscript. |None| indicates the subscript/subscript value is inherited from the style hierarchy. N)rr, subscriptr.r r rrJJzFont.subscriptcCr0r1)rr2rJr3r r rrJVr4cCr+)z Boolean indicating whether the characters in this |Font| appear as superscript. |None| indicates the subscript/superscript value is inherited from the style hierarchy. N)rr, superscriptr.r r rrL[rKzFont.superscriptcCr0r1)rr2rLr3r r rrLgr4cCr+)a The underline style for this |Font|, one of |None|, |True|, |False|, or a value from :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. N)rr,u_valr.r r r underlinels zFont.underlinecCr0r1)rr2rMr3r r rrN{r4cCr )z Read/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. webHiddenr rr r r web_hiddenr!zFont.web_hiddencCr)NrOrrr r rrPrcCs|jj}|dur dS||S)zM Return the value of boolean child of `w:rPr` having *name*. N)rr,Z _get_bool_val)rr;r,r r rrs zFont._get_bool_propcCs|j}|||dS)zH Assign *value* to the boolean child *name* of `w:rPr`. N)rr2Z _set_bool_val)rr;rr,r r rrs zFont._set_bool_propN)$__name__ __module__ __qualname____doc__ __slots__propertyrsetterrrr r#r%r'r(r*r/r6r7r9r;r=r>r?r@rBrDrFrHrIrJrLrNrPrrr r r rr s                                                      r N) rTZ __future__rrrrZ dml.colorrsharedrr r r r rs