Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

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

GUI.Label

static function Label(position: Rect, text: string): void;
static void Label(Rect position, string text);
static def Label(position as Rect, text as string) as void
static function Label(position: Rect, image: Texture): void;
static void Label(Rect position, Texture image);
static def Label(position as Rect, image as Texture) as void
static function Label(position: Rect, content: GUIContent): void;
static void Label(Rect position, GUIContent content);
static def Label(position as Rect, content as GUIContent) as void
static function Label(position: Rect, text: string, style: GUIStyle): void;
static void Label(Rect position, string text, GUIStyle style);
static def Label(position as Rect, text as string, style as GUIStyle) as void
static function Label(position: Rect, image: Texture, style: GUIStyle): void;
static void Label(Rect position, Texture image, GUIStyle style);
static def Label(position as Rect, image as Texture, style as GUIStyle) as void
static function Label(position: Rect, content: GUIContent, style: GUIStyle): void;
static void Label(Rect position, GUIContent content, GUIStyle style);
static def Label(position as Rect, content as GUIContent, style as GUIStyle) as void

Parameters

positionRectangle on the screen to use for the label.
textText to display on the label.
image Texture to display on the label.
contentText, image and tooltip for this label.
styleThe style to use. If left out, the label style from the current GUISkin is used.

Description

Make a text or texture label on screen.

Labels have no user interaction, do not catch mouse clicks and are always rendered in normal style. If you want to make a control that responds visually to user input, use a Box control.

Example: Draw the classic Hello World! string:


Text label on the Game View.

	function OnGUI () {
		GUI.Label (Rect (10, 10, 100, 20), "Hello World!");
	}
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void OnGUI() {
        GUI.Label(new Rect(10, 10, 100, 20), "Hello World!");
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def OnGUI() as void:
		GUI.Label(Rect(10, 10, 100, 20), 'Hello World!')

Example: Draw a texture on-screen. Labels are also used to display textures, instead of a string, simply pass in a texture:


Texture Label.

	var textureToDisplay : Texture2D;
	
	function OnGUI () {
		GUI.Label (Rect (10, 40, textureToDisplay.width, textureToDisplay.height),
			textureToDisplay);
	}
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Texture2D textureToDisplay;
    void OnGUI() {
        GUI.Label(new Rect(10, 40, textureToDisplay.width, textureToDisplay.height), textureToDisplay);
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	public textureToDisplay as Texture2D

	def OnGUI() as void:
		GUI.Label(Rect(10, 40, textureToDisplay.width, textureToDisplay.height), textureToDisplay)