Campos de entrada de texto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Um TextBox é um retângulo que permite que um usuário forneça entrada de texto enquanto estiver em foco.Quando você script um TextBox, você pode usá-lo como barra de pesquisa ou campo de entrada em um formulário.Para ajudar os usuários a saberem que tipo de texto devem inserir, você também pode fornecer um prompt através da propriedade PlaceholderText.

Como esses objetos são GuiObjects , você pode personalizar propriedades como BackgroundColor3 , BorderMode , Transparency e Rotation para combinar com a estética de sua experiência.

Criar entradas de texto na tela

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

Para adicionar um TextBox a uma tela:

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

    1. Passe o mouse sobre o 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 uma Caixa de Texto .

Criar entradas de texto nas faces de peças

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

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

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

    2. Insira um ScreenGui .

  2. Selecione o novo SurfaceGui e adicione uma Caixa de Texto .

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

    2. Insira uma Caixa de Texto .

  3. Decore o SurfaceGui para a parte na qual você deseja exibir o TextBox .

    1. Na janela Propriedades , selecione a propriedade Adornado . Seu cursor muda.

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

Entradas de texto do script

Como botões, você pode scriptar qualquer ação para um objeto TextBox quando um usuário interage com ele.Por exemplo, o seguinte script conecta o evento FocusLost que atira quando o usuário pressiona o botão Enter ou clica fora da caixa.Se enterPressed for true, significa que o usuário enviou a entrada ao invés de apenas clicar fora da caixa, o script imprime o conteúdo da entrada para a janela Saída.

Manuseio de entrada de texto básico

local textBox = script.Parent
local function onFocusLost(enterPressed, inputObject)
if enterPressed then
print(textBox.Text)
end
end
textBox.FocusLost:Connect(onFocusLost)

Outro exemplo, você pode querer permitir apenas números em um TextBox .O seguinte código usa o evento TextBox.GetPropertyChangedSignal para detectar quando as alterações TextBox.Text ocorrem, como quando um usuário começa a digitar, então usa a função string.gsub() para proibir não-números.

Restringindo a entrada de texto para números

local textBox = script.Parent
local function allowOnlyNumbers()
textBox.Text = string.gsub(textBox.Text, "%D", "")
end
textBox:GetPropertyChangedSignal("Text"):Connect(allowOnlyNumbers)

Filtro de texto

Aplicado a várias fontes e entradas, filtragem de texto impede que os usuários vejam linguagem inapropriada e informações pessoalmente identificáveis, como números de telefone.O Roblox filtra automaticamente saídas de texto comuns, como mensagens que passaram por conversa de texto na experiência, mas você é responsável por filtrar qualquer texto exibido que você não tenha controle explícito , incluindo props.context.