Texteingabefelder

Ein TextBox ist ein Rechteck, das es einem Benutzer ermöglicht, Text einzugeben, während es im Fokus ist. Wenn Sie ein TextBox skripten, können Sie es als Suchleiste oder Eingabefeld in einem Formular verwenden. Um den Benutzern zu helfen, zu wissen, welchen Text sie eingeben sollen, können Sie auch einen Hinweis über die PlaceholderText-Eigenschaft bereitstellen.

Da diese Objekte GuiObjects sind, können Sie Eigenschaften wie BackgroundColor3, BorderMode, Transparency und Rotation anpassen, um die Ästhetik Ihrer Erfahrung anzupassen.

Texteingaben auf dem Bildschirm erstellen

Ein TextBox auf einem Bildschirm ist nützlich für Dinge wie ein Eingabefeld für ein Formular.

Um ein TextBox zu einem Bildschirm hinzuzufügen:

1. Wählen Sie im Explorer-Fenster StarterGui aus und fügen Sie ein ScreenGui hinzu.

   1. Fahren Sie mit der Maus über StarterGui und klicken Sie auf die ⊕-Schaltfläche. Ein Kontextmenü wird angezeigt.

   2. Fügen Sie ein ScreenGui ein.

2. Wählen Sie das neue ScreenGui aus und fügen Sie ein TextBox hinzu.

   1. Fahren Sie mit der Maus über ScreenGui und klicken Sie auf die ⊕-Schaltfläche. Ein Kontextmenü wird angezeigt.

   2. Fügen Sie ein TextBox ein.

Texteingaben auf den Flächen von Teilen erstellen

Um ein TextBox zur Fläche eines Teils hinzuzufügen:

1. Wählen Sie im Explorer-Fenster StarterGui aus und fügen Sie ein SurfaceGui hinzu.

   1. Fahren Sie mit der Maus über StarterGui und klicken Sie auf die ⊕-Schaltfläche. Ein Kontextmenü wird angezeigt.

   2. Fügen Sie ein ScreenGui ein.

2. Wählen Sie das neue SurfaceGui aus und fügen Sie ein TextBox hinzu.

   1. Fahren Sie mit der Maus über SurfaceGui und klicken Sie auf die ⊕-Schaltfläche. Ein Kontextmenü wird angezeigt.

   2. Fügen Sie ein TextBox ein.

3. Versehen Sie das SurfaceGui mit dem Teil, auf dem Sie das TextBox anzeigen möchten.

   1. Wählen Sie im Properties-Fenster die Adornee-Eigenschaft aus. Ihr Cursor ändert sich.

   2. Wählen Sie im Explorer-Fenster das Teil aus.

Texteingaben skripten

Wie bei Schaltflächen können Sie jede Aktion für ein TextBox-Objekt skripten, wenn ein Benutzer damit interagiert. Zum Beispiel verbindet das folgende Skript das FocusLost-Ereignis, das ausgelöst wird, wenn der Benutzer die Enter-Taste drückt oder außerhalb des Feldes klickt. Wenn enterPressed true ist, was bedeutet, dass der Benutzer die Eingabe anstelle des bloßen Klickens außerhalb des Feldes abgesendet hat, gibt das Skript den Inhalt des Eingabefelds im Output-Fenster aus.

Grundlegende Texteingabeverarbeitung
local textBox = script.Parent

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

textBox.FocusLost:Connect(onFocusLost)

In einem anderen Beispiel möchten Sie möglicherweise nur Zahlen in einem TextBox zulassen. Der folgende Code verwendet das TextBox.GetPropertyChangedSignal-Ereignis, um zu erkennen, wann sich der TextBox.Text ändert, zum Beispiel wenn ein Benutzer zu tippen beginnt, und verwendet dann die string.gsub()-Funktion, um Nicht-Zahlen zu verbieten.

Texteingabe auf Zahlen beschränken
local textBox = script.Parent

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

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

Textfilterung

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 Zeichen/Strings, die Benutzer über Texteingaben eingeben.