o 7hI@sdZddlmZddlmZmZmZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZddlmZmZmZddlmZerdd lmZmZdd lmZmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&m'Z'm(Z(dd l)m*Z*ddl+m,Z,m-Z-ddl m.Z.ddl/m0Z0GdddeZ1Gddde1Z2Gddde2Z3Gddde1Z4Gddde1Z5GdddeZ6Gddde1Z7Gdd d eZ8Gd!d"d"e2Z9Gd#d$d$eZ:Gd%d&d&eZ;d'S)(z=Slide-related objects, including masters, layouts, and notes.) annotations) TYPE_CHECKINGIteratorcast) FillFormat)PP_PLACEHOLDER)LayoutPlaceholders LayoutShapesMasterPlaceholders MasterShapesNotesSlidePlaceholdersNotesSlideShapesSlidePlaceholders SlideShapes) ElementProxyParentedElementProxyPartElementProxy) lazyproperty)CT_SlideIdListCT_SlideMasterIdList)CT_CommonSlideData CT_NotesSlideCT_SlideCT_SlideLayoutIdListCT_SlideMaster)PresentationPart)SlideLayoutPartSlideMasterPart SlidePart) Presentation)LayoutPlaceholderMasterPlaceholder)NotesSlidePlaceholder) TextFramec@sFeZdZUdZded<edddZedd d Zej dd d ZdS) _BaseSlidezCBase class for slide objects, including masters, layouts and notes.r_elementreturn _BackgroundcCs t|jjS)a8|_Background| object providing slide background properties. This property returns a |_Background| object whether or not the slide, master, or layout has an explicitly defined background. The same |_Background| object is returned on every call for the same slide object. )r'r%cSldselfr+R/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/slide.py background,s z_BaseSlide.backgroundstrcCs |jjjS)zString representing the internal name of this slide. Returns an empty string (`''`) if no name is assigned. Assigning an empty string or |None| to this property causes any name to be removed. r%r(namer)r+r+r,r08s z_BaseSlide.namevalue str | NonecCs|durdn|}||jj_dS)Nr/)r*r1 new_valuer+r+r,r0AsN)r&r')r&r.)r1r2) __name__ __module__ __qualname____doc____annotations__rr-propertyr0setterr+r+r+r,r$'s   r$c@s*eZdZdZed ddZeddZdS) _BaseMasterzBase class for master objects such as |SlideMaster| and |NotesMaster|. Provides access to placeholders and regular shapes. r&r cCt|jj|S)zw|MasterPlaceholders| collection of placeholder shapes in this master. Sequence sorted in `idx` order. )r r%spTreer)r+r+r, placeholdersMz_BaseMaster.placeholderscCr=)zr Instance of |MasterShapes| containing sequence of shape objects appearing on this slide. )r r%r>r)r+r+r,shapesUr@z_BaseMaster.shapesN)r&r )r5r6r7r8rr?rAr+r+r+r,r<Gs  r<c@seZdZdZdS) NotesMasterzProxy for the notes master XML document. Provides access to shapes, the most commonly used of which are placeholders. N)r5r6r7r8r+r+r+r,rB^srBc@s\eZdZUdZded<ddd Zedd d ZedddZe dddZ e dddZ dS) NotesSlidezxNotes slide object. Provides access to slide notes placeholder and other shapes on the notes handout page. relement notes_masterrBr&Nonecs4dfdd }|j}|D] }|td|q dS)a3Selectively add placeholder shape elements from `notes_master`. Selected placeholder shape elements from `notes_master` are added to the shapes collection of this notes slide. Z-order of placeholders is preserved. Certain placeholders (header, date, footer) are not cloned. r&Iterator[MasterPlaceholder]c3s4tjtjtjf}jD] }|jj|vr|Vq dS)zGenerate a reference to each cloneable placeholder in `notes_master`. These are the placeholders that should be cloned to a notes slide when the a new notes slide is created. N)r SLIDE_IMAGEBODY SLIDE_NUMBERr?rDph_type)Z cloneable placeholderrEr+r,iter_cloneable_placeholdersvs  zINotesSlide.clone_master_placeholders..iter_cloneable_placeholdersr N)r&rG)rAZclone_placeholderr)r*rErNrArLr+rMr,clone_master_placeholdersns  z$NotesSlide.clone_master_placeholdersNotesSlidePlaceholder | NonecCs&|jD] }|jjtjkr|SqdS)aUthe notes placeholder on this notes slide, the shape that contains the actual notes text. Return |None| if no notes placeholder is present; while this is probably uncommon, it can happen if the notes master does not have a body placeholder, or if the notes placeholder has been deleted from the notes slide. N)r?Zplaceholder_formattyperrI)r*rLr+r+r,notes_placeholders zNotesSlide.notes_placeholderTextFrame | NonecCs|j}|dur dS|jS)zThe text frame of the notes placeholder on this notes slide. |None| if there is no notes placeholder. This is a shortcut to accommodate the common case of simply adding "notes" text to the notes "page". N)rR text_frame)r*rRr+r+r,notes_text_frameszNotesSlide.notes_text_framer cCr=)zInstance of |NotesSlidePlaceholders| for this notes-slide. Contains the sequence of placeholder shapes in this notes slide. )r rDr>r)r+r+r,r?r@zNotesSlide.placeholdersr cCr=)z8Sequence of shape objects appearing on this notes slide.)r r%r>r)r+r+r,rAzNotesSlide.shapesN)rErBr&rF)r&rP)r&rS)r&r )r&r ) r5r6r7r8r9rOr:rRrUrr?rAr+r+r+r,rCes     rCc@szeZdZUdZded<eddZeddd Zedd d Ze dddZ e dddZ edddZ edddZ dS) SlidezCSlide object. Provides access to shapes and slide-level properties.rpartcCs |jjduS)a|True| if this slide inherits the slide master background. Assigning |False| causes background inheritance from the master to be interrupted; if there is no custom background for this slide, a default background is added. If a custom background already exists for this slide, assigning |False| has no effect. Assigning |True| causes any custom background for this slide to be deleted and inheritance from the master restored. N)r%bgr)r+r+r,follow_master_backgrounds zSlide.follow_master_backgroundr&boolcC|jjS)z`True` if this slide has a notes slide, `False` otherwise. A notes slide is created by :attr:`.notes_slide` when one doesn't exist; use this property to test for a notes slide without the possible side effect of creating one. )rXhas_notes_slider)r+r+r,r]zSlide.has_notes_sliderCcCr\)zThe |NotesSlide| instance for this slide. If the slide does not have a notes slide, one is created. The same single instance is returned on each call. )rX notes_slider)r+r+r,r_r^zSlide.notes_slidercCr=)z-Sequence of placeholder shapes in this slide.)rr%r>r)r+r+r,r?rVzSlide.placeholdersrcCr=)z2Sequence of shape objects appearing on this slide.)rr%r>r)r+r+r,rArVz Slide.shapesintcCr\)zInteger value that uniquely identifies this slide within this presentation. The slide id does not change if the position of this slide in the slide sequence is changed by adding, rearranging, or deleting slides. )rXslide_idr)r+r+r,rar^zSlide.slide_id SlideLayoutcCr\)z9|SlideLayout| object this slide inherits appearance from.)rX slide_layoutr)r+r+r,rczSlide.slide_layoutN)r&r[)r&rC)r&r)r&rr&r`)r&rb)r5r6r7r8r9r:rZr]r_rr?rArarcr+r+r+r,rWs"       rWcsjeZdZUdZded<d"fdd Zd#ddZd$ddZd%ddZd&ddZ d'd(ddZ d)d d!Z Z S)*SlideszSequence of slides belonging to an instance of |Presentation|. Has list semantics for access to individual slides. Supports indexed access, len(), and iteration. rrXsldIdLstrprsrctt|||||_dSN)superrf__init__ _sldIdLst)r*rgrh __class__r+r,rl zSlides.__init__idxr`r&rWcC6z|jj|}Wn tytdw|j|jS)z+Provide indexed access, (e.g. 'slides[0]').zslide index out of range)rm sldId_lst IndexErrorrX related_sliderId)r*rqsldIdr+r+r, __getitem__  zSlides.__getitem__Iterator[Slide]cc$|jjD] }|j|jVqdS)z/Support iteration, e.g. `for slide in slides:`.N)rmrsrXrurv)r*rwr+r+r,__iter__ zSlides.__iter__cC t|jSz9Support len() built-in function, e.g. `len(slides) == 4`.)lenrmr)r+r+r,__len__ zSlides.__len__rcrbcCs,|j|\}}|j||j||S)zDReturn a newly added slide that inherits layout from `slide_layout`.)rX add_sliderAZclone_layout_placeholdersrm add_sldId)r*rcrvslider+r+r,r s  zSlides.add_slideNradefault Slide | NonecCs|j|}|dur |S|S)zuReturn the slide identified by int `slide_id` in this presentation. Returns `default` if not found. N)rX get_slide)r*rarrr+r+r,gets z Slides.getrcCs.t|D] \}}||kr|Sqtd|)z|Map `slide` to its zero-based position in this slide sequence. Raises |ValueError| on *slide* not present. z%s is not in slide collection enumerate ValueError)r*rrqZ this_slider+r+r,indexs  z Slides.index)rgrrhr)rqr`r&rW)r&rzre)rcrbr&rWrj)rar`rrr&r)rrWr&r`) r5r6r7r8r9rlrxr|rrrr __classcell__r+r+rnr,rfs       rfc@sZeZdZUdZded<dddZedd d Zedd d Ze dddZ e ddZ dS)rbzrSlide layout object. Provides access to placeholders, regular shapes, and slide layout-level properties. rrXr&Iterator[LayoutPlaceholder]ccs4tjtjtjf}|jD] }|jj|vr|Vq dS)zGenerate layout-placeholders on this slide-layout that should be cloned to a new slide. Used when creating a new slide from this slide-layout. N)rDATEFOOTERrJr?rDrK)r*Zlatent_ph_typesphr+r+r,rN0s  z'SlideLayout.iter_cloneable_placeholdersrcCr=)zjSequence of placeholder shapes in this slide layout. Placeholders appear in `idx` order. )rr%r>r)r+r+r,r?>r@zSlideLayout.placeholdersr cCr=)z2Sequence of shapes appearing on this slide layout.)r r%r>r)r+r+r,rAFrVzSlideLayout.shapes SlideMastercCr\)z>Slide master from which this slide-layout inherits properties.)rX slide_masterr)r+r+r,rKrdzSlideLayout.slide_mastercs$jjjjj}tfdd|DS)z2Tuple of slide objects based on this slide layout.c3s|] }|jkr|VqdSrj)rc).0sr)r+r, Usz-SlideLayout.used_by_slides..)rXpackagepresentation_part presentationslidestuple)r*rr+r)r,used_by_slidesPszSlideLayout.used_by_slidesN)r&r)r&r)r&r )r&r) r5r6r7r8r9rNrr?rAr:rrr+r+r+r,rb(s     rbcsjeZdZUdZded<d"fdd Zd#ddZd$ddZd%ddZd&d'ddZ d(ddZ d)d d!Z Z S)* SlideLayoutszSequence of slide layouts belonging to a slide-master. Supports indexed access, len(), iteration, index() and remove(). rrXsldLayoutIdLstrparentrcrirj)rkrrl_sldLayoutIdLst)r*rrrnr+r,rl`rpzSlideLayouts.__init__rqr`r&rbcCrr)z1Provides indexed access, e.g. `slide_layouts[2]`.zslide layout index out of range)rsldLayoutId_lstrtrXrelated_slide_layoutrv)r*rq sldLayoutIdr+r+r,rxdryzSlideLayouts.__getitem__Iterator[SlideLayout]ccr{)z;Generate each |SlideLayout| in the collection, in sequence.N)rrrXrrv)r*rr+r+r,r|lr}zSlideLayouts.__iter__cCr~r)rrr)r+r+r,rqrzSlideLayouts.__len__Nr0r.rSlideLayout | NonecCs |D] }|j|kr |Sq|S)zCReturn SlideLayout object having `name`, or `default` if not found.)r0)r*r0rrcr+r+r, get_by_nameus  zSlideLayouts.get_by_namerccCs*t|D] \}}||kr|Sqtd)zReturn zero-based index of `slide_layout` in this collection. Raises `ValueError` if `slide_layout` is not present in this collection. z*layout not in this SlideLayouts collectionr)r*rcrqZ this_layoutr+r+r,r|s zSlideLayouts.indexrFcCsD|jrtd||}|jj|}|j||jj|j dS)zRemove `slide_layout` from the collection. Raises ValueError when `slide_layout` is in use; a slide layout which is the basis for one or more slides cannot be removed. z7cannot remove slide-layout in use by one or more slidesN) rrrrrremoverrXdrop_relrv)r*rcZ target_idxZtarget_sldLayoutIdr+r+r,rs    zSlideLayouts.remove)rrrr)rqr`r&rb)r&rrerj)r0r.rrr&r)rcrbr&r`)rcrbr&rF) r5r6r7r8r9rlrxr|rrrrrr+r+rnr,rXs       rc@s(eZdZUdZded<ed ddZdS) rzSlide master object. Provides access to slide layouts. Access to placeholders, regular shapes, and slide master-level properties is inherited from |_BaseMaster|. rr%r&rcCst|j|S)zF|SlideLayouts| object providing access to this slide-master's layouts.)rr%get_or_add_sldLayoutIdLstr)r+r+r, slide_layoutsszSlideMaster.slide_layoutsN)r&r)r5r6r7r8r9rrr+r+r+r,rs rcsFeZdZUdZded<dfdd ZdddZddZddZZ S) SlideMasterszSequence of |SlideMaster| objects belonging to a presentation. Has list access semantics, supporting indexed access, len(), and iteration. rrXsldMasterIdLstrrrcrirj)rkrrl_sldMasterIdLst)r*rrrnr+r,rlrpzSlideMasters.__init__rqr`r&rcCrr)z1Provides indexed access, e.g. `slide_masters[2]`.zslide master index out of range)rsldMasterId_lstrtrXrelated_slide_masterrv)r*rq sldMasterIdr+r+r,rxryzSlideMasters.__getitem__ccr{)zDGenerate each |SlideMaster| instance in the collection, in sequence.N)rrrXrrv)r*Zsmir+r+r,r|r}zSlideMasters.__iter__cCr~)z@Support len() built-in function, e.g. `len(slide_masters) == 4`.)rrr)r+r+r,rrzSlideMasters.__len__)rrrr)rqr`r&r) r5r6r7r8r9rlrxr|rrr+r+rnr,rs  rcs.eZdZdZdfdd ZeddZZS) r'zProvides access to slide background properties. Note that the presence of this object does not by itself imply an explicitly-defined background; a slide with an inherited background still has a |_Background| object. r(rcstt||||_dSrj)rkr'rl_cSld)r*r(rnr+r,rls z_Background.__init__cCs|j}t|S)a|FillFormat| instance for this background. This |FillFormat| object is used to interrogate or specify the fill of the slide background. Note that accessing this property is potentially destructive. A slide background can also be specified by a background style reference and accessing this property will remove that reference, if present, and replace it with NoFill. This is frequently the case for a slide master background. This is also the case when there is no explicitly defined background (background is inherited); merely accessing this property will cause the background to be set to NoFill and the inheritance link will be interrupted. This is frequently the case for a slide background. Of course, if you are accessing this property in order to set the fill, then these changes are of no consequence, but the existing background cannot be reliably interrogated using this property unless you have already established it is an explicit fill. If the background is already a fill, then accessing this property makes no changes to the current background. )rget_or_add_bgPrrfrom_fill_parent)r*bgPrr+r+r,fills  z_Background.fill)r(r)r5r6r7r8rlrrrr+r+rnr,r's r'N)s8   (      K>:0F