GuiButton
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Guiboard ist eine abstrakte Klasse, die von GuiObject erbt. Sie ist die Basisklasse für ImageButton und
Das wichtigste Ereignis eines GuiButton ist GuiButton.Activated, ein Multi-Plattform-Ereignis , das abgefeuert wird, wenn die Objektaktiviert wird. Wenn Sie eine Maus verwenden, bed
Zusammenfassung
Eigenschaften
Bestimmt, ob die Schaltfläche automatisch Farbe ändert, wenn die Maus darüber schwebt oder darauf klickt.
Wenn wahr, während der GUI-Element sichtbar ist, wird die Maus nicht gesperrt, wenn der rechte Maustaste nicht abgestellt ist.
EineBoolean-Eigenschaft, die anzeigt, ob das Objekt ausgewählt wurde.
Setzt den Stil des GuiButton basierend auf einer Liste von vordefinierten Stilen.
Bestimmt, ob dieses UI-Element die Eingabe sinkt.
Bestimmt den Ursprungspunkt eines GuiObject , relativer zu seiner absoluten Größe.
Bestimmt, ob das Skalieren basierend auf Kindern Inhalt.
Bestimmt die Hintergrundfarbe des GuiObject.
Bestimmt die Transparenz der GuiObject -Hintergrund und -Rand.
Bestimmt die Farbe der GuiObject Grenze.
Bestimmt, in welcher Weise die GuiObject Kante relativ zu ihren Dimensionen platziert ist.
Bestimmt die Pixelbreite der GuiObject Grenze.
Bestimmt, ob der Nachkomme GuiObjects außerhalb der Grenzen eines Eltern-GUI-Elements rendernwerden soll.
Bestimmt, ob die Maus des Spieler:inauf dem GuiObject aktiviert wird oder nicht.
Bestimmt, ob das GuiButton mit oder ohne Interaktion möglich ist, oder ob das GuiState der GuiObject geändert wird oder nicht.
Steuert die Sortierungsordnung der GuiObject bei Verwendung mit einem UIGridStyleLayout.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlhebel nach unten verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahl器 nach links verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlheber rechts verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlheber nach oben verschoben wird.
Bestimmt die Pixel- und SkalierungsPosition des GuiObject.
Bestimmt die Anzahl der Grad, in denen das GuiObject gedreht wird.
Bestimmen Sie, ob das GUI durch eine Gamepadausgewählt werden kann.
Überschreibt die Standard-Auswahlornamente für Gamepads.
Die Reihenfolge von GuiObjects , die von der Spielpad-Auswahl ausgewählt wurde.
Bestimmt die Pixel- und Skalierungsgröße des GuiObject.
Setzt die Size Achsen, auf denen die GuiObject basieren wird, relativ zur Größe ihres übergeordnetes Teil.
Eine gemischte Eigenschaft von BackgroundTransparency und TextTransparency.
Bestimmt, ob das GuiObject und seine Nachkommen gerendert werden.
Bestimmt die Reihenfolge, in der ein GuiObject relativo zu anderen rendert.
Beschreibt die tatsächliche Bildschirmposition eines UI-Elements in Pixeln.
Beschreibt die tatsächliche Bildschirmdrehung eines UI-Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines UI-Elements in Pixel.
Wenn auf wahr gesetzt, wird die Lokalisierung auf diesen GuiBase2d und seinen Nachkommen angewendet.
Eine Verweisung auf eine LocalizationTable , die verwendet wird, um automatisierte Lokalisierung auf diesen GuiBase2d und seinen Nachkommen anzuwenden.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung unten.
Anpassen Sie das Gamepad-Auswahlverhalten in der linken Richtung.
Benutzerdefiniert das Verhalten der Spielpad-Auswahl in die richtige Richtung.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung nach oben.
Erlaubt die Anpassung der Gamepad-Auswahl.
Methoden
Methoden von GuiObject übernommen- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bewegt eine GUI mühelos zu einem neuen UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Skaliert eine GUI makellos zu einer neuen UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Verschwindet ein GUI mühelos auf eine neue Größe und Position.
Ereignisse
Feuert die Taste aktiviert.
Fehler: Die Maus hat die GUI-Schaltfläche vollständig verlassen, als sie vollständig klickt hat.
Feuert, wenn die Maus in der linken unteren Position auf dem GUI-Objekt ist.
Feuert, wenn die linke Maust die GUI-Objekt freigegeben hat.
Fehler: Die Maus hat die GUI-Schaltfläche vollständig mit der rechten Maustaste angeklickt.
Feuert, wenn die Maus im rechten Maus-Down-Zustand auf dem GUI-Objekt ist.
Feuern, wenn die rechte Maustaste auf einem GUI-Objekt freigelassen wurde.
Ausgelöst, wenn ein Benutzer mit einem Human-Computer-Interface-Gerät (Maus-Button, Touch-Anfang, Tastatur-Button usw.) interagiert.
Ausgelöst, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstelle-Gerät (Maus-Button nach unten, Touch-Anfang, Tastatur-Button nach unten usw.) ändert.
Ausgelöst, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstelle (Maus-Button, Touch-Beginn, Tastatur-Button usw.) aufgibt.
Feuert, wenn ein Benutzer seine Maus in ein GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus aus einem GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus bewegt, während sie in einem GUI-Element ist.
Feuert, wenn ein Benutzer seine Maus zurück scrollt, wenn die Maus über ein GUI-Element ist.
Feuert, wenn ein Benutzer seine Maus auf ein GUI-Element bewegt, wenn die Maus über einem GUI-Element ist.
Feuern, wenn das GuiObject mit dem Gamepad-Auswahl器 konzentriert wird.
Feuern, wenn der Gamepad-Auswahlbereich auf das GuiObject aufhört, sich zu konzentrieren.
Feuert, wenn der Spieler startet, hält und stoppt das Drücken der UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler seinen Finger auf dem UI-Element bewegt.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler einen Pinch oder Ziehvorgang mit zwei Fingern auf der UI-Element ausführt.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler einen Rotierungs-Gestalt mit zwei Fingern auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Swipe-Geste auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Berührung auf dem UI-Element ausführt.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Gamepad-Auswahl bewegt wird, geht oder sich in der verbundenen GuiBase2d oder einem Nachfolge GuiObjekten ändert.
Eigenschaften
AutoButtonColor
Die AutoButtonColor bestimmt, ob die Schaltfläche automatisch Farbe ändert, wenn die Mouse des Benutzers über oder auf sie klickt.
Wenn Sie es wahr, wird die Schaltfläche automatisch geändert, wenn die Maus über sie hinweg fährt oder darauf klickt. Wenn Sie es falsch, wird die Schaltfläche nicht geändert.
Wenn Sie möchten, wie eine Schaltfläche reagiert, wenn die Maus des Benutzers über oder auf sie fährt, berücksichtigen Sie die Verwendung einer ImageButton -GUI und Ändern der Elemente ImageButton.HoverImage und ImageButton.PressedImage.
Bitte beachten Sie, dass diese Eigenschaft keinen Effekt auf ein ImageButton hat, wenn seine Eigenschaft auf ein Bild eingestellt ist und nicht null ist. Darüber hinaus wird die Eigenschaft keinen BildButton-Element auf der Maus-Hauptforderung auswirken, wenn seine 4> Class.ImageButton.HoverImage4> nicht null ist oder auf der Maus
Code-Beispiele
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Wenn wahr, während der GUI-Element sichtbar ist, wird die Maus nicht gesperrt, wenn der rechte Maustaste nicht abgestellt ist.
Style
Setzt den Stil des GuiButton basierend auf einer Liste von vordefinierten Stilen.
Methoden
Ereignisse
Activated
Feuert, wenn die Schaltfläche aktiviert wird. Dieses Ereignis wird nicht auf dem Server ausgelöst, sollte nur in einem LocalScript oder in einem Script mit RunContext von 2> Class.Script.Client2> verwendet werden.
Parameter
MouseButton1Click
Das MouseButton1Click-Ereignis wird ausgelöst, wenn der Benutzer seine Mouse vollständig links klickt.
Durch das Klicken muss die Maus innerhalb der Schaltflächengrenzen sein und muss erneut gedrückt und nach oben und unten gedrückt werden, bevor dieses Ereignis initiierenwird. Wenn die Maus die Grenzen der Schaltflächen verlässt und freigesetzt wird, wird das Ereignis nicht ausgelöst. Wenn Sie diese Einschränkung vermeiden möchten, können Sie Class.GuiButton.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton2Click, das sich identisch verhält, außer dass es mit dem rechten Maustaster des Benutzers verbunden ist.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Code-Beispiele
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)MouseButton1Down
Das MouseButton1Down-Ereignis wird ausgelöst, wenn der Benutzer seine linke Mouse-Taste auf dem GUI-Objekt drückt.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton2Down, das sich identisch verhält, außer dass es mit dem rechten Maustaster des Benutzers verbunden ist.
Wenn Sie ein Ereignis suchen, bei dem der Benutzer seine linke Maustaste auf einer GUI drücken und loslassen muss, um das Ereignis initiieren, sollten Sie GuiButton.MouseButton1Click verwenden.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Parameter
Die x-Bildschirmkoordination der Maus in Pixel.
Die Y-Bildschirmkoordination der Maus in Pixel.
Code-Beispiele
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton1Up
Das MouseButton1Up-Ereignis wird ausgelöst, wenn der Benutzer seine linke Mouse auf dem GUI-Objekt loslässt.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton2Up, das sich identisch verhält, außer dass es mit dem rechten Maustaste des Benutzers verbunden ist.
Wenn Sie ein Ereignis suchen, bei dem der Benutzer seine linke Maustaste auf einer GUI drücken und loslassen muss, um das Ereignis initiieren, sollten Sie GuiButton.MouseButton1Click verwenden.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Parameter
Die x-Bildschirmkoordination der Maus in Pixel.
Die Y-Bildschirmkoordination der Maus in Pixel.
Code-Beispiele
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton2Click
Das MouseButton2Click-Ereignis wird ausgelöst, wenn der Benutzer seine Mouse rechts klickt.
Durch das Klicken muss die Maus innerhalb der Schaltflächengrenzen sein und muss erneut gedrückt und nach oben und unten gedrückt werden, bevor dieses Ereignis initiierenwird. Wenn die Maus die Grenzen der Schaltflächen verlässt und freigesetzt wird, wird das Ereignis nicht ausgelöst. Wenn Sie diese Einschränkung vermeiden möchten, können Sie Class.GuiButton.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton1Click, das sich identisch verhält, außer dass es mit dem linken Maustaster verbunden ist.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Code-Beispiele
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
Das MouseButton2Down-Ereignis wird ausgelöst, wenn der Benutzer auf der GUI-Objekt auf seine rechte Mouse-Taste drückt.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton1Down, das sich identisch verhält, außer dass es mit dem linken Maustaster verbunden ist.
Wenn Sie ein Ereignis suchen, bei dem der Benutzer seine rechte Maustaste auf einer GUI drücken und loslassen muss, um das Ereignis initiieren, sollten Sie GuiButton.MouseButton2Click verwenden.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Parameter
Die x-Bildschirmkoordination der Maus in Pixel.
Die Y-Bildschirmkoordination der Maus in Pixel.
Code-Beispiele
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
Das MouseButton2Up-Ereignis wird ausgelöst, wenn der Benutzer seine rechte Mouse auf dem GUI-Objekt loslässt.
Dieses Ereignis ist ähnlich zu GuiButton.MouseButton1Up, das sich identisch verhält, außer dass es mit dem linken Maustaster verbunden ist.
Wenn Sie ein Ereignis suchen, bei dem der Benutzer seine rechte Maustaste auf einer GUI drücken und loslassen muss, um das Ereignis initiieren, sollten Sie GuiButton.MouseButton2Click verwenden.
Beachten Sie, dass dieses Ereignis nur für GUI-Schaltflächen, einschließlich TextButtons und ImageButton , ausgelöst wird. Es wird nicht für andere GuiObjects ausgelöst.
Parameter
Die x-Bildschirmkoordination der Maus in Pixel.
Die Y-Bildschirmkoordination der Maus in Pixel.
Code-Beispiele
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)