Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

SubViewportContainer

继承： Container < Control < CanvasItem < Node < Object

用于显示 SubViewport 内容的容器。

描述

显示其 SubViewport 子节点内容的容器。除非启用 stretch，否则会使用 SubViewport 的大小作为最小尺寸。

注意：更改 SubViewportContainer 的 Control.scale，将导致其内容出现扭曲。要更改其视觉大小，并且不造成失真，请改为调整节点的边距（如果还不在容器中）。

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

属性

FocusMode

focus_mode

1 (overrides Control)

bool

stretch

false

int

stretch_shrink

1

方法

bool

_propagate_input_event ( InputEvent event ) virtual const

属性说明

bool stretch = false

  • void set_stretch ( bool value )

  • bool is_stretch_enabled ( )

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

注意：如果为 true，则会禁止手动改变其子节点的 SubViewport.size。

int stretch_shrink = 1

  • void set_stretch_shrink ( int value )

  • int get_stretch_shrink ( )

将子视口的有效分辨率除以该值，同时保持比例。可以用来加速渲染。

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

注意：stretch 必须为 true，才能使此属性生效。

方法说明

bool _propagate_input_event ( InputEvent event ) virtual const

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