o ãŽj8Oã@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)r4Úpsr5r5r6Úis_emptyqs zCT_TextBody.is_emptycCs| ¡}t|ƒ}|S)z%Return a new `p:txBody` element tree.)Ú _txBody_tmplr ©ÚclsÚxmlÚtxBodyr5r5r6Ú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 )rarbr5r5r6Ú 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 )rarbÚ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 rjr©rar5r5r6re´s zCT_TextBody._a_txBody_tmplcCódtddƒS)Nz1 rSrjrrpr5r5r6rg¸s ÿzCT_TextBody._p_txBody_tmplcCrq)NzA rjrSrrpr5r5r6r_¾süÿzCT_TextBody._txBody_tmplN)r/rV)r/r[)r/rM)rErFrGrHrIrrQrrSrUrJrZr^Ú classmethodrdrfrhrmrorergr_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)ryrÚNONErzÚTEXT_TO_FIT_SHAPEr{ÚSHAPE_TO_FIT_TEXTrnr5r5r6Ú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Ú ValueErrorrwr†rsr‡rtrˆrur:r5r5r6r‰÷sÿÿ      ÿN)r7rŠ)rErFrGrHrIr!rÚeg_textAutoFitrrr"r}r€rr‚r rƒrr„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]Úget_or_add_latinrvÚ _remove_latinÚ_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:rtlr|r*r‘)r’r“r”r•r–r—r|zCT_TextFont | NoneÚlatinr•)r–r—r|zCT_Hyperlink | NoneÚ hlinkClickÚlangzMSO_LANGUAGE_ID | NoneÚszz int | NoneÚbz bool | NoneÚiÚuzMSO_TEXT_UNDERLINE_TYPE | NonecCst ¡Sr8)r Ú new_gradFillrnr5r5r6Ú _new_gradFillIsz(CT_TextCharacterProperties._new_gradFillÚrIdr0r/r$cCs| ¡}||_|S)zEAdd an `a:hlinkClick` child element with r:id attribute set to `rId`.)rr¡)r4r¡r™r5r5r6Úadd_hlinkClickLsz)CT_TextCharacterProperties.add_hlinkClickN)r¡r0r/r$)rErFrGrHrIr!rÚeg_fillPropertiesr r˜r™rrršrr›rrœrrrž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)r5rxr.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. ú r5rnr5r5r6r3zszCT_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&Úget_or_add_endParaRPrz(Callable[[], CT_TextParagraphProperties]rWzlist[CT_RegularTextRun]Úr_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¯rnr5r5r6Ú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..)Útuplernr5r5r6Ú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Ãrnr5r5r6r3ÃszCT_TextParagraph.textcCsdtdƒ}t|ƒS)Nzrjrk)r4Úr_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_spcBefrvÚ _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:defRPrr|rÑ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_spcPtsrvÚ_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ÚtypingrrrÚpptx.enum.langrÚpptx.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!