Campos de entrada de texto

Un TextBox es un rectángulo que permite a un usuario proporcionar entrada de texto mientras está en foco. Cuando scriptas un TextBox, puedes usarlo como una barra de búsqueda o un campo de entrada en un formulario. Para ayudar a los usuarios a saber qué tipo de texto deben ingresar, también puedes proporcionar un aviso a través de la propiedad PlaceholderText.

Debido a que estos objetos son GuiObjects, puedes personalizar propiedades como BackgroundColor3, BorderMode, Transparency, y Rotation para adaptarse a la estética de tu juego.

Crear entradas de texto en la pantalla

Un TextBox en una pantalla es útil para cosas como un campo de entrada para un formulario.

Para agregar un TextBox a una pantalla:

1. En la ventana Explorer, selecciona StarterGui y agrega un ScreenGui.

   1. Pasa el cursor sobre StarterGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un ScreenGui.

2. Selecciona el nuevo ScreenGui y agrega un TextBox.

   1. Pasa el cursor sobre ScreenGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un TextBox.

Crear entradas de texto en las caras de las piezas

Para agregar un TextBox a la cara de una pieza:

1. En la ventana Explorer, selecciona StarterGui y agrega un SurfaceGui.

   1. Pasa el cursor sobre StarterGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un ScreenGui.

2. Selecciona el nuevo SurfaceGui y agrega un TextBox.

   1. Pasa el cursor sobre SurfaceGui y haz clic en el botón ⊕. Se muestra un menú contextual.

   2. Inserta un TextBox.

3. Adorna el SurfaceGui a la pieza en la que deseas mostrar el TextBox.

   1. En la ventana Properties, selecciona la propiedad Adornee. Tu cursor cambiará.

   2. En la ventana Explorer, selecciona la pieza.

Script de entradas de texto

Al igual que con botones, puedes scriptar cualquier acción para un objeto TextBox cuando un usuario interactúa con él. Por ejemplo, el siguiente script conecta el evento FocusLost que se activa cuando el usuario presiona el botón Enter o hace clic fuera de la caja. Si enterPressed es true, lo que significa que el usuario envió la entrada en lugar de simplemente hacer clic fuera de la caja, el script imprime el contenido de la entrada en la ventana de Output.

local textBox = script.Parent

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

textBox.FocusLost:Connect(onFocusLost)

Como otro ejemplo, podrías querer permitir solo números en un TextBox. El siguiente código utiliza el evento TextBox.GetPropertyChangedSignal para detectar cuándo cambia el TextBox.Text, como cuando un usuario comienza a escribir, luego utiliza la función string.gsub() para deshabilitar caracteres que no sean números.

local textBox = script.Parent

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

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

Filtrado de texto

Applied to various sources and inputs, text filtering prevents users from seeing inappropriate language and personally identifiable information such as phone numbers. Roblox automatically filters common text outputs such as messages that have passed through in-game text chat, but you are responsible for filtering any displayed text that you don't have explicit control over, including caracteres/cadenas que los usuarios ingresan a través de entradas de texto.