hidZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z er&ddlmZmZdd lmZdd lmZdd lmZdd lmZdd l mZGddeZGdde ZdS)z-Base shape-related objects such as BaseShape.) annotations) TYPE_CHECKINGcast) ActionSetting) ShadowFormat) ElementProxy) lazyproperty)MSO_SHAPE_TYPEPP_PLACEHOLDER) ShapeElement)CT_Placeholder) BaseSlidePart) ProvidesPart)LengthceZdZdZd.fd Zd/d Zd/d Zed0dZe d1dZ e d2dZ e d2dZ e d2dZ e d3dZejd4dZe d2dZe d3dZejd4dZe d5dZejd6dZe d7dZe d8d Ze d9d"Zejd:d#Zed;d%Ze d BaseShapezbBase class for shape objects. Subclasses include |Shape|, |Picture|, and |GraphicFrame|. shape_elmr parentrcdt||_||_dSN)super__init___element_parent)selfrr __class__s h/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/shapes/base.pyrzBaseShape.__init__s+ !  otherobjectreturnboolcLt|tsdS|j|juS)z|True| if this shape object proxies the same element as *other*. Equality for proxy objects is defined as referring to the same XML element, whether or not they are the same proxy object instance. F isinstancerrrrs r__eq__zBaseShape.__eq__ s* %++ 5}..rcLt|tsdS|j|juS)NTr$r&s r__ne__zBaseShape.__ne__*s(%++ 4}EN22rrcD|jjj}t||S)a|ActionSetting| instance providing access to click behaviors. Click behaviors are hyperlink-like behaviors including jumping to a hyperlink (web page) or to another slide in the presentation. The click action is that defined on the overall shape, not a run of text within the shape. An |ActionSetting| object is always returned, even when no click behavior is defined on the shape. )r_nvXxPrcNvPrr)rr,s r click_actionzBaseShape.click_action/s! %+UD)))rc|jS)z`lxml` element for this shape, e.g. a CT_Shape instance. Note that manipulating this element improperly can produce an invalid presentation file. Make sure you know what you're doing if you use this to change the underlying XML. )rrs relementzBaseShape.element;s }rcdS)z|True| if this shape is a graphic frame containing a chart object. |False| otherwise. When |True|, the chart object can be accessed using the ``.chart`` property. Fr/s r has_chartzBaseShape.has_chartD urcdS)z|True| if this shape is a graphic frame containing a table object. |False| otherwise. When |True|, the table object can be accessed using the ``.table`` property. Fr2r/s r has_tablezBaseShape.has_tableOr4rcdS)z&|True| if this shape can contain text.Fr2r/s rhas_text_framezBaseShape.has_text_frameZs urrc|jjS)zMRead/write. Integer distance between top and bottom extents of shape in EMUs.rcyr/s rheightzBaseShape.height`s}rvaluec||j_dSrr:rr=s rr<zBaseShape.heighte  rc|jjS)zkTrue if this shape is a placeholder. A shape is a placeholder if it has a element. )r has_ph_elmr/s ris_placeholderzBaseShape.is_placeholderis }''rc|jjS)zInteger distance of the left edge of this shape from the left edge of the slide. Read/write. Expressed in English Metric Units (EMU) rxr/s rleftzBaseShape.leftq }rc||j_dSrrEr?s rrGzBaseShape.lefty rstrc|jjS)z%Name of this shape, e.g. 'Picture 7'.)r shape_namer/s rnamezBaseShape.name}s}''rc2||jjj_dSr)rr+r,rNr?s rrNzBaseShape.names+0 #(((rrc6td|jjS)zThe package part containing this shape. A |BaseSlidePart| subclass in this case. Access to a slide part should only be required if you are extending the behavior of |pp| API objects. r)rrpartr/s rrQzBaseShape.partsOT\%6777r_PlaceholderFormatcZ|jj}|tdt|S)zProvides access to placeholder-specific properties such as placeholder type. Raises |ValueError| on access if the shape is not a placeholder. Nzshape is not a placeholder)rph ValueErrorrR)rrTs rplaceholder_formatzBaseShape.placeholder_formats0 ]  :9:: :!"%%%rfloatc|jjS)zDegrees of clockwise rotation. Read/write float. Negative values can be assigned to indicate counter-clockwise rotation, e.g. assigning -45.0 will change setting to 315.0. rrotr/s rrotationzBaseShape.rotations}  rc||j_dSrrYr?s rr[zBaseShape.rotations! rrc4t|jjS)z|ShadowFormat| object providing access to shadow for this shape. A |ShadowFormat| object is always returned, even when no shadow is explicitly defined on this shape (i.e. it inherits its shadow behavior). )rrspPrr/s rshadowzBaseShape.shadowsDM.///rintc|jjS)z}Read-only positive integer identifying this shape. The id of a shape is unique among all shapes on a slide. )rshape_idr/s rrbzBaseShape.shape_ids }%%rr cJtt|jd)zA member of MSO_SHAPE_TYPE classifying this shape by type. Like ``MSO_SHAPE_TYPE.CHART``. Must be implemented by subclasses. z! does not implement `.shape_type`)NotImplementedErrortype__name__r/s r shape_typezBaseShape.shape_types$ "T$ZZ%8"["["[\\\rc|jjS)zDistance from the top edge of the slide to the top edge of this shape. Read/write. Expressed in English Metric Units (EMU) ryr/s rtopz BaseShape.toprHrc||j_dSrrir?s rrkz BaseShape.toprJrc|jjS)z}Distance between left and right extents of this shape. Read/write. Expressed in English Metric Units (EMU). rcxr/s rwidthzBaseShape.widths }rc||j_dSrrnr?s rrpzBaseShape.widthr@r)rr rr)rr r!r")r!r)r!r )r!r")r!r)r=r)r!rK)r=rK)r!r)r!rR)r!rW)r=rW)r!rr!r`)r!r )rf __module__ __qualname____doc__rr'r)r r-propertyr0r3r6r8r<setterrCrGrNrQrVr[r_rbrgrkrp __classcell__rs@rrrs_  ////3333  * * *\ *XXXX    X  ]!!!]!(((X(X [   [ (((X( [111[1888X8&&&X&!!!X!_"""_"000\0&&&X&]]]X]X Z   Z    X  \!!!\!!!!!rrcleZdZdZd fd Zed dZed dZedd ZxZ S)rRzProvides properties specific to placeholders, such as the placeholder type. Accessed via the :attr:`~.BaseShape.placeholder_format` property of a placeholder shape, r0r cXt|||_dSr)rr_ph)rr0rs rrz_PlaceholderFormat.__init__s& !!!rr!c|jS)z*The `p:ph` element proxied by this object.)r|r/s rr0z_PlaceholderFormat.elements xrr`c|jjS)z$Integer placeholder 'idx' attribute.)r|idxr/s rrz_PlaceholderFormat.idxsx|rr c|jjS)zsPlaceholder type. A member of the :ref:`PpPlaceholderType` enumeration, e.g. PP_PLACEHOLDER.CHART )r|rer/s rrez_PlaceholderFormat.types x}r)r0r )r!r rr)r!r ) rfrsrtrurrvr0rrerxrys@rrRrRs XXXrrRN)ru __future__rtypingrr pptx.actionrpptx.dml.effectr pptx.sharedr pptx.utilr pptx.enum.shapesr r pptx.oxml.shapesr pptx.oxml.shapes.sharedr pptx.parts.slider pptx.typesrrr rrRr2rrrs^33""""""&&&&&&&&%%%%%%(((((($$$$$$""""""!????????------666666......''''''      B!B!B!B!B!B!B!B!Jr