Champs de saisie de texte

Un TextBox est un rectangle qui permet à un utilisateur de fournir une saisie de texte lorsqu'il est en focus. Lorsque vous script un TextBox, vous pouvez l'utiliser comme une barre de recherche ou un champ de saisie sur un formulaire. Pour aider les utilisateurs à savoir quel type de texte ils doivent saisir, vous pouvez également fournir un prompt via la propriété PlaceholderText.

Parce que ces objets sont des GuiObjects, vous pouvez personnaliser des propriétés telles que BackgroundColor3, BorderMode, Transparency, et Rotation pour s'adapter à l'esthétique de votre jeu.

Créer des saisies de texte à l'écran

Un TextBox sur un écran est utile pour des choses comme un champ de saisie pour un formulaire.

Pour ajouter un TextBox à un écran :

1. Dans la fenêtre Explorer, sélectionnez StarterGui et ajoutez un ScreenGui.

   1. Survolez StarterGui et cliquez sur le bouton ⊕. Un menu contextuel s'affiche.

   2. Insérez un ScreenGui.

2. Sélectionnez le nouveau ScreenGui et ajoutez un TextBox.

   1. Survolez ScreenGui et cliquez sur le bouton ⊕. Un menu contextuel s'affiche.

   2. Insérez un TextBox.

Créer des saisies de texte sur les faces de pièces

Pour ajouter un TextBox à la face d'une pièce :

1. Dans la fenêtre Explorer, sélectionnez StarterGui et ajoutez un SurfaceGui.

   1. Survolez StarterGui et cliquez sur le bouton ⊕. Un menu contextuel s'affiche.

   2. Insérez un ScreenGui.

2. Sélectionnez le nouveau SurfaceGui et ajoutez un TextBox.

   1. Survolez SurfaceGui et cliquez sur le bouton ⊕. Un menu contextuel s'affiche.

   2. Insérez un TextBox.

3. Adornez le SurfaceGui à la pièce sur laquelle vous souhaitez afficher le TextBox.

   1. Dans la fenêtre Propriétés, sélectionnez la propriété Adornee. Votre curseur change.

   2. Dans la fenêtre Explorer, sélectionnez la pièce.

Script des saisies de texte

Comme pour les boutons, vous pouvez script n'importe quelle action pour un objet TextBox lorsque l'utilisateur interagit avec lui. Par exemple, le script suivant connecte l'événement FocusLost qui se déclenche lorsque l'utilisateur appuie sur le bouton Entrée ou clique en dehors de la boîte. Si enterPressed est true, ce qui signifie que l'utilisateur a soumis l'entrée au lieu de simplement cliquer en dehors de la boîte, le script imprime le contenu de l'entrée dans la fenêtre Output.

local textBox = script.Parent

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

textBox.FocusLost:Connect(onFocusLost)

Comme autre exemple, vous pourriez vouloir autoriser uniquement les chiffres dans un TextBox. Le code suivant utilise l'événement TextBox.GetPropertyChangedSignal pour détecter quand le TextBox.Text change, par exemple lorsque l'utilisateur commence à taper, puis utilise la fonction string.gsub() pour interdire les non-nombres.

local textBox = script.Parent

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

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

Filtrage de texte

Appliqué à diverses sources et saisies, le filtrage de texte empêche les utilisateurs de voir un langage inapproprié et des informations personnellement identifiables telles que des numéros de téléphone. Roblox filtre automatiquement les sorties de texte courantes, comme les messages qui ont été transmis par le chat textuel en jeu, mais vous êtes responsable du filtrage de tout texte affiché sur lequel vous n'avez pas de contrôle explicite, y compris caractères/chaînes que les utilisateurs saisissent via des saisies de texte.