Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

BoxContainer

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

派生: HBoxContainer, VBoxContainer

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

描述

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

教程

属性

AlignmentMode

alignment

0

bool

vertical

false

方法

Control

add_spacer ( bool begin )

主题属性

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 ( bool value )

  • bool is_vertical ( )

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

使用 HBoxContainerVBoxContainer 时无法改变。


方法说明

Control add_spacer ( bool begin )

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


主题属性说明

int separation = 4

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