U Pe)@s"dZdZddlmZddlmZmZmZmZm Z m Z ddl m Z Gddde Z edkrdd lmZdd lmZdd lmZdd lmZdd lmZeddZeedde dddZeeeddZedD],ZededZej ej!deeqeee!edS)a ModalView ========= .. versionadded:: 1.4.0 The :class:`ModalView` widget is used to create modal views. By default, the view will cover the whole "main" window. Remember that the default size of a Widget is size_hint=(1, 1). If you don't want your view to be fullscreen, either use size hints with values lower than 1 (for instance size_hint=(.8, .8)) or deactivate the size_hint and use fixed size attributes. Examples -------- Example of a simple 400x400 Hello world view:: view = ModalView(size_hint=(None, None), size=(400, 400)) view.add_widget(Label(text='Hello world')) By default, any click outside the view will dismiss it. If you don't want that, you can set :attr:`ModalView.auto_dismiss` to False:: view = ModalView(auto_dismiss=False) view.add_widget(Label(text='Hello world')) view.open() To manually dismiss/close the view, use the :meth:`ModalView.dismiss` method of the ModalView instance:: view.dismiss() Both :meth:`ModalView.open` and :meth:`ModalView.dismiss` are bind-able. That means you can directly bind the function to an action, e.g. to a button's on_press :: # create content and add it to the view content = Button(text='Close me!') view = ModalView(auto_dismiss=False) view.add_widget(content) # bind the on_press event of the button to the dismiss function content.bind(on_press=view.dismiss) # open the view view.open() ModalView Events ---------------- There are four events available: `on_pre_open` and `on_open` which are raised when the view is opening; `on_pre_dismiss` and `on_dismiss` which are raised when the view is closed. For `on_dismiss`, you can prevent the view from closing by explicitly returning `True` from your callback:: def my_callback(instance): print('ModalView', instance, 'is being dismissed, but is prevented!') return True view = ModalView() view.add_widget(Label(text='Hello world')) view.bind(on_dismiss=my_callback) view.open() .. versionchanged:: 1.5.0 The ModalView can be closed by hitting the escape key on the keyboard if the :attr:`ModalView.auto_dismiss` property is True (the default). ) ModalView) Animation)StringPropertyBooleanPropertyObjectPropertyNumericProperty ListProperty ColorProperty) AnchorLayoutcseZdZdZedZedddZeddddgZ e dZ e ddddgZ edddd gZedZed Zeddd Zed ZdZd ZfddZddZddZddZfddZfddZfddZfddZddZd d!Zd"d#Z d$d%Z!d&d'Z"d(d)Z#d*d+Z$Z%S),raModalView class. See module documentation for more information. :Events: `on_pre_open`: Fired before the ModalView is opened. When this event is fired ModalView is not yet added to window. `on_open`: Fired when the ModalView is opened. `on_pre_dismiss`: Fired before the ModalView is closed. `on_dismiss`: Fired when the ModalView is closed. If the callback returns True, the dismiss will be canceled. .. versionchanged:: 1.11.0 Added events `on_pre_open` and `on_pre_dismiss`. .. versionchanged:: 2.0.0 Added property 'overlay_color'. .. versionchanged:: 2.1.0 Marked `attach_to` property as deprecated. TN) deprecatedz5atlas://data/images/defaulttheme/modalview-backgroundrgffffff?g?)Z allownoneZrebindF) on_pre_openon_openon_pre_dismiss on_dismissc sd|_tt|jf|dSN)_parentsuperr__init__)selfkwargs __class__6/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/modalview.pyrszModalView.__init__csddlm}jrdS|_d_d||jjjd|j _ dj dj| d drt d j d }|jfd d d|nd _ddS)zDisplay the modal in the Window. When the view is opened, it will be faded in with an animation. If you don't want the animation, use:: view.open(animation=False) rWindowNTrZ on_resizeZ on_keyboardcentersize animationg? _anim_alphadcs dS)Nr)dispatch)_argsrrrz ModalView.open..)Z on_completer)kivy.core.windowr_is_open_windowr% add_widgetbind _align_center_handle_keyboardrZfbindgetr_anim_durationstartr#)rr&rrZanirr'ropens(     zModalView.opencOsj|js dS|d|ddkr6|dddk r6dS|ddrXtd|jd |nd |_|dS) a Close the view if it is open. If you really want to close the view, whatever the on_dismiss event returns, you can use the *force* keyword argument:: view = ModalView() view.dismiss(force=True) When the view is dismissed, it will be faded out before being removed from the parent. If you don't want this animation, use:: view.dismiss(animation=False) NrrTforceFr!gr"r)r+r%r1rr2r3r#_real_remove_widget)rr&rrrrdismisss  zModalView.dismisscGs|jr|jj|_dSr)r+r,r)rr&rrrr/szModalView._align_centercst||dS)NT)r on_motion)retypemerrrr8szModalView.on_motioncs*|j|j|_|jr|jr&t|dS)z touch down event handler. T)Z collide_pointpos_touch_started_inside auto_dismissr on_touch_downrtouchrrrr>s  zModalView.on_touch_downcs|jr |jrt|dS)z touch moved event handler. T)r=r<r on_touch_mover?rrrrA s  zModalView.on_touch_movecs0|jr|jdkr|n t|d|_dS)z touch up event handler. FNT)r=r<r7r on_touch_upr?rrrrBs   zModalView.on_touch_upcCs|dkr|jr|dS)z animation progress callback. rN)r+r6)rZ _instancevaluerrron__anim_alphaszModalView.on__anim_alphacCs:|js dS|j||jj|j|jdd|_d|_dS)NrF)r+r,Z remove_widgetZunbindr/r0r'rrrr6"s zModalView._real_remove_widgetcCsdS)z! default pre-open event handler. Nrr'rrrr,szModalView.on_pre_opencCsdS)z default open event handler. Nrr'rrrr/szModalView.on_opencCsdS)z$ default pre-dismiss event handler. Nrr'rrrr2szModalView.on_pre_dismisscCsdS)z default dismiss event handler. Nrr'rrrr5szModalView.on_dismisscGs|dkr|jr|dSdS)NT)r=r7)rr,keyr&rrrr08szModalView._handle_keyboard)&__name__ __module__ __qualname____doc__rr=rZ attach_tor Zbackground_colorrZ backgroundrZborderZ overlay_colorrr#r2r,r+r<Z __events__rr4r7r/r8r>rArBrDr6rrrrr0 __classcell__rrrrrVs<          r__main__) runTouchApp)Buttonr)Label) GridLayoutr )colszThis is a hello world)text)NN)rS)Z size_hintr  z click me )Z on_releaseN)"rJ__all__Zkivy.animationrZkivy.propertiesrrrrrr Zkivy.uix.anchorlayoutr rrGZ kivy.baserMZkivy.uix.buttonrNr*rZkivy.uix.labelrOZkivy.uix.gridlayoutrPcontentr-viewZlayoutrangexZbtnr.r4rrrrs0L   i