Container

Inherits: Control < CanvasItem < Node < Object

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

Base node for containers.

Description

Base node for containers. A Container contains other controls and automatically arranges them in a certain way.

A Control can inherit this to create custom container classes.

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

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.


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.


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.