GuiButton
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
GuiButton ist eine abstrakte Klasse, die von GuiObject erbt.Es ist die Basisklasse für die interaktiven, anklickbaren ImageButton und TextButton Objekte.Diese Klasse definiert auch mehrere Eigenschaften für interaktives Verhalten, nämlich AutoButtonColor und Modal.
Das wichtigste Ereignis eines GuiButton ist Activated, ein mehrplattformübergreifendes Ereignis , das abgefeuert wird, wenn der Knopf aktiviert wird.Wenn eine Maus verwendet wird, bedeutet dies, die Schaltfläche anzuklicken und mit dem Cursor noch über das UI-Objekt freizulassen.Für die Berührung gilt dasselbe, aber mit einem Touch statt drücken.Schließlich, für Gamepads, Activated feuert, wenn ein GuiButton ausgewählt wird, wenn die A -Taste gedrückt und freigelassen wird.Kurz gesagt, ist dieses Ereignis sehr nützlich für die Programmierung von Benutzeroberflächen auf mehreren Plattformen, da es einen schönen allgemeinen Interface für die Eingabe eines einzelnen Benutzers bietet.
Zusammenfassung
Eigenschaften
Bestimmt, ob die Schaltfläche sich automatisch ändert, wenn die Maus darüber schwebt oder darauf klickt.
Eine HapticEffect, die abgespielt wird, wenn die GuiButton gerade gehalten wird.
Wenn true während das GUI-Element sichtbar ist, wird die Maus nicht gesperrt, es sei denn, der rechte Mausknopf ist herunter.
Eine HapticEffect, die abgespielt wird, wenn die GuiButton gedrückt wird.
Ein boolesches Eigenschaft, das anzeigt, ob das Objekt ausgewählt wurde.
Legt den Stil des GuiButton auf der Grundlage einer Liste vorgegebener Stile fest.
Bestimmt, ob dieses UI-Element Eingabe sinkt.
Legt den Ursprungspunkt eines GuiObject fest, bezogen auf seine absolute Größe.
Bestimmt, ob die Größenänderung basierend auf dem Inhalt des Kindes erfolgt.
Bestimmt die GuiObject Hintergrundfarbe.
Bestimmt die Transparenz des Hintergrunds und der Grenze GuiObject.
Bestimmt die Farbe des GuiObject-Randes.
Bestimmt, auf welche Weise die GuiObject Grenze in Bezug auf ihre Dimensionen angeordnet wird.
Bestimmt die Pixelf宽te des GuiObject Randes.
Bestimmt, ob ein Nachkomme GuiObjects außerhalb der Grenzen eines Eltern-GUI-Elements rendernwerden soll.
Bestimmt, ob die Maus des Spieler:inaktiv auf der GuiObject gedrückt wird oder nicht.
Bestimmt, ob die GuiButton mit dem Interagieren kann oder nicht, oder ob sich die GuiState des GuiObject ändert oder nicht.
Steuert die Sortierreihenfolge der GuiObject, wenn sie mit einem UIGridStyleLayout verwendet wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlknopf nach unten verschoben wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlsteller nach links verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlbereich nach rechts verschoben wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlsteller nach oben verschoben wird.
Bestimmt die Pixel- und Skalarposition des GuiObject.
Bestimmt die Anzahl der Grad, um die sich der GuiObject dreht.
Bestimmen, ob die GuiObject von einem Gamepad ausgewählt werden kann.
Übernimmt die Standardauswahlverzierung, die für Gamepads verwendet wird.
Die Reihenfolge von GuiObjects, die vom Gamepad-UI-Auswahl angezeigt wird.
Bestimmt die Pixelform und Skalierung der GuiObject .
Legt die Size-Achsen fest, auf denen die GuiObject basieren wird, im Verhältnis zur Größe ihres übergeordnetes Teil.
Eine gemischte Eigenschaft von BackgroundTransparency und TextTransparency.
Bestimmt, ob die GuiObject und ihre Nachkommen gerendert werden.
Bestimmt die Reihenfolge, in der ein GuiObject in Bezug auf andere gerendert wird.
Beschreibt die tatsächliche Bildschirmposition eines GuiBase2d Elements, in Pixeln.
Beschreibt die tatsächliche Bildschirm rotation eines GuiBase2d Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines GuiBase2d Elements, in Pixeln.
Wenn es auf true gesetzt wird, wird die Lokalisierung auf dieses GuiBase2d und seine Nachkommen angewendet.
Eine Referenz auf ein LocalizationTable , das verwendet werden soll, um automatisierte Lokalisierung auf dieses GuiBase2d und seine Nachkommen anzuwenden.
Passt das Spielpadauswahlverhalten in die Down-Richtung an.
Passt das Spielpadauswahlverhalten in die linke Richtung an.
Passt das Spielpadauswahlverhalten in die richtige Richtung an.
Passt das Spielpadauswahlverhalten in die Richtung oben an.
Ermöglicht die Anpassung der Gamepad-Auswahlbewegung.
Methoden
Methoden von GuiObject übernommen- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bewegt eine GUI reibungslos zu einem neuen UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bewegt eine GUI reibungslos zu einer neuen Größe und Position.
Ereignisse
Feuert, wenn der Knopf aktiviert ist.
Feuert, wenn die Maus des Benutzers vollständig auf die GuiButton klickt.
Feuert, wenn der Benutzer seine linke Maustaste auf die GuiButton drückt.
Feuert, wenn der Benutzer seine linke Maustaste vom GuiButton loslässt.
Feuert, wenn die Maus des Benutzers vollständig auf die GuiButton rechtsklickt.
Feuert, wenn der Benutzer die rechte Maustaste auf die GuiButton drückt.
Feuert, wenn der Benutzer seine rechte Maustaste vom GuiButton loslässt.
Feuert, wenn ein Benutzer beginnt, über ein Mensch-Computer-Schnittstellen-Gerät zu interagieren (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.).
Feuert, wenn ein Benutzer ändert, wie er über ein Mensch-Computer-Schnittstellen-Gerät interagiert (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.).
Feuert, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstellen-Gerät (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.) beendet.
Feuert, wenn ein Benutzer seine Maus in ein GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus aus einem GUI-Element heraus bewegt.
Feuert immer dann, wenn ein Benutzer seine Maus bewegt, während sie sich innerhalb eines GUI-Elements befindet.
Feuert, wenn ein Benutzer das Mobilrad zurück scrollt, wenn die Maus über ein GUI-Element ist.
Feuert, wenn ein Benutzer sein Mausrad nach vorne scrollt, wenn die Maus über ein GUI-Element ist.
Feuert ab, wenn das GuiObject mit dem Gamepad-Auswahlgerät fokussiert wird.
Feuert, wenn der Gamepad-Auswahlstoppt sich auf das GuiObject zu konzentrieren.
Feuert, wenn der Spieler startet, fortsetzt und lange auf das UI-Element drückt.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler seinen Finger auf das UI-Element bewegt.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler eine Pinch- oder Pull-Geste ausführt, indem er zwei Finger auf das UI-Element legt.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler eine Rotationsgeste mit zwei Fingern auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Wischgeste auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Tap-Geste auf dem UI-Element ausführt.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Auswahl des Gamepads sich auf, verlässt oder ändert innerhalb der verbundenen GuiBase2d oder eines Nachkommens GuiObjects.
Eigenschaften
AutoButtonColor
Diese Eigenschaft bestimmt, ob sich die Schaltfläche automatisch ändert, wenn der Benutzer mit der Maus über sie fährt oder sie anklickt Mouse.Wenn true , ändert sich die Schaltfläche automatisch Farbe, wenn die Maus darüber schwebt oder darauf klickt.Wenn false , ändert sich die Schaltfläche nicht.
Wenn Sie anpassen möchten, wie sich ein Button ändert, wenn die Maus des Benutzers darüber schwebt oder darauf klickt, erwägen Sie die Verwendung eines ImageButton und Ändern des Elements HoverImage und PressedImage.
Bitte beachten Sie, dass diese Eigenschaft keine Auswirkung auf ein ImageButton haben wird, wenn ihre Image Eigenschaft auf ein Bild gesetzt ist.Darüber hinaus wird diese Eigenschaft keine Auswirkung auf ein ImageButton auf der Maus haben, wenn ihre HoverImage nicht nil ist, oder auf einen Mausklick, wenn ihre PressedImage nicht nil ist.
Modal
Wenn true während das GUI-Element sichtbar ist, wird die Maus nicht gesperrt, es sei denn, der rechte Mausknopf ist herunter.
Methoden
Ereignisse
Activated
Feuert, wenn der Knopf aktiviert ist.Da dieses Ereignis nicht auf dem Server feuert, sollte es nur in einem LocalScript verwendet werden oder in einem Script mit RunContext von Enum.RunContext.Client.
Parameter
MouseButton1Click
Dieses Ereignis wird ausgelöst, wenn die Maus des Benutzers vollständig auf die GuiButton klickt.
In Bezug auf das Klicken muss die Maus innerhalb der Grenzen von GuiButton und die Maus taste muss gedrückt und wieder herunter gedrückt werden, bevor dieses Ereignis ausgelöst wird.Wenn die Maus die Grenzen des GuiButton verlässt und freigelassen wird, wird das Ereignis nicht initiieren.Wenn Sie diese Einschränkung vermeiden möchten, können Sie MouseButton1Down und MouseButton1Up verwenden; diese Ereignisse sind ähnlich, aber werden immer dann ausgelöst, wenn der Benutzer seine linke Maustaste herunter oder oben drückt, jeweils entsprechend.
MouseButton1Down
Dieses Ereignis wird ausgelöst, wenn der Benutzer die linke Maustaste auf die GuiButton drückt.
Für ein Ereignis, bei dem der Benutzer und drücken muss, um seine linke Maustaste auf eine GuiButton zu lassen, um das Ereignis initiieren, erwägen Sie die Verwendung von MouseButton1Click.
Parameter
Die Bildschirmkoordinate der Maus X in Pixeln.
Die Bildschirmkoordinate der Maus in Pixeln Y .
MouseButton1Up
Dieses Ereignis wird ausgelöst, wenn der Benutzer seine linke Maustaste vom GuiButton loslässt.
Für ein Ereignis, bei dem der Benutzer und drücken muss, um seine linke Maustaste auf eine GuiButton zu lassen, um das Ereignis initiieren, erwägen Sie die Verwendung von MouseButton1Click.
Parameter
Die Bildschirmkoordinate der Maus X in Pixeln.
Die Bildschirmkoordinate der Maus in Pixeln Y .
MouseButton2Click
Dieses Ereignis wird ausgelöst, wenn die Maus des Benutzers vollständig auf die GuiButton klickt.
In Bezug auf das Klicken muss die Maus innerhalb der Grenzen von GuiButton und die Maus taste muss gedrückt und wieder herunter gedrückt werden, bevor dieses Ereignis ausgelöst wird.Wenn die Maus die Grenzen des GuiButton verlässt und freigelassen wird, wird das Ereignis nicht initiieren.Wenn Sie diese Einschränkung vermeiden möchten, können Sie MouseButton2Down und MouseButton2Up verwenden; diese Ereignisse sind ähnlich, aber werden immer dann ausgelöst, wenn der Benutzer mit der rechten Maustaste oder oben auf die Taste drückt, respectively.
MouseButton2Down
Dieses Ereignis wird ausgelöst, wenn der Benutzer die rechte Maustaste auf die GuiButton drückt.
Für ein Ereignis, bei dem der Benutzer und drücken muss, um seine rechte Maustaste auf eine GuiButton freizugeben, um das Ereignis initiieren, erwägen Sie die Verwendung von MouseButton2Click.
Parameter
Die Bildschirmkoordinate der Maus X in Pixeln.
Die Bildschirmkoordinate der Maus in Pixeln Y .
MouseButton2Up
Dieses Ereignis wird ausgelöst, wenn der Benutzer die rechte Maustaste von der GuiButton loslässt.
Für ein Ereignis, bei dem der Benutzer und drücken muss, um seine rechte Maustaste auf eine GuiButton freizugeben, um das Ereignis initiieren, erwägen Sie die Verwendung von MouseButton2Click.
Parameter
Die Bildschirmkoordinate der Maus X in Pixeln.
Die Bildschirmkoordinate der Maus in Pixeln Y .