Up to date

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

Container

Inherits: Control < CanvasItem < Node < Object

Inherited By: AspectRatioContainer, BoxContainer, CenterContainer, EditorProperty, FlowContainer, GraphElement, GridContainer, MarginContainer, PanelContainer, ScrollContainer, SplitContainer, SubViewportContainer, TabContainer

Base class for all GUI containers.

Description

Base class for all GUI containers. A Container automatically arranges its child controls in a certain way. This class can be inherited to make custom container types.

Tutorials

Properties

MouseFilter

mouse_filter

1 (overrides Control)

Methods

PackedInt32Array

_get_allowed_size_flags_horizontal ( ) virtual const

PackedInt32Array

_get_allowed_size_flags_vertical ( ) virtual const

void

fit_child_in_rect ( Control child, Rect2 rect )

void

queue_sort ( )


Signals

pre_sort_children ( )

Emitted when children are going to be sorted.


sort_children ( )

Emitted when sorting the children is needed.


Constants

NOTIFICATION_PRE_SORT_CHILDREN = 50

Notification just before children are going to be sorted, in case there's something to process beforehand.

NOTIFICATION_SORT_CHILDREN = 51

Notification for when sorting the children, it must be obeyed immediately.


Method Descriptions

PackedInt32Array _get_allowed_size_flags_horizontal ( ) virtual const

Implement to return a list of allowed horizontal SizeFlags for child nodes. This doesn't technically prevent the usages of any other size flags, if your implementation requires that. This only limits the options available to the user in the Inspector dock.

Note: Having no size flags is equal to having Control.SIZE_SHRINK_BEGIN. As such, this value is always implicitly allowed.


PackedInt32Array _get_allowed_size_flags_vertical ( ) virtual const

Implement to return a list of allowed vertical SizeFlags for child nodes. This doesn't technically prevent the usages of any other size flags, if your implementation requires that. This only limits the options available to the user in the Inspector dock.

Note: Having no size flags is equal to having Control.SIZE_SHRINK_BEGIN. As such, this value is always implicitly allowed.


void fit_child_in_rect ( Control child, Rect2 rect )

Fit a child control in a given rect. This is mainly a helper for creating custom container classes.


void queue_sort ( )

Queue resort of the contained children. This is called automatically anyway, but can be called upon request.