AspectRatioContainer

Наследует: Container < Control < CanvasItem < Node < Object

Контейнер, сохраняющий пропорции своих дочерних элементов управления.

Описание

Тип контейнера, который размещает свои дочерние элементы управления таким образом, чтобы автоматически сохранять их пропорции при изменении размера контейнера. Полезно, когда контейнер имеет динамический размер, а дочерние узлы должны соответствующим образом корректировать свои размеры, не теряя пропорций.

Обучающие материалы

Использование контейнеров

Свойства

AlignmentMode	alignment_horizontal	`1`
AlignmentMode	alignment_vertical	`1`
float	ratio	`1.0`
StretchMode	stretch_mode	`2`

Перечисления

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 🔗

void set_alignment_horizontal(value: AlignmentMode)
AlignmentMode get_alignment_horizontal()

Задает горизонтальное относительное положение дочерних элементов управления.

AlignmentMode alignment_vertical = 1 🔗

void set_alignment_vertical(value: AlignmentMode)
AlignmentMode get_alignment_vertical()

Задает вертикальное относительное положение дочерних элементов управления.

float ratio = 1.0 🔗

void set_ratio(value: float)
float get_ratio()

Соотношение сторон, применяемое к дочерним элементам управления. Это ширина, деленная на высоту. Соотношение зависит от stretch_mode.

StretchMode stretch_mode = 2 🔗

void set_stretch_mode(value: StretchMode)
StretchMode get_stretch_mode()

Режим растяжения, используемый для выравнивания дочерних элементов управления.