GridContainer (original) (raw)

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.

Checking the stable version of the documentation...

Inherits: Container < Control < CanvasItem < Node < Object

A container that arranges its child controls in a grid layout.

Description

GridContainer arranges its child controls in a grid layout. The number of columns is specified by the columns property, whereas the number of rows depends on how many are needed for the child controls. The number of rows and columns is preserved for every size of the container.

Note: GridContainer only works with child nodes inheriting from Control. It won't rearrange child nodes inheriting from Node2D.

Tutorials

Properties

Theme Properties

Property Descriptions

int columns = 1 🔗

void set_columns(value: int)
int get_columns()

The number of columns in the GridContainer. If modified, GridContainer reorders its Control-derived children to accommodate the new layout.

Theme Property Descriptions

int h_separation = 4 🔗

The horizontal separation of child nodes.

int v_separation = 4 🔗

The vertical separation of child nodes.