o 7h%@sdZddlmZddlmZmZddlmZddlm Z ddl m Z ddl mZerPddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZGddde ZGddde ZdS)zDObjects related to mouse click and hover actions on a shape or text.) annotations) TYPE_CHECKINGcast) PP_ACTION)RELATIONSHIP_TYPE)Subshape) lazyproperty) CT_Hyperlink)CT_NonVisualDrawingProps)CT_TextCharacterProperties) SlidePart) BaseShape)SlideSlidescseZdZdZ d"d#fd d Zed d Zed$ddZed%ddZ e j d&ddZ ddZ ed'ddZ eddZ eddZed(d d!ZZS)) ActionSettingzAProperties specifying how a shape or run reacts to mouse actions.FxPr5CT_NonVisualDrawingProps | CT_TextCharacterPropertiesparentr hoverboolc tt||||_||_dSN)superr__init___element_hoverselfrrr __class__S/var/www/html/figdemos/bartoux_crm/venv/lib/python3.10/site-packages/pptx/action.pyr zActionSetting.__init__c Cs~|j}|dur tjS|j}|dkr'|jd}tjtjtjtjtj tj d|Stj tj tj tjtjtjtjtjd|tjS)aMember of :ref:`PpActionType` enumeration, such as `PP_ACTION.HYPERLINK`. The returned member indicates the type of action that will result when the specified shape or text is clicked or the mouse pointer is positioned over the shape during a slide show. If there is no click-action or the click-action value is not recognized (is not one of the official `MsoPpAction` values) then `PP_ACTION.NONE` is returned. NZ hlinkshowjumpZjump)Z firstslideZ lastslideZlastslideviewedZ nextslideZ previousslideZendshow)NZ hlinksldjumpZ hlinkpresZ hlinkfileZ customshowZolemacroprogram)_hlinkrNONE action_verb action_fields FIRST_SLIDE LAST_SLIDEZLAST_SLIDE_VIEWED NEXT_SLIDEPREVIOUS_SLIDEZEND_SHOW HYPERLINK NAMED_SLIDEZPLAYZ OPEN_FILEZNAMED_SLIDE_SHOWZOLE_VERBZ RUN_MACROZ RUN_PROGRAMget)rhlinkr'Zrelative_targetr r r!action's4    zActionSetting.actionreturn HyperlinkcCst|j|j|jS)z A |Hyperlink| object representing the hyperlink action defined on this click or hover mouse event. A |Hyperlink| object is always returned, even if no hyperlink or other click action is defined. )r3r_parentrrr r r! hyperlinkOszActionSetting.hyperlink Slide | NonecCstjtjtjtjtjf}|j|vrdS|jtjkr|jdS|jtjkr)|jdS|jtjkrD|jd}|t |jkr?t d|j|S|jtjkr\|jd}|dkrWt d|j|S|jtjkry|j dusiJ|j j }t d|j|}|jSdS)a A reference to the slide in this presentation that is the target of the slide jump action in this shape. Slide jump actions include `PP_ACTION.FIRST_SLIDE`, `LAST_SLIDE`, `NEXT_SLIDE`, `PREVIOUS_SLIDE`, and `NAMED_SLIDE`. Returns |None| for all other actions. In particular, the `LAST_SLIDE_VIEWED` action and the `PLAY` (start other presentation) actions are not supported. A slide object may be assigned to this property, which makes the shape an "internal hyperlink" to the assigened slide:: slide, target_slide = prs.slides[0], prs.slides[1] shape = slide.shapes[0] shape.target_slide = target_slide Assigning |None| removes any slide jump action. Note that this is accomplished by removing any action present (such as a hyperlink), without first checking that it is a slide jump action. Nrz no next slidezno previous slider )rr)r*r+r,r.r1_slides _slide_indexlen ValueErrorr%rIdrpart related_partslide)rZslide_jump_actionsZnext_slide_idxZprev_slide_idxr> slide_partr r r! target_slideXs8            zActionSetting.target_sliderAcCs<||dur dS|j}d|_|j|jtj|_dS)Nzppaction://hlinksldjump) _clear_click_actionrget_or_add_hlinkClickr1r? relate_toRTSLIDEr>)rrAr0r r r!rCs  cC8|j}|dur dS|j}|r|j||j|dS)z!Remove any existing click action.Nr%r>r?drop_relrremoverr0r>r r r!rDs z!ActionSetting._clear_click_actionCT_Hyperlink | NonecCs&|jrt|jts J|jjS|jjS)z Reference to the `a:hlinkClick` or `a:hlinkHover` element for this click action. Returns |None| if the element is not present. )r isinstancerr hlinkHover hlinkClickr5r r r!r%szActionSetting._hlinkcCs|jjS)zW Reference to the slide containing the shape having this click action. )r?rAr5r r r!_slideszActionSetting._slidecCs|j|jS)zv Position in the slide collection of the slide containing the shape having this click action. )r:indexrRr5r r r!r;szActionSetting._slide_indexrcCs|jjjjjS)zJ Reference to the slide collection for this presentation. )r?packagepresentation_part presentationslidesr5r r r!r:szActionSetting._slidesFrrrr rr)r2r3)r2r7)rAr7r2rN)r2r)__name__ __module__ __qualname____doc__rpropertyr1rr6rCsetterrDr%rRr;r: __classcell__r r rr!rs*  '  3    rcsdeZdZdZ ddfd d Zedd dZejdddZdddZedddZ ddZ Z S)r3z5Represents a hyperlink action on a shape or text run.Frrrr rrcrr)rr3rrrrrr r!rr"zHyperlink.__init__r2 str | NonecCs,|j}|dur dS|j}|sdS|j|S)anRead/write. The URL of the hyperlink. URL can be on http, https, mailto, or file scheme; others may work. Returns |None| if no hyperlink is defined, including when another action such as `RUN_MACRO` is defined on the object. Assigning |None| removes any action defined on the object, whether it is a hyperlink action or not. N)r%r>r? target_refrMr r r!addresss  zHyperlink.addressurlcCs6||r|jj|tjdd}|}||_dSdS)NT) is_external) _remove_hlinkr?rFrGr-_get_or_add_hlinkr>)rrer>r0r r r!rds  r cCs |jr td|jS|jS)zGet the `a:hlinkClick` or `a:hlinkHover` element for the Hyperlink object. The actual element depends on the value of `self._hover`. Create the element if not present. r )rrrget_or_add_hlinkHoverrEr5r r r!rhs zHyperlink._get_or_add_hlinkrNcCs|jr td|jjS|jjS)zReference to the `a:hlinkClick` or `h:hlinkHover` element for this click action. Returns |None| if the element is not present. r )rrrrPrQr5r r r!r%szHyperlink._hlinkcCrI)zmRemove the a:hlinkClick or a:hlinkHover element. Also drops any relationship it might have. NrJrMr r r!rgs zHyperlink._remove_hlinkrXrY)r2rb)rerb)r2r rZ) r[r\r]r^rr_rdr`rhr%rgrar r rr!r3s     r3N)r^ __future__rtypingrrZpptx.enum.actionrpptx.opc.constantsrrG pptx.shapesr pptx.utilrpptx.oxml.actionr pptx.oxml.shapes.sharedr pptx.oxml.textr pptx.parts.slider pptx.shapes.baser pptx.sliderrrr3r r r r!s"          -