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 元素之間的距離,單位為圖元。