Legacy Documentation: Version 2018.1 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

GUILayout.Space

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static method Space(pixels: float): void;
public static void Space(float pixels);

Description

Insert a space in the current layout group.

The direction of the space is dependent on the layout group you're currently in when issuing the command. If in a vertical group, the space will be vertical.

Note: This will override the GUILayout.ExpandWidth and GUILayout.ExpandHeight


Space of 20px between two buttons.

function OnGUI () {
    GUILayout.Button ("I'm the first button");

// Insert 20 pixels of space between the 2 buttons. GUILayout.Space (20);

GUILayout.Button ("I'm a bit further down"); }
no example available in C#

In horizontal groups, the pixels are measured horizontally:

function OnGUI () {
    GUILayout.BeginHorizontal();
        GUILayout.Button ("I'm the first button");

// Insert 20 pixels of space between the 2 buttons. GUILayout.Space (20);

GUILayout.Button ("I'm the second button"); GUILayout.EndHorizontal(); }
no example available in C#

An example that is based on EditorWindow:

no example available in JavaScript
using UnityEngine;
using UnityEditor;

// Example of using GUILayout.Space inside an EditorWindow. // Clicking on the buttons changes the size of the Space.

public class ExampleClass : EditorWindow { [MenuItem("Examples/GUILayout.Space")] static void CreateWindow() { EditorWindow window = GetWindow<ExampleClass>(); window.Show(); }

private float spaceSize = 20.0f;

void OnGUI() { if (GUILayout.Button("Button1: Move Button2 down by 2 pixels")) { spaceSize = spaceSize + 2.0f; }

GUILayout.Space(spaceSize);

if (GUILayout.Button("Button2: Move up by 1 pixel")) { spaceSize = spaceSize - 1.0f; } } }

Did you find this page useful? Please give it a rating: