Campos de entrada de texto

Uma TextBox é um retângulo que permite ao usuário fornecer entrada de texto enquanto está em foco. Quando você script uma TextBox, você pode usá-la como uma barra de pesquisa ou um campo de entrada em um formulário. Para ajudar os usuários a saber que tipo de texto eles devem inserir, você também pode fornecer um prompt através da propriedade PlaceholderText.

Porque esses objetos são GuiObjects, você pode personalizar propriedades como BackgroundColor3, BorderMode, Transparency, e Rotation para se adequar à estética de sua experiência.

Crie entradas de texto na tela

Uma TextBox em uma tela é útil para coisas como um campo de entrada para um formulário.

Para adicionar uma TextBox a uma tela:

1. Na janela Explorer, selecione StarterGui e adicione um ScreenGui.

   1. Passe o mouse sobre StarterGui e clique no botão ⊕. Um menu contextual é exibido.

   2. Insira um ScreenGui.

2. Selecione o novo ScreenGui e adicione um TextBox.

   1. Passe o mouse sobre ScreenGui e clique no botão ⊕. Um menu contextual é exibido.

   2. Insira um TextBox.

Crie entradas de texto nas faces das peças

Para adicionar uma TextBox à face de uma peça:

1. Na janela Explorer, selecione StarterGui e adicione um SurfaceGui.

   1. Passe o mouse sobre StarterGui e clique no botão ⊕. Um menu contextual é exibido.

   2. Insira um ScreenGui.

2. Selecione o novo SurfaceGui e adicione um TextBox.

   1. Passe o mouse sobre SurfaceGui e clique no botão ⊕. Um menu contextual é exibido.

   2. Insira um TextBox.

3. Adorne o SurfaceGui à peça em que você deseja exibir o TextBox.

   1. Na janela Properties, selecione a propriedade Adornee. O cursor muda.

   2. Na janela Explorer, selecione a peça.

Script de entradas de texto

Assim como os botões, você pode scriptar qualquer ação para um objeto TextBox quando um usuário interagir com ele. Por exemplo, o seguinte script conecta o evento FocusLost, que dispara quando o usuário pressiona o botão Enter ou clica fora da caixa. Se enterPressed for true, significando que o usuário enviou a entrada em vez de apenas clicar fora da caixa, o script imprime o conteúdo da entrada na janela Output.

Manipulação Básica da Entrada de Texto
local textBox = script.Parent

local function onFocusLost(enterPressed, inputObject)
	if enterPressed then
		print(textBox.Text)
	end
end

textBox.FocusLost:Connect(onFocusLost)

Como outro exemplo, você pode querer permitir apenas números em uma TextBox. O seguinte código usa o evento TextBox.GetPropertyChangedSignal para detectar quando o TextBox.Text muda, como quando um usuário começa a digitar, então ele usa a função string.gsub() para desautorizar não-números.

Restringindo a Entrada de Texto a Números
local textBox = script.Parent

local function allowOnlyNumbers()
	textBox.Text = string.gsub(textBox.Text, "%D", "")
end

textBox:GetPropertyChangedSignal("Text"):Connect(allowOnlyNumbers)

Filtragem de texto

Aplicado a várias fontes e entradas, a filtragem de texto impede que os usuários vejam linguagem inadequada e informações pessoais identificáveis, como números de telefone. Roblox filtra automaticamente saídas de texto comuns, como mensagens que passaram pelo chat de texto dentro do jogo, mas você é responsável por filtrar qualquer texto exibido que não tenha controle explícito, incluindo caracteres/strings que os usuários inserem através de entradas de texto.