hi%dZddlmZddlmZmZddlmZddlm Z ddl m Z ddl mZer&ddlmZdd lmZdd lmZdd lmZdd lmZdd lmZmZGdde ZGdde 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)SlideSlidesceZdZdZ ddfd Zed Zedd ZeddZ e j ddZ dZ eddZ edZ edZeddZxZS) ActionSettingzAProperties specifying how a shape or run reacts to mouse actions.FxPr5CT_NonVisualDrawingProps | CT_TextCharacterPropertiesparentrhoverboolcttt||||_||_dSN)superr__init___element_hoverselfrrr __class__s c/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/pptx/action.pyrzActionSetting.__init__s5 mT""++F333  c |j}| tjS|j}|dkrX|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)rhlinkr5relative_targets r!actionzActionSetting.action's  => !' / ) )#1&9O'3&1#,#>&1!*!9$-  %%1"",#4%( ,    #k9> * * +r"return HyperlinkcBt|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. )rJr_parentrrs r! hyperlinkzActionSetting.hyperlinkOs dkBBBr" Slide | Nonectjtjtjtjtjf}|j|vrdS|jtjkr |jdS|jtjkr |jdS|jtjkr>|jdz}|t|jkrtd|j|S|jtjkr,|jdz }|dkrtd|j|S|jtjkrD|j J|j j }td|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 )rr7r8r:r;r>rH_slides _slide_indexlen ValueErrorr3rIdrpart related_partslide)rslide_jump_actionsnext_slide_idxprev_slide_idxrW slide_parts r! target_slidezActionSetting.target_slideXs`,  !    $  !   ;0 0 04 ;)/ / /<? " [I0 0 0<# # [I0 0 0!.2NT\!2!222 111</ / [I4 4 4!.2N!! !4555</ / [I1 1 1;***+/Ck49+A+A#+F+FGGJ# # 2 1r"rZc||dS|j}d|_|j|jt j|_dS)Nzppaction://hlinksldjump) _clear_click_actionrget_or_add_hlinkClickrHrX relate_toRTSLIDErW)rrZrFs r!r_zActionSetting.target_slidesY   """ = F 33550 I'' BH== r"c|j}|dS|j}|r|j||j|dS)z!Remove any existing click action.Nr3rWrXdrop_relrremoverrFrWs r!raz!ActionSetting._clear_click_actionsT  = Fi  $ I  s # # # U#####r"CT_Hyperlink | Nonecx|jr(t|jtsJ|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 hlinkClickrMs r!r3zActionSetting._hlinks= ; ,dm-EFF F F F=+ +}''r"c|jjS)zW Reference to the slide containing the shape having this click action. )rXrZrMs r!_slidezActionSetting._slides yr"c@|j|jS)zv Position in the slide collection of the slide containing the shape having this click action. )rSindexrqrMs r!rTzActionSetting._slide_indexs |!!$+...r"rc8|jjjjjS)zJ Reference to the slide collection for this presentation. )rXpackagepresentation_part presentationslidesrMs r!rSzActionSetting._slidess y 2?FFr"Frrrrrr)rIrJ)rIrO)rZrOrIrk)rIr)__name__ __module__ __qualname____doc__rpropertyrHr rNr_setterrar3rqrTrS __classcell__r s@r!rrs_KK       %+%+X%+NCCC\C1$1$1$X1$f>>>>$$$(((X(\ //\/GGG\GGGGGr"rceZdZdZ ddfd Zedd ZejddZddZeddZ dZ xZ S)rJz5Represents a hyperlink action on a shape or text run.Frrrrrrcttt||||_||_dSr)rrJrrrrs r!rzHyperlink.__init__s5 i''///  r"rI str | Nonecb|j}|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)r3rWrX target_refrjs r!addresszHyperlink.addresssC  =4i 4y##C(((r"urlc||rD|j|tjd}|}||_dSdS)NT) is_external) _remove_hlinkrXrcrdr=_get_or_add_hlinkrW)rrrWrFs r!rzHyperlink.addresssb   )%%c2rspJJ""""""&&&&&&&&&&&&&&666666 """""")------@@@@@@999999************((((((((iGiGiGiGiGHiGiGiGXM$M$M$M$M$M$M$M$M$M$r"