Files
godot-docs/classes/class_popup.rst
2017-11-27 08:32:15 +01:00

97 lines
3.8 KiB
ReStructuredText

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the Popup.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.
.. _class_Popup:
Popup
=====
**Inherits:** :ref:`Control<class_control>` **<** :ref:`CanvasItem<class_canvasitem>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`
**Inherited By:** :ref:`PopupPanel<class_popuppanel>`, :ref:`PopupDialog<class_popupdialog>`, :ref:`PopupMenu<class_popupmenu>`, :ref:`WindowDialog<class_windowdialog>`
**Category:** Core
Brief Description
-----------------
Base container control for popups and dialogs.
Member Functions
----------------
+-------+-------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`popup<class_Popup_popup>` **(** :ref:`Rect2<class_rect2>` bounds=Rect2( 0, 0, 0, 0 ) **)** |
+-------+-------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`popup_centered<class_Popup_popup_centered>` **(** :ref:`Vector2<class_vector2>` size=Vector2( 0, 0 ) **)** |
+-------+-------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`popup_centered_minsize<class_Popup_popup_centered_minsize>` **(** :ref:`Vector2<class_vector2>` minsize=Vector2( 0, 0 ) **)** |
+-------+-------------------------------------------------------------------------------------------------------------------------------------+
| void | :ref:`popup_centered_ratio<class_Popup_popup_centered_ratio>` **(** :ref:`float<class_float>` ratio=0.75 **)** |
+-------+-------------------------------------------------------------------------------------------------------------------------------------+
Signals
-------
.. _class_Popup_about_to_show:
- **about_to_show** **(** **)**
This signal is emitted when a popup is about to be shown. (often used in :ref:`PopupMenu<class_popupmenu>` for clearing the list of options and creating a new one according to the current context).
.. _class_Popup_popup_hide:
- **popup_hide** **(** **)**
This signal is emitted when a popup is hidden.
Member Variables
----------------
.. _class_Popup_popup_exclusive:
- :ref:`bool<class_bool>` **popup_exclusive**
Numeric Constants
-----------------
- **NOTIFICATION_POST_POPUP** = **80** --- Notification sent right after the popup is shown.
- **NOTIFICATION_POPUP_HIDE** = **81** --- Notification sent right after the popup is hidden.
Description
-----------
Popup is a base :ref:`Control<class_control>` used to show dialogs and popups. It's a subwindow and modal by default (see :ref:`Control<class_control>`) and has helpers for custom popup behavior.
Member Function Description
---------------------------
.. _class_Popup_popup:
- void **popup** **(** :ref:`Rect2<class_rect2>` bounds=Rect2( 0, 0, 0, 0 ) **)**
Popup (show the control in modal form).
.. _class_Popup_popup_centered:
- void **popup_centered** **(** :ref:`Vector2<class_vector2>` size=Vector2( 0, 0 ) **)**
Popup (show the control in modal form) in the center of the screen, at the current size, or at a size determined by "size".
.. _class_Popup_popup_centered_minsize:
- void **popup_centered_minsize** **(** :ref:`Vector2<class_vector2>` minsize=Vector2( 0, 0 ) **)**
Popup (show the control in modal form) in the center of the screen, ensuring the size is never smaller than ``minsize``.
.. _class_Popup_popup_centered_ratio:
- void **popup_centered_ratio** **(** :ref:`float<class_float>` ratio=0.75 **)**
Popup (show the control in modal form) in the center of the screen, scaled at a ratio of size of the screen.