,hEZdZddlmZddlmZddlmZmZmZm Z m Z m Z m Z m Z ddlmZmZmZddlmZGddeZGd d eZGd d eZGd deZGddeZGddeZGddeZGddeZGddeZGddeZGddeZy)z=Slide-related objects, including masters, layouts, and notes.) FillFormat)PP_PLACEHOLDER)LayoutPlaceholders LayoutShapesMasterPlaceholders MasterShapesNotesSlidePlaceholdersNotesSlideShapesSlidePlaceholders SlideShapes) ElementProxyParentedElementProxyPartElementProxy) lazypropertycTeZdZdZedZedZejdZy) _BaseSlidezCBase class for slide objects, including masters, layouts and notes.c@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. ) _Background_elementcSldselfs L/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/slide.py backgroundz_BaseSlide.backgrounds4==--..cB|jjjS)z String 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. rrnamers rrz_BaseSlide.name$s}}!!&&&rcF|dn|}||jj_y)Nr)rvalue new_values rrz_BaseSlide.name-s-BU "+ rN) __name__ __module__ __qualname____doc__rrpropertyrsetterrrrrsCM / /'' [[,,rrc0eZdZdZedZedZy) _BaseMasterz Base class for master objects such as |SlideMaster| and |NotesMaster|. Provides access to placeholders and regular shapes. cBt|jj|S)z Instance of |MasterPlaceholders| containing sequence of placeholder shapes in this master, sorted in *idx* order. )rrspTreers r placeholdersz_BaseMaster.placeholders9 "$--"6"6==rcBt|jj|S)zr Instance of |MasterShapes| containing sequence of shape objects appearing on this slide. )rrr-rs rshapesz_BaseMaster.shapesA DMM00$77rN)r#r$r%r&rr.r1r)rrr+r+3s/ >>88rr+ceZdZdZy) NotesMasterz Proxy for the notes master XML document. Provides access to shapes, the most commonly used of which are placeholders. N)r#r$r%r&r)rrr4r4Jsrr4cVeZdZdZdZedZedZedZ edZ y) NotesSlidezxNotes slide object. Provides access to slide notes placeholder and other shapes on the notes handout page. c^d}|j}||D]}|j|y)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. c3Ktjtjtjf}|jD]}|j j |vs|!yw)z Generate a reference to each placeholder in *notes_master* that should be cloned to a notes slide when the a new notes slide is created. N)r SLIDE_IMAGEBODY SLIDE_NUMBERr.elementph_type) notes_master cloneable placeholders riter_cloneable_placeholderszINotesSlide.clone_master_placeholders..iter_cloneable_placeholders`s[**##++I ,88 & &&..);%% & AA!A!N)r1clone_placeholder)rr>rAr1r@s rclone_master_placeholdersz$NotesSlide.clone_master_placeholdersXs4 &6|D 2K  $ $[ 1 2rc||jD]-}|jjtjk(s+|cSy)al Return the 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.placeholder_formattyperr:)rr@s rnotes_placeholderzNotesSlide.notes_placeholderss> ,, #K--22n6I6II"" #rc8|j}|y|jS)z Return the text frame of the notes placeholder on this notes slide, or |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)rH text_frame)rrHs rnotes_text_framezNotesSlide.notes_text_frames%!22  $ +++rcBt|jj|S)z An instance of |NotesSlidePlaceholders| containing the sequence of placeholder shapes in this notes slide. )r r<r-rs rr.zNotesSlide.placeholderss &dll&9&94@@rcBt|jj|S)z An instance of |NotesSlideShapes| containing the sequence of shape objects appearing on this notes slide. )r rr-rs rr1zNotesSlide.shapess   4 4d;;rN) r#r$r%r&rDr'rHrKrr.r1r)rrr6r6Qs^ 26   , ,AA<>""rc|jj|\}}|jj||jj ||S)zV Return a newly added slide that inherits layout from *slide_layout*. )rW add_slider1clone_layout_placeholdersri add_sldId)rr`roslides rr|zSlides.add_slidesEYY((6 U ..|<   % rcD|jj|}||S|S)z| Return the slide identified by integer *slide_id* in this presentation, or *default* if not found. )rW get_slide)rr^defaultrs rgetz Slides.gets'  ##H- =N rcVt|D]\}}||k(s |cStd|z)z Map *slide* to an integer representing its zero-based position in this slide collection. Raises |ValueError| on *slide* not present. z%s is not in slide collection enumerate ValueError)rrrp this_slides rindexz Slides.index(s; ) OCU"  85@AArrg) r#r$r%r&rhrrrurzr|rrrbrcs@rreres, "25# BrrecVeZdZdZdZedZedZedZ edZ y) SlideLayoutzv Slide layout object. Provides access to placeholders, regular shapes, and slide layout-level properties. c#Ktjtjtjf}|jD]}|j j |vs|!yw)z Generate a reference to each layout placeholder on this slide layout that should be cloned to a slide when the layout is applied to that slide. N)rDATEFOOTERr;r.r<r=)rlatent_ph_typesphs rrAz'SlideLayout.iter_cloneable_placeholders9sX     ! !  ' '  ## Bzz!!8 rBcBt|jj|S)z Instance of |LayoutPlaceholders| containing sequence of placeholder shapes in this slide layout, sorted in *idx* order. )rrr-rs rr.zSlideLayout.placeholdersHr/rcBt|jj|S)zv Instance of |LayoutShapes| containing the sequence of shapes appearing on this slide layout. )rrr-rs rr1zSlideLayout.shapesPr2rc.|jjS)zP Slide master from which this slide layout inherits properties. )rW slide_masterrs rrzSlideLayout.slide_masterXrarcjjjjj}t fd|DS)z2Tuple of slide objects based on this slide layout.c3BK|]}|jk(s|ywrg)r`).0srs r z-SlideLayout.used_by_slides..dsA1!..D*@QAs)rWpackagepresentation_part presentationslidestuple)rrs` rused_by_slideszSlideLayout.used_by_slides_s7""44AAHHAAAArN) r#r$r%r&rArr.r1r'rrr)rrrr3s^ >>88&& BBrrcHeZdZdZfdZdZdZdZd dZdZ dZ xZ S) SlideLayoutszSequence of slide layouts belonging to a slide-master. Supports indexed access, len(), iteration, index() and remove(). c<tt| ||||_yrg)rQrrh_sldLayoutIdLst)rsldLayoutIdLstparentrRs rrhzSlideLayouts.__init__m lD*>6B-rc |j|}|jj|jS#t$r tdwxYw)zF Provide indexed access, (e.g. ``slide_layouts[2]``). zslide layout index out of range)rrmrWrelated_slide_layoutro)rrp sldLayoutIds rrrzSlideLayouts.__getitem__qR @..s3Kyy--koo>> @>? ? @rsc#|K|jD])}|jj|j+yw)zu Generate a reference to each of the |SlideLayout| instances in the collection, in sequence. N)rrWrro)rrs rruzSlideLayouts.__iter__{s8  // BK))00A A Brvc,t|jSrx)ryrrs rrzzSlideLayouts.__len__4''((rc:|D]}|j|k(s|cS|S)zBReturn SlideLayout object having *name* or *default* if not found.)r)rrrr`s r get_by_namezSlideLayouts.get_by_names,  $L  D(## $rcPt|D]\}}||k(s |cStd)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)rr`rp this_layouts rrzSlideLayouts.indexs7 !*$  C{*  EFFrc|jr td|j|}|jj|}|jj ||j jj|jy)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) rrrrsldLayoutId_lstremoverrWdrop_relro)rr` target_idxtarget_sldLayoutIds rrzSlideLayouts.removesz  & &VW WZZ - "11AA*M ##$67 !!&&//0B0F0FGrrg) r#r$r%r&rhrrrurzrrrrbrcs@rrrgs. .?B) GHrrc eZdZdZedZy) SlideMasterz Slide master object. Provides access to slide layouts. Access to placeholders, regular shapes, and slide master-level properties is inherited from |_BaseMaster|. cJt|jj|S)zF|SlideLayouts| object providing access to this slide-master's layouts.)rrget_or_add_sldLayoutIdLstrs r slide_layoutszSlideMaster.slide_layoutssDMMCCEtLLrN)r#r$r%r&rrr)rrrrs MMrrc4eZdZdZfdZdZdZdZxZS) SlideMasterszSequence of |SlideMaster| objects belonging to a presentation. Has list access semantics, supporting indexed access, len(), and iteration. c<tt| ||||_yrg)rQrrh_sldMasterIdLst)rsldMasterIdLstrrRs rrhzSlideMasters.__init__rrc |j|}|jj|jS#t$r tdwxYw)zF Provide indexed access, (e.g. ``slide_masters[2]``). zslide master index out of range)rrmrWrelated_slide_masterro)rrp sldMasterIds rrrzSlideMasters.__getitem__rrsc#|K|jD])}|jj|j+yw)zu Generate a reference to each of the |SlideMaster| instances in the collection, in sequence. N)rrWrro)rsmis rruzSlideMasters.__iter__s6 '' :C))009 9 :rvc,t|jS)zS Support len() built-in function (e.g. 'len(slide_masters) == 4'). )ryrrs rrzzSlideMasters.__len__rr) r#r$r%r&rhrrrurzrbrcs@rrrs .?:)rrc2eZdZdZfdZedZxZS)rzProvides 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. c:tt| |||_yrg)rQrrh_cSld)rrrRs rrhz_Background.__init__s k4)$/ rc`|jj}tj|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)rbgPrs rfillz_Background.fills'4zz))+**400r)r#r$r%r&rhrrrbrcs@rrrs!11rrN)r& pptx.dml.fillrpptx.enum.shapesrpptx.shapes.shapetreerrrrr r r r pptx.sharedr rr pptx.utilrrr+r4r6rOrerrrrrr)rrrsD$+   ML",!,<8*8.+K<K<\Q&JQ&h=B !=B@1B*1BhHH'HHV M+ M )' )F'1,'1r