SubViewportContainer

继承： Container < Control < Item < Object

用于显示SubViewport内容的容器。

描述

显示底层SubViewport子节点内容的容器。它使用SubViewport的组合大小作为最小大小，除非启用了stretch。

注意：更改SubViewportContainer的Control.scale将导致其内容显示失真。要更改其视觉大小而不会导致失真，请改为调整节点的边距（如果它还没有在容器中）。

注意：SubViewportContainer将鼠标进入和鼠标退出通知转发到其子视口。

属性

FocusMode	focus_mode	1 (overrides Control)
bool	mouse_target	false
bool	stretch	false
int	stretch_shrink	1

方法

bool	_propagate_input_event(event: InputEvent) virtual const

---

属性说明

bool mouse_target = false 🔗

• void set_mouse_target(value: bool)

• bool is_mouse_target_enabled()

配置，如果SubViewportContainer或SubViewport子节点的Control节点应作为鼠标相关功能的目标可用，例如识别拖放操作中的拖放目标或悬停Control节点的光标形状。

如果false，则其SubViewport子级内的Control节点被视为目标。

如果true，则SubViewportContainer本身将被视为目标。

---

bool stretch = false 🔗

• void set_stretch(value: bool)

• bool is_stretch_enabled()

如果true，则子视口将自动调整为控件的大小。

注意：如果true，这将禁止手动更改其子级的SubViewport.size。

---

int stretch_shrink = 1 🔗

• void set_stretch_shrink(value: int)

• int get_stretch_shrink()

将子视口的有效分辨率除以此值，同时保留其比例。这可用于加快渲染速度。

例如，将stretch_shrink设置为2的1280×720子视口将以640×360渲染，同时在容器中占用相同的大小。

注意：stretch必须是true此属性才能工作。

---

方法说明

bool _propagate_input_event(event: InputEvent) virtual const 🔗

实验性： 未来版本中可能会修改或移除该方法。

由用户实现的虚拟方法。如果它返回true，则event将传播给SubViewport子级。如果它返回false，则不会发生传播。如果该函数未实现，则所有事件都将传播到SubViewport。