Popup

Inherits: Control < CanvasItem < Node < Object

Inherited By: PopupDialog, PopupMenu, PopupPanel, WindowDialog

用于弹出窗口和对话框的基本容器控件。

描述

Popup 是基本的 Control，用于显示对话框和弹出窗口。默认情况下，它是一个子窗口和模态，参阅 Control，并具有自定义弹出行为的辅助程序。所有弹出方法都确保在视窗中正确放置。

属性

bool	popup_exclusive	false
bool	visible	false (overrides CanvasItem)

方法

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

信号

• about_to_show ( )

当弹出窗口即将显示时发出。这通常在 PopupMenu 中用于清除选项列表，然后根据当前上下文创建一个新选项。

---

• popup_hide ( )

当弹出窗口被隐藏时发出.

常量

• NOTIFICATION_POST_POPUP = 80 --- 在弹出窗口显示后立即发送通知。

• NOTIFICATION_POPUP_HIDE = 81 --- 在弹出窗口被隐藏后立即发送通知。

属性说明

• bool popup_exclusive

Default	false
Setter	set_exclusive(value)
Getter	is_exclusive()

如果true，当点击事件发生在它之外，或者当它收到ui_cancel动作事件时，弹出窗口不会被隐藏。

注意： 启用此属性不会影响从此类继承的对话框中关闭或取消按钮的行为。作为解决方法，您可以使用 WindowDialog.get_close_button 或 ConfirmationDialog.get_cancel 并通过将其 CanvasItem.visible 属性设置为 false 来隐藏有问题的按钮。

方法说明

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

弹出窗口（以模态形式显示控件）。

---

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

根据相对于当前画布转换、当前大小或由 size 确定的大小，在屏幕中央弹出窗口（以模态形式显示控制）。

---

• void popup_centered_clamped ( Vector2 size=Vector2( 0, 0 ), float fallback_ratio=0.75 )

相对于当前画布变换在屏幕中央弹出（以模态形式显示控件），将大小限制为size，并确保弹出窗口不大于视口大小乘以fallback_ratio。

---

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

相对于当前画布变换在屏幕中央弹出（以模态形式显示控件），确保尺寸永远不会小于 minsize。

---

• void popup_centered_ratio ( float ratio=0.75 )

相对于当前画布变换在屏幕中央弹出（以模态形式显示控件），按屏幕大小的比例缩放。

---

• void set_as_minsize ( )

缩小弹出窗口以保持内容的最小大小。