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.

TouchScreenKeyboard.Open

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 Open(text: string, keyboardType: TouchScreenKeyboardType = TouchScreenKeyboardType.Default, autocorrection: bool = true, multiline: bool = false, secure: bool = false, alert: bool = false, textPlaceholder: string = "", characterLimit: int = 0): TouchScreenKeyboard;
public static TouchScreenKeyboard Open(string text, TouchScreenKeyboardType keyboardType = TouchScreenKeyboardType.Default, bool autocorrection = true, bool multiline = false, bool secure = false, bool alert = false, string textPlaceholder = "", int characterLimit = 0);

Parameters

textText to edit.
keyboardTypeType of keyboard (eg, any text, numbers only, etc).
autocorrectionIs autocorrection applied?
multilineCan more than one line of text be entered?
secureIs the text masked (for passwords, etc)?
alertIs the keyboard opened in alert mode?
textPlaceholderText to be used if no other text is present.
characterLimitHow many characters the keyboard input field is limited to. 0 = infinite. (Android and iOS only)

Description

Opens the native keyboard provided by OS on the screen.

The autocorrection determines whether the input tracks unknown words and suggests a more suitable replacement candidate to the user, replacing the typed text automatically unless the user explicitly overrides the action. The multiline determines if user can input more than one line of text. The secure identifies whether the keyboard is used for password. Text in the input field will be hidden from the user except the recently typed character. The keyboard can be opened in the alert mode too. The placeholder string will be displayed when there is no other text in the input field of the keyboard.

#pragma strict
public var stringToEdit: String = "Hello World";
private var keyboard: TouchScreenKeyboard;
// Opens native keyboard
function OnGUI() {
	stringToEdit = GUI.TextField(new Rect(10, 10, 200, 30), stringToEdit, 30);
	if (GUI.Button(new Rect(10, 50, 200, 100), "Default")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default);
	}
	if (GUI.Button(new Rect(10, 150, 200, 100), "ASCIICapable")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.ASCIICapable);
	}
	if (GUI.Button(new Rect(10, 250, 200, 100), "Numbers and Punctuation")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NumbersAndPunctuation);
	}
	if (GUI.Button(new Rect(10, 350, 200, 100), "URL")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.URL);
	}
	if (GUI.Button(new Rect(10, 450, 200, 100), "NumberPad")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NumberPad);
	}
	if (GUI.Button(new Rect(10, 550, 200, 100), "PhonePad")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.PhonePad);
	}
	if (GUI.Button(new Rect(10, 650, 200, 100), "NamePhonePad")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NamePhonePad);
	}
	if (GUI.Button(new Rect(10, 750, 200, 100), "EmailAddress")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.EmailAddress);
	}
	if (GUI.Button(new Rect(10, 850, 200, 100), "Social")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Social);
	}
	if (GUI.Button(new Rect(10, 950, 200, 100), "Search")) {
		keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Search);
	}
}
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour { public string stringToEdit = "Hello World"; private TouchScreenKeyboard keyboard;

// Opens native keyboard void OnGUI() { stringToEdit = GUI.TextField(new Rect(10, 10, 200, 30), stringToEdit, 30);

if (GUI.Button(new Rect(10, 50, 200, 100), "Default")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Default); } if (GUI.Button(new Rect(10, 150, 200, 100), "ASCIICapable")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.ASCIICapable); } if (GUI.Button(new Rect(10, 250, 200, 100), "Numbers and Punctuation")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NumbersAndPunctuation); } if (GUI.Button(new Rect(10, 350, 200, 100), "URL")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.URL); } if (GUI.Button(new Rect(10, 450, 200, 100), "NumberPad")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NumberPad); } if (GUI.Button(new Rect(10, 550, 200, 100), "PhonePad")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.PhonePad); } if (GUI.Button(new Rect(10, 650, 200, 100), "NamePhonePad")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.NamePhonePad); } if (GUI.Button(new Rect(10, 750, 200, 100), "EmailAddress")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.EmailAddress); } if (GUI.Button(new Rect(10, 850, 200, 100), "Social")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Social); } if (GUI.Button(new Rect(10, 950, 200, 100), "Search")) { keyboard = TouchScreenKeyboard.Open("", TouchScreenKeyboardType.Search); } } }

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