U Pe@sPdZdZddlmZddlmZddlmZmZm Z m Z m Z Gddde Z Gdd d eZed krLdd lmZdd lmZdd lmZddlmZddlmZeddZeddddZeeddeeedddeddZejejdeddZ e!dD],Z"ee#e"dZ$e$jej%de e$qee e%edS) a Popup ===== .. versionadded:: 1.0.7 .. image:: images/popup.jpg :align: right The :class:`Popup` widget is used to create modal popups. By default, the popup will cover the whole "parent" window. When you are creating a popup, you must at least set a :attr:`Popup.title` and :attr:`Popup.content`. Remember that the default size of a Widget is size_hint=(1, 1). If you don't want your popup to be fullscreen, either use size hints with values less than 1 (for instance size_hint=(.8, .8)) or deactivate the size_hint and use fixed size attributes. .. versionchanged:: 1.4.0 The :class:`Popup` class now inherits from :class:`~kivy.uix.modalview.ModalView`. The :class:`Popup` offers a default layout with a title and a separation bar. Examples -------- Example of a simple 400x400 Hello world popup:: popup = Popup(title='Test popup', content=Label(text='Hello world'), size_hint=(None, None), size=(400, 400)) By default, any click outside the popup will dismiss/close it. If you don't want that, you can set :attr:`~kivy.uix.modalview.ModalView.auto_dismiss` to False:: popup = Popup(title='Test popup', content=Label(text='Hello world'), auto_dismiss=False) popup.open() To manually dismiss/close the popup, use :attr:`~kivy.uix.modalview.ModalView.dismiss`:: popup.dismiss() Both :meth:`~kivy.uix.modalview.ModalView.open` and :meth:`~kivy.uix.modalview.ModalView.dismiss` are bindable. That means you can directly bind the function to an action, e.g. to a button's on_press:: # create content and add to the popup content = Button(text='Close me!') popup = Popup(content=content, auto_dismiss=False) # bind the on_press event of the button to the dismiss function content.bind(on_press=popup.dismiss) # open the popup popup.open() Same thing in KV language only with :class:`Factory`: .. code-block:: kv #:import Factory kivy.factory.Factory : auto_dismiss: False Button: text: 'Close me!' on_release: root.dismiss() Button: text: 'Open popup' on_release: Factory.MyPopup().open() .. note:: Popup is a special widget. Don't try to add it as a child to any other widget. If you do, Popup will be handled like an ordinary widget and won't be created hidden in the background. .. code-block:: kv BoxLayout: MyPopup: # bad! Popup Events ------------ There are two events available: `on_open` which is raised when the popup is opening, and `on_dismiss` which is raised when the popup is closed. For `on_dismiss`, you can prevent the popup from closing by explicitly returning True from your callback:: def my_callback(instance): print('Popup', instance, 'is being dismissed but is prevented!') return True popup = Popup(content=Label(text='Hello world')) popup.bind(on_dismiss=my_callback) popup.open() )PopupPopupException) DEFAULT_FONT) ModalView)StringPropertyObjectPropertyOptionPropertyNumericProperty ColorPropertyc@seZdZdZdS)rzrPopup exception, fired when multiple content widgets are added to the popup. .. versionadded:: 1.4.0 N)__name__ __module__ __qualname____doc__rr2/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/popup.pyrpsrcseZdZdZedZedZedddddgdZ ee Z e d Z ed d d d gZed d d dgZedZe d ZfddZddZddZfddZZS)raPopup class. See module documentation for more information. :Events: `on_open`: Fired when the Popup is opened. `on_dismiss`: Fired when the Popup is closed. If the callback returns True, the dismiss will be canceled. zNo titleZ14spleftcenterrightZjustify)optionsNg?g?g?g?Z2dpcs8|jr|jrtd||_ntt|j|f||dS)Nz)Popup can have only one widget as content) _containercontentrsuperr add_widget)selfZwidgetargskwargs __class__rrrszPopup.add_widgetcCs |jr|j|j|dSN)r clear_widgetsrrinstancevaluerrr on_contents zPopup.on_contentcCs2|dks|jdkrdS|j|j|jdSr)rrr rr!rrr on__containers zPopup.on__containercs&|jr|j|jrdStt||S)NT)disabledZ collide_pointposrr on_touch_down)rtouchrrrr(szPopup.on_touch_down)r r r rrtitler Z title_sizerZ title_alignrZ title_fontrrr Z title_colorZseparator_colorZseparator_heightrrr$r%r( __classcell__rrrrrxs"         r__main__) runTouchApp)Button)Label) GridLayout)Windowr)colsZCancelN()textZ size_hint_yheightzThis is a hello world)r4z Test popup)NN)r6T)r*Z size_hintsizerr&)Z on_release )&r__all__Zkivy.core.textrZkivy.uix.modalviewrZkivy.propertiesrrrr r Exceptionrrr Z kivy.baser-Zkivy.uix.buttonr.Zkivy.uix.labelr/Zkivy.uix.gridlayoutr0Zkivy.core.windowr1rZcontent_cancelrZpopupbindZdismissZlayoutrangexstrZbtnopenrrrrs>g  w