Popup

Inherits: Control < CanvasItem < Node < Object

Inherited By: PopupDialog, PopupMenu, PopupPanel, WindowDialog

Category: Core

Brief Description

Base container control for popups and dialogs.

Properties

Methods

Signals

• about_to_show ( )

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).

• popup_hide ( )

This signal is emitted when a popup is hidden.

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 Control used to show dialogs and popups. It’s a subwindow and modal by default (see Control) and has helpers for custom popup behavior.

Property Descriptions

• bool popup_exclusive

If true, the popup will not be hidden when a click event occurs outside of it, or when it receives the ui_cancel action event.

Method Descriptions

• void popup ( Rect2 bounds=Rect2( 0, 0, 0, 0 ) )

Popup (show the control in modal form).

• void popup_centered ( Vector2 size=Vector2( 0, 0 ) )

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”.

• void popup_centered_minsize ( Vector2 minsize=Vector2( 0, 0 ) )

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 minsize.

• void popup_centered_ratio ( float ratio=0.75 )

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.