AspectRatioContainer

继承: Container < Control < CanvasItem < Item < Object

保留其子控件比例的容器。

描述

一种容器类型,在调整容器大小时以自动保留其比例的方式排列其子控件。当容器具有动态大小并且子节点必须相应地调整其大小而不会丢失其纵横比时很有用。

属性


枚举

enum StretchMode: 🔗

StretchMode STRETCH_WIDTH_CONTROLS_HEIGHT = 0

子控件的高度会根据容器的宽度自动调整。

StretchMode STRETCH_HEIGHT_CONTROLS_WIDTH = 1

子控件的宽度会根据容器的高度自动调整。

StretchMode STRETCH_FIT = 2

子控件的边界矩形会自动调整以适应容器内部,同时保持长宽比。

StretchMode STRETCH_COVER = 3

子控件的宽度和高度会自动调整,使其边界矩形覆盖容器的整个区域,同时保持长宽比。

当子控件的边界矩形超过容器的大小并且Control.clip_contents启用时,这允许仅显示容器受其自身边界矩形限制的区域。


enum AlignmentMode: 🔗

AlignmentMode ALIGNMENT_BEGIN = 0

将子控件与容器的开头(左侧或顶部)对齐。

AlignmentMode ALIGNMENT_CENTER = 1

将子控件与容器的中心对齐。

AlignmentMode ALIGNMENT_END = 2

将子控件与容器的末尾(右侧或底部)对齐。


属性说明

AlignmentMode alignment_horizontal = 1 🔗

指定子控件的水平相对位置。


AlignmentMode alignment_vertical = 1 🔗

指定子控件的垂直相对位置。


float ratio = 1.0 🔗

对子控件强制执行的长宽比。这是宽度除以高度。该比率取决于stretch_mode


StretchMode stretch_mode = 2 🔗

用于对齐子控件的拉伸模式。