80e9e93e27
- Also replace redundant duplicate code in editor dialogs with calls to popup_centered_clamped()
85 lines
3.3 KiB
XML
85 lines
3.3 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="Popup" inherits="Control" category="Core" version="3.2">
|
|
<brief_description>
|
|
Base container control for popups and dialogs.
|
|
</brief_description>
|
|
<description>
|
|
Popup is a base [Control] used to show dialogs and popups. It's a subwindow and modal by default (see [Control]) and has helpers for custom popup behavior.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="popup">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bounds" type="Rect2" default="Rect2( 0, 0, 0, 0 )">
|
|
</argument>
|
|
<description>
|
|
Popup (show the control in modal form).
|
|
</description>
|
|
</method>
|
|
<method name="popup_centered">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="size" type="Vector2" default="Vector2( 0, 0 )">
|
|
</argument>
|
|
<description>
|
|
Popup (show the control in modal form) in the center of the screen relative to its current canvas transform, at the current size, or at a size determined by "size".
|
|
</description>
|
|
</method>
|
|
<method name="popup_centered_clamped">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="size" type="Vector2" default="Vector2( 0, 0 )">
|
|
</argument>
|
|
<argument index="1" name="fallback_ratio" type="float" default="0.75">
|
|
</argument>
|
|
<description>
|
|
Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, clamping the size to [code]size[/code], then ensuring the popup is no larger than the viewport size multiplied by [code]fallback_ratio[/code].
|
|
</description>
|
|
</method>
|
|
<method name="popup_centered_minsize">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="minsize" type="Vector2" default="Vector2( 0, 0 )">
|
|
</argument>
|
|
<description>
|
|
Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, ensuring the size is never smaller than [code]minsize[/code].
|
|
</description>
|
|
</method>
|
|
<method name="popup_centered_ratio">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="ratio" type="float" default="0.75">
|
|
</argument>
|
|
<description>
|
|
Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, scaled at a ratio of size of the screen.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="popup_exclusive" type="bool" setter="set_exclusive" getter="is_exclusive">
|
|
If [code]true[/code], the popup will not be hidden when a click event occurs outside of it, or when it receives the [code]ui_cancel[/code] action event.
|
|
</member>
|
|
</members>
|
|
<signals>
|
|
<signal name="about_to_show">
|
|
<description>
|
|
This signal is emitted when a popup is about to be shown. (often used in [PopupMenu] for clearing the list of options and creating a new one according to the current context).
|
|
</description>
|
|
</signal>
|
|
<signal name="popup_hide">
|
|
<description>
|
|
This signal is emitted when a popup is hidden.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
<constants>
|
|
<constant name="NOTIFICATION_POST_POPUP" value="80">
|
|
Notification sent right after the popup is shown.
|
|
</constant>
|
|
<constant name="NOTIFICATION_POPUP_HIDE" value="81">
|
|
Notification sent right after the popup is hidden.
|
|
</constant>
|
|
</constants>
|
|
</class>
|