o j%@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__K/home/air/Certificate/back/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. N hlinkshowjumpjump) firstslide lastslidelastslideviewed nextslide previousslideendshow)N hlinksldjump hlinkpres hlinkfile customshowolemacroprogram)_hlinkrNONE action_verb action_fields FIRST_SLIDE LAST_SLIDELAST_SLIDE_VIEWED NEXT_SLIDEPREVIOUS_SLIDEEND_SHOW HYPERLINK NAMED_SLIDEPLAY OPEN_FILENAMED_SLIDE_SHOWOLE_VERB RUN_MACRO RUN_PROGRAMget)rhlinkr4relative_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. )rIr_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 )rr6r7r9r:r=rG_slides _slide_indexlen ValueErrorr2rIdrpart related_partslide)rslide_jump_actionsnext_slide_idxprev_slide_idxrT slide_partr r r! target_slideXs8            zActionSetting.target_sliderWcCs<||dur dS|j}d|_|j|jtj|_dS)Nzppaction://hlinksldjump) _clear_click_actionrget_or_add_hlinkClickrGrU relate_toRTSLIDErT)rrWrEr r r!r\s  cC8|j}|dur dS|j}|r|j||j|dS)z!Remove any existing click action.Nr2rTrUdrop_relrremoverrErTr r r!r]s 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 hlinkClickrKr r r!r2szActionSetting._hlinkcCs|jjS)zW Reference to the slide containing the shape having this click action. )rUrWrKr r r!_slideszActionSetting._slidecCs|j|jS)zv Position in the slide collection of the slide containing the shape having this click action. )rPindexrkrKr r r!rQszActionSetting._slide_indexrcCs|jjjjjS)zJ Reference to the slide collection for this presentation. )rUpackagepresentation_part presentationslidesrKr r r!rPszActionSetting._slidesFrrrr rr)rHrI)rHrM)rWrMrHrg)rHr)__name__ __module__ __qualname____doc__rpropertyrGrrLr\setterr]r2rkrQrP __classcell__r r rr!rs*  '  3    rcsdeZdZdZ ddfd d Zedd dZejdddZdddZedddZ ddZ Z S)rIz5Represents a hyperlink action on a shape or text run.Frrrr rrcrr)rrIrrrrrr r!rr"zHyperlink.__init__rH 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)r2rTrU target_refrfr r r!addresss  zHyperlink.addressurlcCs6||r|jj|tjdd}|}||_dSdS)NT) is_external) _remove_hlinkrUr_r`r<_get_or_add_hlinkrT)rr~rTrEr r r!r}s  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_hlinkHoverr^rKr r r!rs zHyperlink._get_or_add_hlinkrgcCs|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 )rrrrirjrKr r r!r2szHyperlink._hlinkcCrb)zmRemove the a:hlinkClick or a:hlinkHover element. Also drops any relationship it might have. Nrcrfr r r!rs zHyperlink._remove_hlinkrqrr)rHr{)r~r{)rHr rs) rtrurvrwrrxr}ryrr2rrzr r rr!rIs     rIN)rw __future__rtypingrrpptx.enum.actionrpptx.opc.constantsrr` pptx.shapesr pptx.utilrpptx.oxml.actionr pptx.oxml.shapes.sharedr pptx.oxml.textr pptx.parts.slider pptx.shapes.baser pptx.sliderrrrIr r r r!s"          -