Up to date

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

MarginContainer¶

Inherits: Container < Control < CanvasItem < Node < Object

A container that keeps a margin around its child controls.

Description¶

MarginContainer adds an adjustable margin on each side of its child controls. The margins are added around all children, not around each individual one. To control the MarginContainer's margins, use the margin_* theme properties listed below.

Note: The margin sizes are theme overrides, not normal properties. This is an example of how to change them in code:

# This code sample assumes the current script is extending MarginContainer.
var margin_value = 100
add_theme_constant_override("margin_top", margin_value)
add_theme_constant_override("margin_left", margin_value)
add_theme_constant_override("margin_bottom", margin_value)
add_theme_constant_override("margin_right", margin_value)

// This code sample assumes the current script is extending MarginContainer.
int marginValue = 100;
AddThemeConstantOverride("margin_top", marginValue);
AddThemeConstantOverride("margin_left", marginValue);
AddThemeConstantOverride("margin_bottom", marginValue);
AddThemeConstantOverride("margin_right", marginValue);

Tutorials¶

Using Containers

Theme Properties¶

int	margin_bottom	`0`
int	margin_left	`0`
int	margin_right	`0`
int	margin_top	`0`

Theme Property Descriptions¶

int margin_bottom = 0

All direct children of MarginContainer will have a bottom margin of margin_bottom pixels.

int margin_left = 0

All direct children of MarginContainer will have a left margin of margin_left pixels.

int margin_right = 0

All direct children of MarginContainer will have a right margin of margin_right pixels.

int margin_top = 0

All direct children of MarginContainer will have a top margin of margin_top pixels.