,h8pdZddlmZmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZGd d eZGd d ee ZGd de ZGddee ZGddeZGddee ZGddeZGddeZGddeZGdde ZGddee ZGdd eZy!)"zPlaceholder-related objects. Specific to shapes having a `p:ph` element. A placeholder has distinct behaviors depending on whether it appears on a slide, layout, or master. Hence there is a non-trivial class inheritance structure. )MSO_SHAPE_TYPEPP_PLACEHOLDER)CT_GraphicalObjectFrame) CT_Picture)Shape) GraphicFrame)Picture)EmuceZdZdZedZej dZedZej dZedZedZ e j dZ ed Z e j d Z ed Z fd Z d Z xZS)_InheritsDimensionsa Mixin class that provides inherited dimension behavior. Specifically, left, top, width, and height report the value from the layout placeholder where they would have otherwise reported |None|. This behavior is distinctive to placeholders. :meth:`_base_placeholder` must be overridden by all subclasses to provide lookup of the appropriate base placeholder to inherit from. c$|jdS)z The effective height of this placeholder shape; its directly-applied height if it has one, otherwise the height of its parent layout placeholder. height_effective_valueselfs Y/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/pptx/shapes/placeholder.pyrz_InheritsDimensions.heights$$X..c&||j_yN)_elementcyrvalues rrz_InheritsDimensions.height&  rc$|jdS)z The effective left of this placeholder shape; its directly-applied left if it has one, otherwise the left of its parent layout placeholder. leftrrs rrz_InheritsDimensions.left*s$$V,,rc&||j_yr)rxrs rrz_InheritsDimensions.left3  rc"tjSz Member of :ref:`MsoShapeType` specifying the type of this shape. Unconditionally ``MSO_SHAPE_TYPE.PLACEHOLDER`` in this case. Read-only. r PLACEHOLDERrs r shape_typez_InheritsDimensions.shape_type7)))rc$|jdS)z The effective top of this placeholder shape; its directly-applied top if it has one, otherwise the top of its parent layout placeholder. toprrs rr(z_InheritsDimensions.top@s$$U++rc&||j_yr)ryrs rr(z_InheritsDimensions.topIr rc$|jdS)z The effective width of this placeholder shape; its directly-applied width if it has one, otherwise the width of its parent layout placeholder. widthrrs rr,z_InheritsDimensions.widthMs$$W--rc&||j_yr)rcxrs rr,z_InheritsDimensions.widthVrrctd)z Return the layout or master placeholder shape this placeholder inherits from. Not to be confused with an instance of |BasePlaceholder| (necessarily). z&Must be implemented by all subclasses.)NotImplementedErrorrs r_base_placeholderz%_InheritsDimensions._base_placeholderZs""JKKrcbttt||}||S|j|S)z The effective value of *attr_name* on this placeholder shape; its directly-applied value if it has one, otherwise the value on the layout placeholder it inherits from. )getattrsuperr _inherited_value)r attr_namedirectly_applied_value __class__s rrz$_InheritsDimensions._effective_valuecs7 ")/BD)I9!U ! -) )$$Y//rc<|j}|yt||}|S)zz Return the attribute value, e.g. 'width' of the base placeholder this placeholder inherits from. N)r1r3)rr6base_placeholderinherited_values rr5z$_InheritsDimensions._inherited_valuens,  11  #!"2I>r)__name__ __module__ __qualname____doc__propertyrsetterrr%r(r,r1rr5 __classcell__)r8s@rr r s// ]]!!-- [[  **,, ZZ  .. \\!!LL 0 rr cFeZdZdZedZedZedZdZy)_BaseSlidePlaceholderzhBase class for placeholders on slides. Provides common behaviors such as inherited dimensions. cyzv Boolean indicating whether this shape is a placeholder. Unconditionally |True| in this case. Trs ris_placeholderz$_BaseSlidePlaceholder.is_placeholder rc"tjSr"r#rs rr%z _BaseSlidePlaceholder.shape_typer&rc|jj|jj}}|jj |S)z Return the layout placeholder this slide placeholder inherits from. Not to be confused with an instance of |BasePlaceholder| (necessarily). idxpart slide_layoutrph_idx placeholdersgetrlayoutrMs rr1z'_BaseSlidePlaceholder._base_placeholders;ii,,dmm.B.B""&&3&//rc |jjj|jj|jj ||jj j|jd|_y)aT Substitute *element* for this placeholder element in the shapetree. This placeholder's `._element` attribute is set to |None| and its original element is free for garbage collection. Any attribute access (including a method call) on this placeholder after this call raises |AttributeError|. N)_nvXxPrnvPr _insert_phrph addprevious getparentremove)relements r_replace_placeholder_withz/_BaseSlidePlaceholder._replace_placeholder_withs^ '' (8(89 !!'* !((7 rN) r<r=r>r?r@rHr%r1r_rGrrrDrDzsH **00 rrDcPeZdZdZedZedZedZedZy)BasePlaceholdera NOTE: This class is deprecated and will be removed from a future release along with the properties *idx*, *orient*, *ph_type*, and *sz*. The *idx* property will be available via the .placeholder_format property. The others will be accessed directly from the oxml layer as they are only used for internal purposes. Base class for placeholder subclasses that differentiate the varying behaviors of placeholders on a master, layout, and slide. c.|jjS)z= Integer placeholder 'idx' attribute, e.g. 0 )_sprQrs rrMzBasePlaceholder.idxs xxrc.|jjS)zA Placeholder orientation, e.g. ST_Direction.HORZ )rc ph_orientrs rorientzBasePlaceholder.orients xx!!!rc.|jjS)zD Placeholder type, e.g. PP_PLACEHOLDER.CENTER_TITLE )rcph_typers rrhzBasePlaceholder.ph_types xxrc.|jjS)zJ Placeholder 'sz' attribute, e.g. ST_PlaceholderSize.FULL )rcph_szrs rszzBasePlaceholder.szs xx~~rN) r<r=r>r?r@rMrfrhrkrGrrrarasW  ""   rrac eZdZdZedZy)LayoutPlaceholderz Placeholder shape on a slide layout, providing differentiated behavior for slide layout placeholders, in particular, inheriting shape properties from the master placeholder having the same type, when a matching one exists. ctjtjtjtjtjtjtjtj tj tjtjtjtjtjtjtjtjtjtjtjtjtjtjtjtjtjtj tj i|jj }|j"j$}|j&j)|dS)zV Return the master placeholder this layout placeholder inherits from. N)rBODYCHARTBITMAP CENTER_TITLETITLE ORG_CHARTDATEFOOTER MEDIA_CLIPOBJECTPICTURE SLIDE_NUMBERSUBTITLETABLErrhrO slide_masterrRrS)r base_ph_typer}s rr1z#LayoutPlaceholder._base_placeholders7   !4!4  ."5"5  ! !>#6#6  ' ')=)=  $ $n&9&9   !4!4  ! !>#8#8  % %~':':  ! !>#6#6  " "N$7$7  ' ')D)D  # #^%8%8  ."5"5  ."6"6  --  ! yy-- ((,,\4@@rNr<r=r>r?r@r1rGrrrmrmsAArrmceZdZdZy)MasterPlaceholderz. Placeholder shape on a slide master. Nr<r=r>r?rGrrrrsrrc eZdZdZedZy)NotesSlidePlaceholderz Placeholder shape on a notes slide. Inherits shape properties from the placeholder on the notes master that has the same type (e.g. 'body'). c|jj}|jj}|jj |S)z Return the notes master placeholder this notes slide placeholder inherits from, or |None| if no placeholder of the matching type is present. )rh)rO notes_masterr^rhrRrS)rrrhs rr1z'NotesSlidePlaceholder._base_placeholders<yy-- ,,&&((,,W,==rNrrGrrrrs >>rrceZdZdZy)SlidePlaceholderzv Placeholder shape on a slide. Inherits shape properties from its corresponding slide layout placeholder. NrrGrrrr srrceZdZdZdZdZy)ChartPlaceholderz/Placeholder shape that can only accept a chart.c|jj||}|j||j|j|j |j }|j|t||jS)ac Return a |PlaceholderGraphicFrame| object containing a new chart of *chart_type* depicting *chart_data* and having the same position and size as this placeholder. *chart_type* is one of the :ref:`XlChartType` enumeration values. *chart_data* is a |ChartData| object populated with the categories and series values for the chart. Note that the new |Chart| object is not returned directly. The chart object may be accessed using the :attr:`~.PlaceholderGraphicFrame.chart` property of the returned |PlaceholderGraphicFrame| object. ) rOadd_chart_part_new_chart_graphicFramerr(r,rr_PlaceholderGraphicFrame_parent)r chart_type chart_datarId graphicFrames r insert_chartzChartPlaceholder.insert_chartsfii&&z:>33 DHHdjj$++  &&|4&|T\\BBrc h|j|j}}tj|||||||S)z Return a newly created `p:graphicFrame` element having the specified position and size and containing the chart identified by *rId*. )shape_idnamernew_chart_graphicFrame)rrrr*r.rid_rs rrz(ChartPlaceholder._new_chart_graphicFrame(s7 MM499T&== sAq"b  rN)r<r=r>r?rrrGrrrrs9C& rrc"eZdZdZdZdZdZy)PicturePlaceholderz1Placeholder shape that can only accept a picture.cr|j|}|j|t||jS)aReturn a |PlaceholderPicture| object depicting the image in `image_file`. `image_file` may be either a path (string) or a file-like object. The image is cropped to fill the entire space of the placeholder. A |PlaceholderPicture| object has all the properties and methods of a |Picture| shape except that the value of its :attr:`~._BaseSlidePlaceholder.shape_type` property is `MSO_SHAPE_TYPE.PLACEHOLDER` instead of `MSO_SHAPE_TYPE.PICTURE`. )_new_placeholder_picr_PlaceholderPicturer)r image_filepics rinsert_picturez!PicturePlaceholder.insert_picture6s3'' 3 &&s+!#t||44rc|j|\}}}|j|j}}tj||||}|j ||j |jf|S)a  Return a new `p:pic` element depicting the image in *image_file*, suitable for use as a placeholder. In particular this means not having an `a:xfrm` element, allowing its extents to be inherited from its layout placeholder. )_get_or_add_imagerrr new_ph_pic crop_to_fitr,r)rrrdesc image_sizerrrs rrz'PicturePlaceholder._new_placeholder_picCsb!% 6 6z BT: $##HdD#>  TZZ$=> rcx|jj|\}}|j|j}}|||fS)z Return an (rId, description, image_size) 3-tuple identifying the related image part containing *image_file* and describing the image. )rOget_or_add_image_partr_px_size)rr image_partrrrs rrz$PicturePlaceholder._get_or_add_imagePs< ))99*E C%??J,?,?jD*$$rN)r<r=r>r?rrrrGrrrr3s; 5 %rrc eZdZdZedZy)rzH Placeholder shape populated with a table, chart, or smart art. cyrFrGrs rrHz&PlaceholderGraphicFrame.is_placeholder_rIrN)r<r=r>r?r@rHrGrrrrZsrrc eZdZdZedZy)rz5 Placeholder shape populated with a picture. c|jj|jj}}|jj |S)zW Return the layout placeholder this picture placeholder inherits from. rLrNrTs rr1z$PlaceholderPicture._base_placeholderms; ii,,dmm.B.B""&&3&//rNrrGrrrrhs00rrceZdZdZdZdZy)TablePlaceholderz/Placeholder shape that can only accept a table.ct|j||}|j|t||jS)aReturn |PlaceholderGraphicFrame| object containing a `rows` by `cols` table. The position and width of the table are those of the placeholder and its height is proportional to the number of rows. A |PlaceholderGraphicFrame| object has all the properties and methods of a |GraphicFrame| shape except that the value of its :attr:`~._BaseSlidePlaceholder.shape_type` property is unconditionally `MSO_SHAPE_TYPE.PLACEHOLDER`. Note that the return value is not the new table but rather *contains* the new table. The table can be accessed using the :attr:`~.PlaceholderGraphicFrame.table` property of the returned |PlaceholderGraphicFrame| object. )_new_placeholder_tabler_rr)rrowscolsrs r insert_tablezTablePlaceholder.insert_tableys5224>  &&|4&|T\\BBrc |j|jt|dz}}}tj|||||j |j |j|S)a Return a newly added `p:graphicFrame` element containing an empty table with *rows* rows and *cols* columns, positioned at the location of this placeholder and having its same width. The table's height is determined by the number of rows. i)rrr rnew_table_graphicFramerr(r,)rrrrrrs rrz'TablePlaceholder._new_placeholder_tablesR"& 3tf};M$&== dD$ 488TZZ  rN)r<r=r>r?rrrGrrrrvs9C  rrN)r?pptx.enum.shapesrrpptx.oxml.shapes.graphfrmrpptx.oxml.shapes.picturerpptx.shapes.autoshaperpptx.shapes.graphfrmrpptx.shapes.picturer pptx.utilr objectr rDrarmrrrrrrrrrGrrrs<=/'-'d&dN,/,^&e&RA+UAB >/>$, , B$%.$%N l  0,g 0 , r