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.

GridContainer

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

int

columns

1

Theme Properties

int

h_separation

4

int

v_separation

4


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.


User-contributed notes

Please read the User-contributed notes policy before submitting a comment.