Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Popup

Inherits: Control < CanvasItem < Node < Object

Inherited By: PopupDialog, PopupMenu, PopupPanel, WindowDialog

Control del contenedor base para los popups y diálogos.

Descripción

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. All popup methods ensure correct placement within the viewport.

Propiedades

bool	popup_exclusive	false
bool	visible	false (overrides CanvasItem)

Métodos

void	popup ( Rect2 bounds=Rect2( 0, 0, 0, 0 ) )
void	popup_centered ( Vector2 size=Vector2( 0, 0 ) )
void	popup_centered_clamped ( Vector2 size=Vector2( 0, 0 ), float fallback_ratio=0.75 )
void	popup_centered_minsize ( Vector2 minsize=Vector2( 0, 0 ) )
void	popup_centered_ratio ( float ratio=0.75 )
void	set_as_minsize ( )

Señales

• about_to_show ( )

Emitted when a popup is about to be shown. This is often used in PopupMenu to clear the list of options then create a new one according to the current context.

---

• popup_hide ( )

Emitido cuando un popup está oculto.

Constantes

• NOTIFICATION_POST_POPUP = 80 --- Notification sent right after the popup is shown.

• NOTIFICATION_POPUP_HIDE = 81 --- Notification sent right after the popup is hidden.

Descripciones de Propiedades

• bool popup_exclusive

Default	false
Setter	set_exclusive(value)
Getter	is_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.

Note: Enabling this property doesn't affect the Close or Cancel buttons' behavior in dialogs that inherit from this class. As a workaround, you can use WindowDialog.get_close_button or ConfirmationDialog.get_cancel and hide the buttons in question by setting their CanvasItem.visible property to false.

Descripciones de Métodos

• 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_clamped ( Vector2 size=Vector2( 0, 0 ), float fallback_ratio=0.75 )

Popup (show the control in modal form) in the center of the screen relative to the current canvas transform, clamping the size to size, then ensuring the popup is no larger than the viewport size multiplied by fallback_ratio.

---

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

---

• void set_as_minsize ( )

Shrink popup to keep to the minimum size of content.