Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

BoxContainer

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

派生: HBoxContainer, VBoxContainer

将子控件横向或纵向排列的容器。

描述

将子控件横向或纵向排列的容器,会在这些控件的最小尺寸发生改变时自动重排。

教程

属性

AlignmentMode

alignment

0

bool

vertical

false

方法

Control

add_spacer(begin: bool)

主题属性

int

separation

4


枚举

enum AlignmentMode: 🔗

AlignmentMode ALIGNMENT_BEGIN = 0

子控件会被排列在该容器的开头,如果是垂直朝向则为顶部,如果是水平朝向则为左侧(RTL 布局时为右侧)。

AlignmentMode ALIGNMENT_CENTER = 1

子控件会在该容器里居中。

AlignmentMode ALIGNMENT_END = 2

子控件会被排列在该容器的末尾,如果是垂直朝向则为底部,如果是水平朝向则为右侧(RTL 布局时为左侧)。


属性说明

AlignmentMode alignment = 0 🔗

该容器子节点的对齐方式(必须是 ALIGNMENT_BEGINALIGNMENT_CENTERALIGNMENT_END 之一)。


bool vertical = false 🔗

  • void set_vertical(value: bool)

  • bool is_vertical()

如果为 true,则该 BoxContainer 会将子节点垂直排列,否则会水平排列。

使用 HBoxContainerVBoxContainer 时无法改变。


方法说明

Control add_spacer(begin: bool) 🔗

添加 Control 节点作为间隔。如果 begintrue,则会将该 Control 节点添加到所有其他节点之前。


主题属性说明

int separation = 4 🔗

BoxContainer 元素之间的距离,单位为像素。