Text- und Bildschaltflächen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

GuiButtons sind GuiObjects, die es Spielern ermöglichen, eine Aktion auszuführen. Sie können diese Schaltflächen anpassen, um Kontext und Feedback bereitzustellen, z. B. durch Ändern des visuellen Erscheinungsbilds oder durch Scripting akustisches Feedback, wenn ein Spieler mit einer Schaltfläche interagiert.

Es gibt zwei Arten von Schaltflächen, die Sie auf dem Bildschirm oder im Spiel platzieren können:

Eine TextButton ist ein Rechteck mit Text, das das Activated und/oder SecondaryActivated Ereignis beim Klicken/Tippen auslöst.
Eine ImageButton ist ein Rechteck mit einem Bild, das das Activated und/oder SecondaryActivated Ereignis beim Klicken/Tippen auslöst. Sie verfügt über zusätzliche Zustände, um das Bild beim Überfahren oder Drücken durch den Spieler zu wechseln.

Schaltflächen auf dem Bildschirm

Schaltflächen auf dem Bildschirm sind nützlich, um Spieler schnell zu verschiedenen Menüs oder Seiten zu führen. Um diese Art von Schaltfläche hinzuzufügen:

Im Explorer Fenster, fahren Sie mit der Maus über StarterGui, klicken Sie auf die ⊕ Schaltfläche und fügen Sie eine ScreenGui ein.
Fahren Sie mit der Maus über die neue ScreenGui, klicken Sie auf die ⊕ Schaltfläche und fügen Sie entweder eine TextButton oder ImageButton ein.

Schaltflächen auf Teilflächen

Schaltflächen auf einem Teil sind nützlich, um Spielern die Interaktion mit Teilen zu ermöglichen. Zum Beispiel können Sie Spielern erlauben, auf eine Schaltfläche zu treten, um eine Aktion abzuschließen.

Um eine Schaltfläche auf die Fläche eines Teils hinzuzufügen:

Im Explorer Fenster, fahren Sie mit der Maus über das Teil, klicken Sie auf die ⊕ Schaltfläche und fügen Sie eine SurfaceGui ein.
Fahren Sie mit der Maus über die neue SurfaceGui, klicken Sie auf die ⊕ Schaltfläche und fügen Sie entweder eine TextButton oder ImageButton ein.

Wenn Sie die Schaltfläche nicht sehen, versuchen Sie, eine andere Fläche (Top, Bottom, Front, Back, Left oder Right) für die Face Eigenschaft der SurfaceGui auszuwählen.

Erscheinungsbild der Schaltflächen

Sowohl TextButton als auch ImageButton erben von GuiObject, das Eigenschaften wie BackgroundColor3, Rotation und Size enthält. Schaltflächen akzeptieren auch die Erscheinungsbildmodifikatoren, die für die meisten UI-Objekte üblich sind.

Einzigartig für TextButton sind verschiedene Eigenschaften, um sein visuelles Erscheinungsbild zu ändern:

FontFace — Die Schriftart, die zum Rendern von Text verwendet wird.
Text — Der Textstring, der auf der Schaltfläche gerendert wird.
TextSize — Die Zeilenhöhe des Textes in Offsets.
TextColor3 — Die Farbe des gerenderten Textes.

Eine ImageButton hat mehrere Eigenschaften, um ihr visuelles Erscheinungsbild zu ändern, einschließlich Hover- und gedrückter Bildvarianten, um die Interaktion eines Spielers mit der Schaltfläche anzuzeigen:

Image — Das Bild, das angezeigt wird, wenn ein Spieler nicht mit der ImageButton interagiert.
HoverImage — Das Bild, das angezeigt wird, wenn ein Spieler den Mauszeiger über die ImageButton bewegt.
PressedImage — Das Bild, das angezeigt wird, wenn ein Spieler die ImageButton klickt/tippt.

Skriptschaltflächen

Sie können eine Aktion skripten, wenn ein Spieler eine Schaltfläche drückt, indem Sie die Schaltfläche mit dem GuiButton.Activated Ereignis verbinden oder mit GuiButton.SecondaryActivated für plattformübergreifende sekundäre Eingaben wie Rechtsklick auf dem Desktop und langes Drücken auf Mobilgeräten. Zum Beispiel, wenn Sie das folgende LocalScript einer Schaltfläche zuordnen, ändert sich die Schaltfläche bei jedem Klick/Tap eines Spielers in eine zufällige Farbe.

local button = script.Parent
local RNG = Random.new()

local function onButtonActivated()
	-- Zufällige Farbe der Schaltfläche
	button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end

button.Activated:Connect(onButtonActivated)

Deutsch