AspectRatioContainer
继承： Container < Control < CanvasItem < Node < Object
A container that preserves the proportions of its child controls.
描述
A container type that arranges its child controls in a way that preserves their proportions automatically when the container is resized. Useful when a container has a dynamic size and the child nodes must adjust their sizes accordingly without losing their aspect ratios.
属性
| AlignmentMode | alignment_horizontal |
| AlignmentMode | alignment_vertical |
float | ratio |
| StretchMode | stretch_mode |
枚举
enum StretchMode:
StretchMode STRETCH_WIDTH_CONTROLS_HEIGHT = 0
The height of child controls is automatically adjusted based on the width of the container.
StretchMode STRETCH_HEIGHT_CONTROLS_WIDTH = 1
The width of child controls is automatically adjusted based on the height of the container.
StretchMode STRETCH_FIT = 2
The bounding rectangle of child controls is automatically adjusted to fit inside the container while keeping the aspect ratio.
StretchMode STRETCH_COVER = 3
The width and height of child controls is automatically adjusted to make their bounding rectangle cover the entire area of the container while keeping the aspect ratio.
When the bounding rectangle of child controls exceed the container's size and Control.clip_contents is enabled, this allows to show only the container's area restricted by its own bounding rectangle.
enum AlignmentMode:
AlignmentMode ALIGNMENT_BEGIN = 0
Aligns child controls with the beginning (left or top) of the container.
AlignmentMode ALIGNMENT_CENTER = 1
Aligns child controls with the center of the container.
AlignmentMode ALIGNMENT_END = 2
Aligns child controls with the end (right or bottom) of the container.
属性说明
AlignmentMode alignment_horizontal = 1
voidset_alignment_horizontal ( value: AlignmentMode )- AlignmentMode get_alignment_horizontal ( )
Specifies the horizontal relative position of child controls.
AlignmentMode alignment_vertical = 1
voidset_alignment_vertical ( value: AlignmentMode )- AlignmentMode get_alignment_vertical ( )
Specifies the vertical relative position of child controls.
float ratio = 1.0
The aspect ratio to enforce on child controls. This is the width divided by the height. The ratio depends on the stretch_mode.
StretchMode stretch_mode = 2
voidset_stretch_mode ( value: StretchMode )- StretchMode get_stretch_mode ( )
The stretch mode used to align child controls.
本方法通常需要用户覆盖才能生效。
本方法无副作用，不会修改该实例的任何成员变量。
本方法除了能接受在此处描述的参数外，还能够继续接受任意数量的参数。
本方法用于构造某个类型。
调用本方法无需实例，可直接使用类名进行调用。
本方法描述的是使用本类型作为左操作数的有效运算符。
这个值是由下列位标志构成位掩码的整数。
无返回值。