o
7 h%, @ st d Z ddlmZ ddlmZmZmZ ddlmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZmZmZmZmZmZmZmZ erHdd lmZ G d
d d eZG d d
d
eZ G dd deZ G dd deZ G dd deZ G dd deZ G dd deZ!G dd deZ"G dd deZ#G d d d eZ$G d d d eZ%G d d! d!eZ&G d"d# d#eZ'G d$d% d%eZ(d&S )'zBSlide-related custom element classes, including those for masters. ) annotations)
TYPE_CHECKINGCallablecast)parse_from_template parse_xml)CT_GradientFillPropertiesnsdecls) XsdString)BaseOxmlElementChoice
OneAndOnlyOneOptionalAttributeRequiredAttribute
ZeroOrMore ZeroOrOneZeroOrOneChoice)
CT_GroupShapec @ s( e Zd ZU dZded< ed ddZdS )
_BaseSlideElementz=Base class for the six slide types, providing common methods.CT_CommonSlideDatacSldreturnr c C | j jS )z-Return required `p:cSld/p:spTree` grandchild.)r spTreeself r W/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/oxml/slide.pyr z_BaseSlideElement.spTreeN)r r )__name__
__module__ __qualname____doc____annotations__propertyr r r r r r s
r c @ sH e Zd ZU dZded< dZedddZded < ed
ddZ[d d Z d
S )
CT_Backgroundz`p:bg` element.z)Callable[[CT_BackgroundProperties], None] _insert_bgPr)p:bgPrp:bgRefr( r
successorsz CT_BackgroundProperties | NonebgPrr) c C s* dt dd }ttt|}| | |S )z5Return a new `p:bgPr` element with noFill properties.z4
ap)r
r CT_BackgroundPropertiesr r' )r xmlr, r r r add_noFill_bgPr3 s
z CT_Background.add_noFill_bgPrN)
r r! r" r# r$ _tag_seqr r, ZbgRefr1 r r r r r& % s
r& c @ sV e Zd ZdZdZeededededededfed d
d Z[d d
Zd
S )r/ z`p:bgPr` element.) a:noFill a:solidFill
a:gradFill
a:blipFill
a:pattFill a:grpFillz a:effectLstz a:effectDagza:extLstr3 r4 r5 r6 r7 r8 Nr* c C s t S )z1Override default to add default gradient subtree.)r new_gradFillr r r r
_new_gradFillV s z%CT_BackgroundProperties._new_gradFill) r r! r" r# r2 r r
eg_fillPropertiesr; r r r r r/ ; s
r/ c @ s~ e Zd ZU dZded< ded< dZededd d
Zd ed < ed
Z ded< [e
de ddZ ded< dddZ
d ddZd S ) r z`p:cSld` element.zCallable[[], None]
_remove_bgzCallable[[], CT_Background]
get_or_add_bg)p:bgp:spTreez
p:custDataLstz
p:controlsp:extLstr? Nr* zCT_Background | Nonebgr@ r r name )defaultstrr r/ c C s, | j }|du s |jdu r| }tt|jS )zReturn `p:bg/p:bgPr` grandchild.
If no such grandchild is present, any existing `p:bg` child is first removed and a new
default `p:bg` with noFill settings is added.
N)rC r, _change_to_noFill_bgr r/ r rC r r r get_or_add_bgPrk s z"CT_CommonSlideData.get_or_add_bgPrr& c C s | | }| |S )zmEstablish a `p:bg` child with no-fill settings.
Any existing `p:bg` child is first removed.
)r= r> r1 rI r r r rH v s z'CT_CommonSlideData._change_to_noFill_bg)r r/ )r r& )r r! r" r# r$ r2 r rC r r r r rD rJ rH r r r r r [ s
r c @ 6 e Zd ZU dZdZedZded< [ed
ddZ d S ) CT_NotesMasterz5`p:notesMaster` element, root of a notes master part.)p:cSldp:clrMapp:hfz p:notesStylerA rM r r r c C t ttdS )zLReturn a new `p:notesMaster` element based on the built-in default template.Z notesMaster)r rL r clsr r r new_default s zCT_NotesMaster.new_defaultN)r rL )
r r! r" r# r2 r r r$ classmethodrS r r r r rL
rL c @ rK )
CT_NotesSlidez.`p:notes` element, root of a notes slide part.)rM p:clrMapOvrrA rM r r r c C rP )zReturn a new ```` element based on the default template.
Note that the template does not include placeholders, which must be subsequently cloned
from the notes master.
Znotes)r rV r rQ r r r new s zCT_NotesSlide.newN)r rV )
r r! r" r# r2 r r r$ rT rX r r r r rV rU rV c @ s e Zd ZU dZdZedZded< ededd d Z ed
ed d d Z
[e dd
dZ e
dd Zdd Zdd Ze
dd Zedd Zedd ZdS ) CT_Slidez=`p:sld` element, root element of a slide part (XML document).)rM rW p:transitionp:timingrA rM r r rW Nr* r[ r c C s t tt| S )z:Return new `p:sld` element configured as base slide shape.)r rY r _sld_xmlrQ r r r rX s z CT_Slide.newc C r )z0Return `p:bg` grandchild or None if not present.)r rC r r r r rC r z CT_Slide.bgc C s | j }|du r | }|S )a Return parent element for a new `p:video` child element.
The `p:video` element causes play controls to appear under a video
shape (pic shape containing video). There can be more than one video
shape on a slide, which causes the precondition to vary. It needs to
handle the case when there is no `p:sld/p:timing` element and when
that element already exists. If the case isn't simple, it just nukes
what's there and adds a fresh one. This could theoretically remove
desired existing timing information, but there isn't any evidence
available to me one way or the other, so I've taken the simple
approach.
N) _childTnLst_add_childTnLst)r Z
childTnLstr r r get_or_add_childTnLst s
z CT_Slide.get_or_add_childTnLstc C s2 | | t| }| | |dd S )zAdd `./p:timing/p:tnLst/p:par/p:cTn/p:childTnLst` descendant.
Any existing `p:timing` child element is ruthlessly removed and
replaced.
z"./p:tnLst/p:par/p:cTn/p:childTnLstr )removeZget_or_add_timingr _childTnLst_timing_xmlZ_insert_timingxpath)r timingr r r r` s
zCT_Slide._add_childTnLstc C s | d}|s dS |d S )z~Return `./p:timing/p:tnLst/p:par/p:cTn/p:childTnLst` descendant.
Return None if that element is not present.
z+./p:timing/p:tnLst/p:par/p:cTn/p:childTnLstNr )rd )r Z childTnLstsr r r r_ s
zCT_Slide._childTnLstc C s dt d S )Nz
r. r r r r r rc s z CT_Slide._childTnLst_timing_xmlc C s dt ddd S )Na
r- r. rr r r r r r^ s
zCT_Slide._sld_xml)r rY )r r! r" r# r2 r r r$ r Z clrMapOvrre rT rX r% rC ra r` r_ staticmethodrc r^ r r r r rY s&
rY c @ s( e Zd ZU dZdZedZded< [dS )CT_SlideLayoutz3`p:sldLayout` element, root of a slide layout part.)rM rW rZ r[ rO rA rM r r N)r r! r" r# r2 r r r$ r r r r rh s
rh c @ s" e Zd ZU dZded< edZdS )CT_SlideLayoutIdListz`p:sldLayoutIdLst` element, child of `p:sldMaster`.
Contains references to the slide layouts that inherit from the slide master.
z list[CT_SlideLayoutIdListEntry]ZsldLayoutId_lstz
p:sldLayoutIdN)r r! r" r# r$ r Z sldLayoutIdr r r r ri s
ri c @ s$ e Zd ZU dZedeZded< dS )CT_SlideLayoutIdListEntryzg`p:sldLayoutId` element, child of `p:sldLayoutIdLst`.
Contains a reference to a slide layout.
zr:idrG rIdN)r r! r" r# r r rk r$ r r r r rj s
rj c @ sL e Zd ZU dZded< dZedZded< eded d
d Z d ed
< [d
S )CT_SlideMasterz3`p:sldMaster` element, root of a slide master part.z"Callable[[], CT_SlideLayoutIdList]Zget_or_add_sldLayoutIdLst)rM rN p:sldLayoutIdLstrZ r[ rO z
p:txStylesrA rM r r rm Nr* ri sldLayoutIdLst)
r r! r" r# r$ r2 r r r ro r r r r rl s
rl c @ s* e Zd ZdZdZededd dZ[dS )CT_SlideTimingz>`p:timing` element, specifying animations and timed behaviors.)p:tnLstzp:bldLstrA rq rB Nr* )r r! r" r# r2 r ZtnLstr r r r rp 0 s
rp c @ s$ e Zd ZdZdd Zedd ZdS )CT_TimeNodeListz%`p:tnLst` or `p:childTnList` element.c C s* dt d| j|f }t|}| | dS )z>Add a new `p:video` child element for movie having *shape_id*.a
r. N)r
_next_cTn_idr append)r shape_idZ video_xmlZvideor r r add_video; s zCT_TimeNodeList.add_videoc C s$ | d}dd |D }t|d S )zR s z0CT_TimeNodeList._next_cTn_id..rB )rd max)r Z cTn_id_strsidsr r r rs N s
z CT_TimeNodeList._next_cTn_idN)r r! r" r# rv r% rs r r r r rr 8 s
rr c @ s e Zd ZdZdZedZ[dS )CT_TLMediaNodeVideoz2`p:video` element, specifying video media details.) p:cMediaNoder~ N)r r! r" r# r2 r Z
cMediaNoder r r r r} V s
r} N))r#
__future__r typingr r r pptx.oxmlr r pptx.oxml.dml.fillr pptx.oxml.nsr
pptx.oxml.simpletypesr pptx.oxml.xmlchemyr r
r r r r r r pptx.oxml.shapes.groupshaper r r& r/ r rL rV rY rh ri rj rl rp rr r} r r r r s0 ( &
_