AspectRatioContainer

Inherits: Container < Control < CanvasItem < Node < Object

保留其子控件长宽比的容器。

描述

以一种方式安排子控件,以便在容器调整大小时自动保留其长宽比。解决了容器大小是动态的,而内容的大小需要相应调整而不失去比例的问题。

枚举

enum StretchMode:

  • STRETCH_WIDTH_CONTROLS_HEIGHT = 0 --- 子控件的高度会根据容器的宽度自动调整。

  • STRETCH_HEIGHT_CONTROLS_WIDTH = 1 --- 子控件的宽度会根据容器的高度自动调整。

  • STRETCH_FIT = 2 --- 子控件的边界矩形会自动调整以适应容器,同时保持长宽比。

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

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


enum AlignMode:

  • ALIGN_BEGIN = 0 --- 将子控件与容器的开头对齐,左侧或顶部。

  • ALIGN_CENTER = 1 --- 使子控件与容器的中心对齐。

  • ALIGN_END = 2 --- 将子控件与容器的末端对齐,右侧或底部。

属性说明

Default

1

Setter

set_alignment_horizontal(value)

Getter

get_alignment_horizontal()

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


Default

1

Setter

set_alignment_vertical(value)

Getter

get_alignment_vertical()

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


Default

1.0

Setter

set_ratio(value)

Getter

get_ratio()

对子控件强制实施的长宽比。这是宽度除以高度。这个比例取决于stretch_mode


Default

2

Setter

set_stretch_mode(value)

Getter

get_stretch_mode()

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