Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


TextField

Make a single-line text field where the user can edit a string.
Read time 4 minutesLast updated 9 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.IMGUIModule

TextField(string, GUILayoutOption[])

Make a single-line text field where the user can edit a string.
public static string TextField(string text, params GUILayoutOption[] options)

Parameters

text

Text to edit. The return value of this function should be assigned back to the string as shown in the example.

An optional list of layout options that specify extra layouting properties. Any values passed in here will override settings defined by the
style
.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

stringThe edited string.

Remarks

GUILayoutTextField (TextField)
Text field in the GameView.

Examples

using UnityEngine;public class ExampleScript : MonoBehaviour{ string stringToEdit = "Hello World"; void OnGUI() { // Make a text field that modifies stringToEdit. stringToEdit = GUILayout.TextField(stringToEdit, 25); }}

TextField(string, int, GUILayoutOption[])

Make a single-line text field where the user can edit a string.
public static string TextField(string text, int maxLength, params GUILayoutOption[] options)

Parameters

text

Text to edit. The return value of this function should be assigned back to the string as shown in the example.

maxLength

The maximum length of the string. If left out, the user can type for ever and ever.

An optional list of layout options that specify extra layouting properties. Any values passed in here will override settings defined by the
style
.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

stringThe edited string.

Remarks

GUILayoutTextField (TextField)
Text field in the GameView.

Examples

using UnityEngine;public class ExampleScript : MonoBehaviour{ string stringToEdit = "Hello World"; void OnGUI() { // Make a text field that modifies stringToEdit. stringToEdit = GUILayout.TextField(stringToEdit, 25); }}

TextField(string, GUIStyle, GUILayoutOption[])

Make a single-line text field where the user can edit a string.
public static string TextField(string text, GUIStyle style, params GUILayoutOption[] options)

Parameters

text

Text to edit. The return value of this function should be assigned back to the string as shown in the example.

The style to use. If left out, the
textArea
style from the current GUISkin is used.

An optional list of layout options that specify extra layouting properties. Any values passed in here will override settings defined by the
style
.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

stringThe edited string.

Remarks

GUILayoutTextField (TextField)
Text field in the GameView.

Examples

using UnityEngine;public class ExampleScript : MonoBehaviour{ string stringToEdit = "Hello World"; void OnGUI() { // Make a text field that modifies stringToEdit. stringToEdit = GUILayout.TextField(stringToEdit, 25); }}

TextField(string, int, GUIStyle, GUILayoutOption[])

Make a single-line text field where the user can edit a string.
public static string TextField(string text, int maxLength, GUIStyle style, params GUILayoutOption[] options)

Parameters

text

Text to edit. The return value of this function should be assigned back to the string as shown in the example.

maxLength

The maximum length of the string. If left out, the user can type for ever and ever.

The style to use. If left out, the
textArea
style from the current GUISkin is used.

An optional list of layout options that specify extra layouting properties. Any values passed in here will override settings defined by the
style
.
Additional Resources: GUILayout.Width, GUILayout.Height, GUILayout.MinWidth, GUILayout.MaxWidth, GUILayout.MinHeight, GUILayout.MaxHeight, GUILayout.ExpandWidth, GUILayout.ExpandHeight.

Returns

Type

Description

stringThe edited string.

Remarks

GUILayoutTextField (TextField)
Text field in the GameView.

Examples

using UnityEngine;public class ExampleScript : MonoBehaviour{ string stringToEdit = "Hello World"; void OnGUI() { // Make a text field that modifies stringToEdit. stringToEdit = GUILayout.TextField(stringToEdit, 25); }}