o 7¾h8Oã@sÌdZddlmZddlZddlmZmZmZddlm Z ddl m Z m Z m Z mZddlmZddlmZdd lmZdd lmZdd lmZmZmZmZmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*dd l+m,Z,m-Z-er|ddl.m/Z/Gdd„de"ƒZ0Gdd„de"ƒZ1Gdd„de"ƒZ2Gdd„de"ƒZ3Gdd„de"ƒZ4Gdd„de"ƒZ5Gdd„de"ƒZ6Gdd„de"ƒZ7Gdd „d e"ƒZ8Gd!d"„d"e"ƒZ9Gd#d$„d$e"ƒZ:Gd%d&„d&e"ƒZ;Gd'd(„d(e"ƒZLóz6CT_RegularTextRun._escape_ctrl_chars..)ÚreÚsub)r;r5r5r6r9Dsz$CT_RegularTextRun._escape_ctrl_charsN©r/r0)r7r0)r;r0r/r0)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú__annotations__r r-rr.Úpropertyr3ÚsetterÚ staticmethodr9r5r5r5r6r%/s ÿ  r%c@sÄeZdZUdZded<ded<edƒZded<ed ƒZd ed <d d „Z e d&dd„ƒZ e d'dd„ƒZ e dd„ƒZe d(dd„ƒZe dd„ƒZe dd„ƒZdd„Ze dd „ƒZe d!d"„ƒZe d#d$„ƒZd%S))Ú CT_TextBodyzg`p:txBody` custom element class. Also used for `c:txPr` in charts and perhaps other elements. zCallable[[], CT_TextParagraph]Úadd_pzlist[CT_TextParagraph]Úp_lstza:bodyPrÚCT_TextBodyPropertiesÚbodyPrza:pÚCT_TextParagraphÚpcCs|jD]}| |¡qdS)zRemove all `a:p` children, but leave any others. cf. lxml `_Element.clear()` method which removes all children. N)rOÚremove)r4rSr5r5r6Ú clear_content]s  ÿzCT_TextBody.clear_contentr/ÚCT_TextCharacterPropertiescCs|jd}| ¡}| ¡}|S)zä`a:defRPr` element of required first `p` child, added with its ancestors if not present. Used when element is a ``c:txPr`` in a chart and the `p` element is used only to specify formatting, not content. r)rOÚget_or_add_pPrÚget_or_add_defRPr)r4rSÚpPrÚdefRPrr5r5r6rZes zCT_TextBody.defRPrÚboolcCs8|j}t|ƒdkr dS|stdƒ‚|djdkrdSdS)z5True if only a single empty `a:p` element is present.r<Fz#p:txBody must have at least one a:prr1T)rOÚlenr r3)r4Zpsr5r5r6Úis_emptyqs zCT_TextBody.is_emptycCs| ¡}t|ƒ}|S)z%Return a new `p:txBody` element tree.)Ú _txBody_tmplr ©ÚclsÚxmlZtxBodyr5r5r6ÚnewszCT_TextBody.newcCs| ¡}ttt|ƒƒ}|S)zwReturn a new `a:txBody` element tree. Suitable for use in a table cell and possibly other situations. )Ú_a_txBody_tmplrrMr r_r5r5r6Ú new_a_txBody†szCT_TextBody.new_a_txBodycCs| ¡}t|ƒS)zLReturn a new `p:txBody` element tree, suitable for use in an `p:sp` element.)Ú_p_txBody_tmplr )r`rar5r5r6Ú new_p_txBodyszCT_TextBody.new_p_txBodycCsdtddƒ}t|ƒ}|S)zuReturn a `c:txPr` element tree. Suitable for use in a chart object like data labels or tick labels. zp ÚcÚa©rr )r`raÚtxPrr5r5r6Únew_txPr–s  ö zCT_TextBody.new_txPrcCst|jƒdkr dS| ¡dS)z´Ensure p:txBody has at least one a:p child. Intuitively, reverse a ".clear_content()" operation to minimum conformance with spec (single empty paragraph). rN)r\rOrN©r4r5r5r6Úunclear_contentªs zCT_TextBody.unclear_contentcCs dtdƒS)Nz1 rhr©r`r5r5r6rc´s zCT_TextBody._a_txBody_tmplcCódtddƒS)Nz1 rSrhrrnr5r5r6re¸s ÿzCT_TextBody._p_txBody_tmplcCro)NzA rhrSrrnr5r5r6r^¾süÿzCT_TextBody._txBody_tmplN)r/rV)r/r[)r/rM)rErFrGrHrIrrQrrSrUrJrZr]Ú classmethodrbrdrfrkrmrcrer^r5r5r5r6rMOs8  ÿ        rMc@seZdZUdZded<ded<ded<ded<d ed <d ed <d ed <eedƒedƒedƒfddZede e dƒdZ ded<ede e dƒdZ ded<ede e dƒdZ ded<ede e dƒdZded<edeƒZded<edeƒZded<edd „ƒZejd%d#d „ƒZd$S)&rPz `a:bodyPr` custom element class.zCallable[[], BaseOxmlElement]Ú_add_noAutofitz"Callable[[], CT_TextNormalAutofit]Ú_add_normAutofitÚ_add_spAutoFitúCallable[[], None]Ú_remove_eg_textAutoFitúBaseOxmlElement | NoneÚ noAutofitzCT_TextNormalAutofit | NoneÚ normAutofitÚ spAutoFitz a:noAutofitz a:normAutofitz a:spAutoFit)z a:scene3dza:sp3dza:flatTxúa:extLstr*ÚlInsi0e©Údefaultr#ÚtInsi˜²ÚrInsÚbInsÚanchorzMSO_VERTICAL_ANCHOR | NoneÚwrapú str | NonecCs4|jdurtjS|jdurtjS|jdurtjSdS)zTThe autofit setting for the text frame, a member of the `MSO_AUTO_SIZE` enumeration.N)rwrÚNONErxÚTEXT_TO_FIT_SHAPEryÚSHAPE_TO_FIT_TEXTrlr5r5r6Úautofitìs   zCT_TextBodyProperties.autofitr7úMSO_AUTO_SIZE | NonecCsl|dur|tvrtd|›ƒ‚| ¡|tjkr| ¡dS|tjkr)| ¡dS|tjkr4| ¡dSdS)Nzmonly None or a member of the MSO_AUTO_SIZE enumeration can be assigned to CT_TextBodyProperties.autofit, got ) rÚ ValueErrorrur„rqr…rrr†rsr:r5r5r6r‡÷sÿÿ      ÿN)r7rˆ)rErFrGrHrIr!rZeg_textAutoFitrrr"r{r~rr€r rrr‚rJr‡rKr5r5r5r6rPÉsF þ ÿ ÿ ÿ ÿ ÿ ÿ  rPc@söeZdZUdZded<ded<ded<ded<eed ƒed ƒed ƒed ƒed ƒedƒfddZedddZ ded<edddZ ded<e de ƒZ ded<e deƒZded<e deƒZded<e deƒZded<e d eƒZd!ed <d"d#„Zd+d(d)„Zd*S),rVzžCustom element class for `a:rPr`, `a:defRPr`, and `a:endParaRPr`. 'rPr' is short for 'run properties', and it corresponds to the |Font| proxy class. zCallable[[], CT_Hyperlink]Úget_or_add_hlinkClickzCallable[[], CT_TextFont]Zget_or_add_latinrtZ _remove_latinZ_remove_hlinkClickza:noFillz a:solidFillz a:gradFillz a:blipFillz a:pattFillz a:grpFill)z a:effectLstz a:effectDagz a:highlightza:uLnTxza:uLnz a:uFillTxza:uFillúa:latinúa:eaúa:csúa:symú a:hlinkClickúa:hlinkMouseOverúa:rtlrzr*r‹)rŒrrŽrrr‘rzzCT_TextFont | NoneÚlatinr)rr‘rzzCT_Hyperlink | NoneÚ hlinkClickÚlangzMSO_LANGUAGE_ID | NoneÚszz int | NoneÚbz bool | NoneÚiÚuzMSO_TEXT_UNDERLINE_TYPE | NonecCst ¡Sr8)r Z new_gradFillrlr5r5r6Ú _new_gradFillIsz(CT_TextCharacterProperties._new_gradFillÚrIdr0r/r$cCs| ¡}||_|S)zEAdd an `a:hlinkClick` child element with r:id attribute set to `rId`.)rŠrš)r4ršr“r5r5r6Úadd_hlinkClickLsz)CT_TextCharacterProperties.add_hlinkClickN)ršr0r/r$)rErFrGrHrIr!rZeg_fillPropertiesr r’r“rrr”rr•rr–r—rr˜r™r›r5r5r5r6rVsH ú÷þ ÿ ÿ ÿ ÿrVc@sPeZdZUdZded<edddZded<ed d dZd ed <eddd„ƒZ dS)Ú CT_TextFieldz?`a:fld` field element, for either a slide number or date field.r&r'r()úa:pPrr)r*r,r-r)r5rvr.r/r0cCs|j}|dur dS|jp dS)z$The text of the `a:t` child element.Nr1r2)r4r.r5r5r6r3_s zCT_TextField.textNrD) rErFrGrHrIr r-r.rJr3r5r5r5r6rœSs ÿÿrœc@ó$eZdZUdZedeƒZded<dS)Ú CT_TextFontz•Custom element class for `a:latin`, `a:ea`, `a:cs`, and `a:sym`. These occur as child elements of CT_TextCharacterProperties, e.g. `a:rPr`. Útypefacer0N)rErFrGrHrrr rIr5r5r5r6rŸhs ÿrŸc@s2eZdZUdZded<edddZedd„ƒZd S) ÚCT_TextLineBreakz`a:br` line break elementr&r'r(r5r*cCsdS)z¤Unconditionally a single vertical-tab character. A line break element can contain no text other than the implicit line feed it represents. ú r5rlr5r5r6r3zszCT_TextLineBreak.textN) rErFrGrHrIr r-rJr3r5r5r5r6r¡ss  r¡c@seZdZdZededdZdS)ÚCT_TextNormalAutofitzI`a:normAutofit` element specifying fit text to shape font reduction, etc.Ú fontScalegY@r|N)rErFrGrHrrr¤r5r5r5r6r£„s  ÿr£c@s¾eZdZUdZded<ded<ded<ded <d ed <ed d dZded<edddZedddZ edddZ ded<d,dd„Z d-d.d d!„Z d/d#d$„Z ed0d&d'„ƒZed1d(d)„ƒZd*d+„ZdS)2rRz`a:p` custom element classr&Zget_or_add_endParaRPrz(Callable[[], CT_TextParagraphProperties]rWzlist[CT_RegularTextRun]Zr_lstzCallable[[], CT_TextLineBreak]Ú_add_brzCallable[[], CT_RegularTextRun]Ú_add_rr)úa:rúa:brza:fldú a:endParaRPrr*z!CT_TextParagraphProperties | NonerYr§)r©r¨r©r5r,Ú endParaRPrr/r¡cCs| ¡S)z'Return a newly appended `a:br` element.)r¥rlr5r5r6Úadd_bržszCT_TextParagraph.add_brNr3rƒr%cCs| ¡}|r ||_|S)z&Return a newly appended `a:r` element.)r¦r3)r4r3Úrr5r5r6Úadd_r¢szCT_TextParagraph.add_rr0cCs<tt d|¡ƒD]\}}|dkr| ¡|r| |¡qdS)aoAppend `a:r` and `a:br` elements to `p` based on `text`. Any ` ` or ` ` (vertical-tab) characters in `text` delimit `a:r` (run) elements and themselves are translated to `a:br` (line-break) elements. The vertical-tab character appears in clipboard text from PowerPoint at "soft" line-breaks (new-line, but not new paragraph). z | rN)Ú enumeraterBÚsplitr«r­)r4r3ÚidxÚr_strr5r5r6Ú append_text©s €úzCT_TextParagraph.append_textú?tuple[CT_RegularTextRun | CT_TextLineBreak | CT_TextField, ...]cCstdd„|DƒƒS)z„Sequence containing text-container child elements of this `a:p` element. These include `a:r`, `a:br`, and `a:fld`. css$|] }t|tttfƒr|VqdSr8)Ú isinstancer%r¡rœ)Ú.0Úer5r5r6Ú ¿s €ÿ ÿz4CT_TextParagraph.content_children..)Útuplerlr5r5r6Úcontent_children¹sÿz!CT_TextParagraph.content_childrencCsd dd„|jDƒ¡S)z%str text contained in this paragraph.r1cSsg|]}|j‘qSr5)r3)rµÚchildr5r5r6Ú ÇrAz)CT_TextParagraph.text..)Újoinr¹rlr5r5r6r3ÃszCT_TextParagraph.textcCsdtdƒ}t|ƒS)Nzrhri)r4Zr_xmlr5r5r6Ú_new_rÉs zCT_TextParagraph._new_r)r/r¡r8)r3rƒr/r%)r3r0)r/r³rD)rErFrGrHrIr rYrr¬Úbrrªr«r­r²rJr¹r3r½r5r5r5r6rRŒs. ÿ  ÿ      rRc@s@eZdZUdZded<ded<ded<ded<ded <ded <ded <d Zed edd…dZded<ededd…dZded<ededd…dZ ded<ededd…dZ ded<e de ddZ d ed<e d!eƒZd"ed!<[ed0d%d&„ƒZejd1d(d&„ƒZed2d*d+„ƒZejd3d,d+„ƒZed-d.„ƒZejd3d/d.„ƒZdS)4ÚCT_TextParagraphPropertiesz`a:pPr` custom element class.r&rXzCallable[[], CT_TextSpacing]Ú _add_lnSpcÚ _add_spcAftÚ _add_spcBefrtÚ _remove_lnSpcÚ_remove_spcAftÚ_remove_spcBef)úa:lnSpcúa:spcBefúa:spcAftz a:buClrTxza:buClrza:buSzTxz a:buSzPctz a:buSzPtsz a:buFontTxza:buFontza:buNonez a:buAutoNumza:buCharza:buBlipza:tabLstúa:defRPrrzrÆr<Nr*zCT_TextSpacing | NoneÚlnSpcrÇéÚspcBefrÈéÚspcAftrÉér,rZÚlvlrr|ÚintÚalgnzPP_PARAGRAPH_ALIGNMENT | Noner/úfloat | Length | NonecCs2|j}|dur dS|jdur|jjStt|jƒjS)a5The spacing between baselines of successive lines in this paragraph. A float value indicates a number of lines. A |Length| value indicates a fixed spacing. Value is contained in `./a:lnSpc/a:spcPts/@val` or `./a:lnSpc/a:spcPct/@val`. Value is |None| if no element is present. N)rÊÚspcPtsÚvalrÚCT_TextSpacingPercentÚspcPct)r4rÊr5r5r6Ú line_spacings  z'CT_TextParagraphProperties.line_spacingr7cCsB| ¡|dur dSt|tƒr| ¡ |¡dS| ¡ |¡dSr8)rÃr´r#rÀÚ set_spcPtsÚ set_spcPctr:r5r5r6rØs  ú Length | NonecCó*|j}|dur dS|j}|durdS|jS)zJThe EMU equivalent of the centipoints value in `./a:spcAft/a:spcPts/@val`.N)rÎrÔrÕ)r4rÎrÔr5r5r6Ú space_afteróz&CT_TextParagraphProperties.space_aftercCó&| ¡|dur| ¡ |¡dSdSr8)rÄrÁrÙr:r5r5r6rÝ$óÿcCrÜ)zJThe EMU equivalent of the centipoints value in `./a:spcBef/a:spcPts/@val`.N)rÌrÔrÕ)r4rÌrÔr5r5r6Ú space_before*rÞz'CT_TextParagraphProperties.space_beforecCrßr8)rÅrÂrÙr:r5r5r6rá5rà)r/rÓ)r7rÓ)r/rÛ)r7rÛ)rErFrGrHrIÚ_tag_seqr rÊrÌrÎrZrrrÐr rÒrJrØrKrÝrár5r5r5r6r¿ÎsR  ÿ ÿ ÿ ÿÿ ÿ      r¿c@sfeZdZUdZded<ded<ded<ded<ed ƒZd ed <ed ƒZd ed<ddd„Zddd„Z dS)ÚCT_TextSpacingz8Used for `a:lnSpc`, `a:spcBef`, and `a:spcAft` elements.z#Callable[[], CT_TextSpacingPercent]Úget_or_add_spcPctz!Callable[[], CT_TextSpacingPoint]Úget_or_add_spcPtsrtÚ_remove_spcPctÚ_remove_spcPtsza:spcPctzCT_TextSpacingPercent | Noner×za:spcPtszCT_TextSpacingPoint | NonerÔr7ÚfloatcCó| ¡| ¡}||_dS)zjSet spacing to `value` lines, e.g. 1.75 lines. A ./a:spcPts child is removed if present. N)rçrärÕ)r4r7r×r5r5r6rÚMs zCT_TextSpacing.set_spcPctr#cCré)zHSet spacing to `value` points. A ./a:spcPct child is removed if present.N)rærårÕ)r4r7rÔr5r5r6rÙVs zCT_TextSpacing.set_spcPtsN)r7rè)r7r#) rErFrGrHrIr r×rÔrÚrÙr5r5r5r6rã<s  ÿ ÿ  rãc@rž)rÖzZ`a:spcPct` element, specifying spacing in thousandths of a percent in its `val` attribute.rÕrèN)rErFrGrHrrrÕrIr5r5r5r6rÖ]ó ÿrÖc@rž)ÚCT_TextSpacingPointzM`a:spcPts` element, specifying spacing in centipoints in its `val` attribute.rÕr#N)rErFrGrHrrrÕrIr5r5r5r6rëerêrë)=rHÚ __future__rrBÚtypingrrrZpptx.enum.langrZpptx.enum.textrrr r Úpptx.excr Ú pptx.oxmlr Úpptx.oxml.dml.fillr Ú pptx.oxml.nsrÚpptx.oxml.simpletypesrrrrrrrrrÚpptx.oxml.xmlchemyrrrrrrrr r!Ú pptx.utilr"r#Úpptx.oxml.actionr$r%rMrPrVrœrŸr¡r£rRr¿rãrÖrër5r5r5r6Ús8      ,,    z>L Bn!