hi8OjdZddlmZddlZddlmZmZmZddlm 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-erddl.m/Z/Gdde"Z0Gdde"Z1Gdde"Z2Gdde"Z3Gdde"Z4Gdde"Z5Gdde"Z6Gdde"Z7Gdd e"Z8Gd!d"e"Z9Gd#d$e"Z:Gd%d&e"Z;Gd'd(e"Zz6CT_RegularTextRun._escape_ctrl_chars..Lsy3u{{[\~~K^K^?^r9)resub)r?s r8r=z$CT_RegularTextRun._escape_ctrl_charsDsv/1^1^`abbbr9Nr1r2)r:r2)r?r2r1r2)__name__ __module__ __qualname____doc____annotations__r!r/rr0propertyr6setter staticmethodr=r9r8r'r'/s$$<<<<-6YH...C'u--A---- X  [555[5ccc\cccr9r'c@eZdZUdZded<ded<edZded<ed Zd ed <d Z e ddZ e ddZ e dZe ddZe dZe dZdZe dZe dZe dZdS) 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:bodyPrCT_TextBodyPropertiesbodyPrza:pCT_TextParagraphpcD|jD]}||dS)zRemove all `a:p` children, but leave any others. cf. lxml `_Element.clear()` method which removes all children. N)rVremove)r7rZs r8 clear_contentzCT_TextBody.clear_content]s0   A KKNNNN  r9r1CT_TextCharacterPropertiescp|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)rVget_or_add_pPrget_or_add_defRPr)r7rZpPrdefRPrs r8rczCT_TextBody.defRPres6 JqM  &&(( r9boolc|j}t|dkrdS|std|djdkrdSdS)z5True if only a single empty `a:p` element is present.rBFz#p:txBody must have at least one a:prr4T)rVlenr r6)r7pss r8is_emptyzCT_TextBody.is_emptyqsRZ r77Q;;5 I!"GHH H a5:  5tr9cL|}t|}|S)z%Return a new `p:txBody` element tree.) _txBody_tmplr clsxmltxBodys r8newzCT_TextBody.news%  3 r9cr|}ttt|}|S)zwReturn a new `a:txBody` element tree. Suitable for use in a table cell and possibly other situations. )_a_txBody_tmplrrTr rks r8 new_a_txBodyzCT_TextBody.new_a_txBodys/   ""k9S>>22 r9cH|}t|S)zLReturn a new `p:txBody` element tree, suitable for use in an `p:sp` element.)_p_txBody_tmplr )rlrms r8 new_p_txBodyzCT_TextBody.new_p_txBodys!  ""~~r9cJdtddz}t|}|S)zuReturn a `c:txPr` element tree. Suitable for use in a chart object like data labels or tick labels. zp carr )rlrmtxPrs r8new_txPrzCT_TextBody.new_txPrs/  C   ~~ r9cbt|jdkrdS|dS)zEnsure p:txBody has at least one a:p child. Intuitively, reverse a ".clear_content()" operation to minimum conformance with spec (single empty paragraph). rN)rfrVrUr7s r8unclear_contentzCT_TextBody.unclear_contents- tz??Q   F r9c&dtdzS)Nz1 rxrrls r8rqzCT_TextBody._a_txBody_tmplsOSZ[^S_S_``r9c(dtddzS)Nz1 rZrxrrs r8rtzCT_TextBody._p_txBody_tmpls MPWX[]`PaPa b r9c(dtddzS)NzA rxrZrrs r8rjzCT_TextBody._txBody_tmpls   'sC00  2 r9N)r1r^)r1rd)r1rT)rJrKrLrMrNrrXrrZr]rOrcrh classmethodrorrrur{r~rqrtrjrRr9r8rTrTOs *)))!!!!$1M%%F$)E**A****   X    X [ [[ [&aa[a  [   [   r9rTc eZdZUdZded<ded<ded<ded<d ed <d ed <d ed <eedededfdZede e dZ ded<ede e dZ ded<ede e dZ ded<ede e dZded<edeZded<edeZded<edZejd$d"Zd#S)%rWz `a:bodyPr` custom element class.zCallable[[], BaseOxmlElement]_add_noAutofitz"Callable[[], CT_TextNormalAutofit]_add_normAutofit_add_spAutoFitCallable[[], None]_remove_eg_textAutoFitBaseOxmlElement | None noAutofitzCT_TextNormalAutofit | None normAutofit spAutoFitz a:noAutofitz a:normAutofitz a:spAutoFit)z a:scene3dza:sp3dza:flatTxa:extLstr,lInsi0edefaultr$tInsirInsbInsanchorzMSO_VERTICAL_ANCHOR | Nonewrap str | Nonecx|j tjS|j tjS|j tjSdS)zTThe autofit setting for the text frame, a member of the `MSO_AUTO_SIZE` enumeration.N)rrNONErTEXT_TO_FIT_SHAPErSHAPE_TO_FIT_TEXTr}s r8autofitzCT_TextBodyProperties.autofits= > % % %   ' 2 2 > % 2 2tr9r:MSO_AUTO_SIZE | NonecL||tvrtd|||tjkr|dS|tjkr|dS|tjkr|dSdS)Nzmonly None or a member of the MSO_AUTO_SIZE enumeration can be assigned to CT_TextBodyProperties.autofit, got ) r ValueErrorrrrrrrrr>s r8rzCT_TextBodyProperties.autofits  m!;!;?7<??  ##%%% M& & &    ! ! ! ! ! m5 5 5  ! ! # # # # # m5 5 5    ! ! ! ! !6 5r9N)r:r)rJrKrLrMrNr"reg_textAutoFitrrr#rrrrr rrrrOrrPrRr9r8rWrWs:**111188881111....%%%%,,,,%%%%$_    7 7 9N9NOBN%$UD%$UD%$UD%$UD*;):%**F)(#DX ^ " " "^ " " "r9rWc eZdZUdZded<ded<ded<ded<eed ed ed ed ed edfdZeddZ ded<eddZ ded<e de Z ded<e deZded<e deZded<e deZded<e d eZd!ed <d"Zd)d'Zd(S)*r^zCustom 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_latinr _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:uFilla:latina:eaa:csa:sym a:hlinkClicka:hlinkMouseOvera:rtlrr,r)rrrrrrrzCT_TextFont | Nonelatinr)rrrzCT_Hyperlink | None hlinkClicklangzMSO_LANGUAGE_ID | Noneszz int | Nonebz bool | NoneiuzMSO_TEXT_UNDERLINE_TYPE | Nonec(tjSr<)r new_gradFillr}s r8 _new_gradFillz(CT_TextCharacterProperties._new_gradFillIs(5777r9rIdr2r1r%c<|}||_|S)zEAdd an `a:hlinkClick` child element with r:id attribute set to `rId`.)rr)r7rrs r8add_hlinkClickz)CT_TextCharacterProperties.add_hlinkClickLs //11  r9N)rr2r1r%)rJrKrLrMrNr"reg_fillPropertiesr!rrrrrrrrrrr rrrrRr9r8r^r^s 6555////%%%%****' F:   F= ! ! F< F< F< F;     6!*   ! ! !E    '0i#L'''J$5#4$$D'& oB'&sJ77A7777&&sJ77A7777(9(9 $))A888r9r^c~eZdZUdZded<eddZded<ed d Zd ed <eddZ dS) CT_TextFieldz?`a:fld` field element, for either a slide number or date field.r(r)r*)a:pPrr+r,r.r/r+rRrr0r1r2c*|j}|dS|jpdS)z$The text of the `a:t` child element.Nr4r5)r7r0s r8r6zCT_TextField.text_s! F 92v|r9NrI) rJrKrLrMrNr!r/r0rOr6rRr9r8rrSsII<<<<-6Y,...C!*  "!!!AXr9rc6eZdZUdZedeZded<dS) CT_TextFontzCustom element class for `a:latin`, `a:ea`, `a:cs`, and `a:sym`. These occur as child elements of CT_TextCharacterProperties, e.g. `a:rPr`. typefacer2N)rJrKrLrMrrrrNrRr9r8rrhsM &%OHr9rcNeZdZUdZded<eddZedZdS) CT_TextLineBreakz`a:br` line break elementr(r)r*rRr,cdS)zUnconditionally a single vertical-tab character. A line break element can contain no text other than the implicit line feed it represents.  rRr}s r8r6zCT_TextLineBreak.textzs tr9N) rJrKrLrMrNr!r/rOr6rRr9r8rrssU##<<<< )G + + +C Xr9rc.eZdZdZededZdS)CT_TextNormalAutofitzI`a:normAutofit` element specifying fit text to shape font reduction, etc. fontScalegY@rN)rJrKrLrMrrrrRr9r8rrs3SS!!;UIIIr9rceZdZUdZded<ded<ded<ded <d ed <ed d Zded<eddZeddZ eddZ ded<d&dZ d'd(dZ d)d!Z ed*d#Zed+d$Zd%ZdS),rYz`a:p` custom element classr(get_or_add_endParaRPrz(Callable[[], CT_TextParagraphProperties]r`zlist[CT_RegularTextRun]r_lstzCallable[[], CT_TextLineBreak]_add_brzCallable[[], CT_RegularTextRun]_add_rr)a:ra:brza:fld a:endParaRPrr,z!CT_TextParagraphProperties | Nonerbr)rrrrRr. endParaRPrr1rc*|S)z'Return a newly appended `a:br` element.)rr}s r8add_brzCT_TextParagraph.add_brs||~~r9Nr6rr'c@|}|r||_|S)z&Return a newly appended `a:r` element.)rr6)r7r6rs r8add_rzCT_TextParagraph.add_rs# KKMM  AFr9r2cttjd|D]6\}}|dkr||r||7dS)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) enumeraterGsplitrr)r7r6idxr_strs r8 append_textzCT_TextParagraph.append_textsf$BHWd$;$;<< " "JCQww  " 5!!!  " "r9?tuple[CT_RegularTextRun | CT_TextLineBreak | CT_TextField, ...]c4td|DS)zSequence containing text-container child elements of this `a:p` element. These include `a:r`, `a:br`, and `a:fld`. c3^K|](}t|tttf$|V)dSr<) isinstancer'rr).0es r8 z4CT_TextParagraph.content_children..sO  z!.?AQS_-`aa       r9)tupler}s r8content_childrenz!CT_TextParagraph.content_childrens2         r9cJdd|jDS)z%str text contained in this paragraph.r4cg|] }|j SrR)r6)rchilds r8 z)CT_TextParagraph.text..sFFFu FFFr9)joinrr}s r8r6zCT_TextParagraph.texts(wwFF0EFFFGGGr9cDdtdz}t|S)Nzrxry)r7r_xmls r8_new_rzCT_TextParagraph._new_rs &5r9)r1rr<)r6rr1r')r6r2)r1rrI)rJrKrLrMrNr!rbr rbrrrrrrOrr6rrRr9r8rYrYsw$$CCCC<<<<""""++++++++-6YD...C  5%6777A F'8 9 9 9B4=I2555J""""    X HHHXH      r9rYc$eZdZUdZded<ded<ded<ded<ded <ded <ded <d Zed eddZded<ededdZded<ededdZ ded<ededdZ ded<e de dZ d ed<e d!eZd"ed!<[ed-d%Zejd.d'Zed/d)Zejd0d*Zed+Zejd0d,ZdS)1CT_TextParagraphPropertiesz`a:pPr` custom element class.r(razCallable[[], CT_TextSpacing] _add_lnSpc _add_spcAft _add_spcBefr _remove_lnSpc_remove_spcAft_remove_spcBef)a:lnSpca:spcBefa:spcAftz a:buClrTxza:buClrza:buSzTxz a:buSzPctz a:buSzPtsz a:buFontTxza:buFontza:buNonez a:buAutoNumza:buCharza:buBlipza:tabLsta:defRPrrrrBNr,zCT_TextSpacing | NonelnSpcrspcBefrspcAftrr.rclvlrrintalgnzPP_PARAGRAPH_ALIGNMENT | Noner1float | Length | Nonec||j}|dS|j |jjStt|jjS)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)rspcPtsvalrCT_TextSpacingPercentspcPct)r7rs r8 line_spacingz'CT_TextParagraphProperties.line_spacings>  =4 < #<# #)5<88<s r8r z'CT_TextParagraphProperties.line_spacingsx  = F eV $ $ 0 OO   ( ( / / / / / OO   ( ( / / / / /r9 Length | Nonec<|j}|dS|j}|dS|jS)zJThe EMU equivalent of the centipoints value in `./a:spcAft/a:spcPts/@val`.N)rrr)r7rrs r8 space_afterz&CT_TextParagraphProperties.space_after. >4 >4zr9c||)||dSdSr<)rrr r>s r8rz&CT_TextParagraphProperties.space_after$H         ) )% 0 0 0 0 0  r9c<|j}|dS|j}|dS|jS)zJThe EMU equivalent of the centipoints value in `./a:spcBef/a:spcPts/@val`.N)rrr)r7rrs r8 space_beforez'CT_TextParagraphProperties.space_before*rr9c||)||dSdSr<)rrr r>s r8rz'CT_TextParagraphProperties.space_before5rr9)r1r)r:r)r1r)r:r)rJrKrLrMrN_tag_seqr!rrrrcrrrr rrOr rPrrrRr9r8rrs''????,,,,--------%%%%&&&&&&&&H&$-9hqrrl$$$E%.Ix|%%%F%.Ix|%%%F1: x}111F!  %qC+<*;&++D   = = =X =0000X1111 X111111r9rceZdZUdZded<ded<ded<ded<ed Zd ed <ed Zd ed<ddZddZ 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_spcPtsr_remove_spcPct_remove_spcPtsza:spcPctzCT_TextSpacingPercent | Noner za:spcPtszCT_TextSpacingPoint | Nonerr:floatcd||}||_dS)zjSet spacing to `value` lines, e.g. 1.75 lines. A ./a:spcPts child is removed if present. N)rrr)r7r:r s r8r zCT_TextSpacing.set_spcPctMs2 '')) r9r$cd||}||_dS)zHSet spacing to `value` points. A ./a:spcPct child is removed if present.N)rrr)r7r:rs r8r zCT_TextSpacing.set_spcPtsVs0 '')) r9N)r:r)r:r$) rJrKrLrMrNr!r rr r rRr9r8rr<sBB::::8888&&&&&&&&,59,,F*3**Fr9rc6eZdZUdZedeZded<dS)rzZ`a:spcPct` element, specifying spacing in thousandths of a percent in its `val` attribute.rrN)rJrKrLrMrrrrNrRr9r8rr]sHdd"" 3Cr9rc6eZdZUdZedeZded<dS)CT_TextSpacingPointzM`a:spcPts` element, specifying spacing in centipoints in its `val` attribute.rr$N)rJrKrLrMrrrrNrRr9r8r#r#esHWW## "Cr9r#)=rM __future__rrGtypingrrrpptx.enum.langrpptx.enum.textrr r r pptx.excr pptx.oxmlr pptx.oxml.dml.fillr pptx.oxml.nsrpptx.oxml.simpletypesrrrrrrrrrpptx.oxml.xmlchemyrrrrrrr r!r" pptx.utilr#r$pptx.oxml.actionr%r'rTrWr^rrrrrYrrrr#rRr9r8r0s?::"""""" 0000000000****** %$$$$$888888                                             "!!!!!!!.------cccccccc@w w w w w /w w w t;";";";";"O;";";"|IIIIIIIIX?*/"?? ? ? ? ? ? ? ? Dk1k1k1k1k1k1k1k1\_BO/r9