使用容器

錨點是在 GUI 中進行基礎多解析度與不同螢幕比例處理的高效方法。

對於更複雜的使用者介面，錨點就會變得難以操作。

這通常發生在遊戲中，例如角色扮演、線上聊天、經營或模擬類型。另一個常見需要進階佈局功能的場景是遊戲內工具（或一般工具）。

這些情境都需要更強大、類似作業系統的使用者介面，具備進階佈局與格式功能。此時，Container 會更適合。

容器佈局

容器提供了強大的佈局功能（例如，Godot 編輯器的使用者介面就是完全用容器製作的）：

當你使用 Container 衍生節點時，所有作為子項的 Control 節點都會放棄自身定位能力。這表示容器會接管它們的位置控制，任何手動調整這些節點位置的動作，都會在父節點下次調整大小時被忽略或覆蓋。

同樣地，當 Container 衍生節點被調整大小時，它的所有子節點會根據容器類型自動重新定位：

HBoxContainer 調整子按鈕大小的範例。

容器最大的優勢在於它們可以巢狀（作為節點），讓你能輕鬆建立可自動調整的複雜佈局。

尺寸選項

將節點加入容器時，容器如何處理每個子節點，主要取決於它們的 尺寸旗標。這些旗標可在 Container 的子 Control 節點的佈局屬性中找到。

尺寸旗標在垂直和水平方向上是獨立的，雖然不是每種容器都會用到，但大多數容器都會使用這些旗標：

填充（Fill）：確保控制項填滿容器內指定區域。不論控制項是否 擴展*（見下方），只有啟用這個選項時（預設為開啟），才會 *填充 指定區域。
擴展（Expand）：在父容器內（於各軸）盡可能佔用空間。未啟用擴展的控制項會被啟用擴展的控制項擠開。多個擴展控制項之間的空間分配，取決於 比例（Stretch Ratio）*（詳見下方）。此選項僅當父容器支援時才可用，例如 *HBoxContainer 支援水平擴展。
收縮起始（Shrink Begin）：當啟用擴展時，盡量保持在擴展區域的左側或頂部。
收縮置中（Shrink Center）：當啟用擴展時，盡量保持在擴展區域的中央。
收縮結尾（Shrink End）：當啟用擴展時，盡量保持在擴展區域的右側或底部。
比例（Stretch Ratio）：決定多個啟用擴展的控制項相互分配可用空間的比例。例如，比例設為「2」的控制項將獲得比例為「1」的兩倍空間。

建議實際嘗試這些旗標與不同類型的容器，以更深入理解它們的運作原理。

容器類型

Godot 內建多種容器類型，以因應不同的使用需求：

盒式容器

將子控制項依指定方向（垂直或水平）排列（分別為 HBoxContainer 和 VBoxContainer）。在非排列方向（例如水平方向的容器在垂直方向），子節點只會被擴展。

這些容器會對啟用 擴展（Expand） 的子節點，套用 比例（Stretch Ratio） 屬性。

網格容器

將子控制項以網格方式排列（使用 GridContainer，須設定欄數），同時支援垂直和水平擴展旗標。

邊距容器

子控制項會被擴展至本容器邊界（使用 MarginContainer）。邊距（Padding）會依據主題設定自動加入。

請注意，邊距屬於主題設定值，需在各控制項的「常數覆寫」欄位中調整：

分頁容器

允許將多個子控制項堆疊（使用 TabContainer），僅顯示當前（目前）的那一個。

可以透過點擊容器頂端的分頁來切換顯示目前的子控制項：

分頁標題預設會根據節點名稱產生（也可透過 TabContainer API 進行覆寫）。

如分頁位置、StyleBox 等設定，可於 TabContainer 的主題覆寫中調整。

分割容器

僅接受一至兩個子控制項，並以分隔線並排顯示（使用 HSplitContainer 和 VSplitContainer）。支援水平與垂直旗標，以及比例屬性。

你可以拖曳分隔線來調整兩個子控制項的尺寸比例：

PanelContainer

這個容器會繪製 StyleBox，並將子節點擴展覆蓋整個區域（通過 PanelContainer，會考慮 StyleBox 邊距）。同時支援水平與垂直尺寸選項。

這個容器適合用作頂層容器，也很適合為佈局區塊新增自訂背景。

FoldableContainer

可展開/收合的容器（透過 FoldableContainer）。收合時會隱藏其子控制項。

ScrollContainer

只接受一個子節點。若子節點的尺寸大於容器，會加入捲動條以便平移該節點（透過 ScrollContainer）。垂直與水平的尺寸選項都會被遵守，且可在屬性中針對各軸向啟用或停用此行為。

你也可以用滑鼠滾輪或觸控拖曳（若裝置支援）來移動子控制項。

如上例所示，這個容器最常見的用法，是配合 VBoxContainer 作為子節點共同使用。

比例容器

這是一種會在容器調整大小時，自動保持子控制項長寬比例的容器（使用 AspectRatioContainer）。它具備多種伸展模式，包括「填滿」、「寬度控制高度」、「高度控制寬度」及「覆蓋」等選項，可彈性調整子控制項的尺寸

當你需要讓容器能夠動態因應不同螢幕尺寸，並希望子元素能維持比例縮放而不失真時，這個容器很實用。

流式容器

FlowContainer 會將子控制項依水平方向或垂直方向排列（分別為 HFlowContainer 與 VFlowContainer）。當可用空間不足時，會自動換行或換欄，類似文字在書本中的換行。

這種容器適合建立彈性佈局，讓子控制項自動依可用空間調整排列，避免重疊。

置中容器

置中容器會自動將所有子控制項以其最小尺寸置中對齊於容器內。不需手動調整，即可輕鬆實現置中佈局（使用 CenterContainer）。

SubViewportContainer

這是個特殊控制項，只能接受單一 Viewport 節點作為子節點，並將其當作圖片顯示（使用 SubViewportContainer）。

建立自訂容器

可以用腳本建立自訂容器。以下是一個會讓子節點適應自身大小的容器範例：

extends Container

func _notification(what):
    if what == NOTIFICATION_SORT_CHILDREN:
        # Must re-sort the children
        for c in get_children():
            # Fit to own size
            fit_child_in_rect(c, Rect2(Vector2(), size))

func set_some_setting():
    # Some setting changed, ask for children re-sort.
    queue_sort()

using Godot;

public partial class CustomContainer : Container
{
    public override void _Notification(int what)
    {
        if (what == NotificationSortChildren)
        {
            // Must re-sort the children
            foreach (Control c in GetChildren())
            {
                // Fit to own size
                FitChildInRect(c, new Rect2(new Vector2(), Size));
            }
        }
    }

    public void SetSomeSetting()
    {
        // Some setting changed, ask for children re-sort.
        QueueSort();
    }
}