GuiButton
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
GuiButton è una classe抽stratta che eredita da GuiObject . È la classe di base per ImageButton e Class.Text
L'evento più importante di un GuiButton è GuiButton.Activated, un evento multi-platform che si attiva quando il pulsante viene attivato. Quando si usa il Topo, or mouse as computer mouse, questo significa fare clic sul pulsante e rilasciare con il
Sommario
Proprietà
Determina se il pulsante cambia colore automaticamente quando il mouse si posiziona su di esso o lo si fa clic.
Se vero mentre l'elemento GUI è visibile, il mouse non sarà bloccato a meno che il pulsante del mouse destro non sia down.
Una proprietà booleana che indica se l'oggetto è stato selezionato.
Imposta lo stile del GuiButton in base a una lista di stili pre-determinati.
Determina se questo elemento UI affonda l'input.
Determina il punto di origine di un GuiObject , rispetto alla sua dimensione assoluta.
Determina se la ridimensionamento avviene in base al contenuto figlio.
Determina il colore di sfondo GuiObject .
Determina la trasparenza di sfondo e di GuiObject .
Determina il colore del GuiObject bordura.
Determina in che modo il GuiObject confine è distribuito rispetto alle sue dimensioni.
Determina la larghezza del pixel del confine GuiObject .
Determina se il discendente GuiObjects al di fuori dei confini di un elemento GUI padre dovrebbe essere Renderizzare.
Determina se il mouse del Giocatoreviene attivamente premuto sul GuiObject o no.
Determina se il GuiButton può essere interattato o no, o se il GuiState del GuiObject sta cambiando o no.
Controlla l'ordine di sorta del GuiObject quando viene utilizzato con un UIGridStyleLayout .
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad verrà spostato verso il basso.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad sarà spostato a sinistra.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad sarà spostato a destra.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad verrà spostato verso l'alto.
Determina la posizione pixel e scalare del GuiObject .
Determina il numero di gradi con cui il GuiObject è ruotato.
Determine se il GUI può essere selezionato da un gamepad.
Sovrascrivi l'ornamento di selezione predefinito utilizzato per i gamepad.
L'ordine di GuiObjects selezionato dalla selezione della barra di gioco.
Determina la dimensione pixel e scalare del GuiObject .
Imposta gli assi Size su cui sarà basato il GuiObject parent.
Una proprietà mistura di BackgroundTransparency e TextTransparency .
Determina se il GuiObject e i suoi discendenti saranno renduti.
Determina l'ordine in cui un GuiObject rende rispetto agli altri.
Descrive la posizione reale dello schermo di un elemento UI, in pixel.
Descrive la rotazione dell'interfaccia utente reale, in gradi.
Descrive la dimensione reale dello schermo di un elemento UI, in pixel.
Quando impostato su true, la localizzazione sarà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable per essere utilizzato per applicare la localizzazione automatica a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento della selezione del gamepad nella direzione in cui si muove verso il basso.
Personalizza il comportamento di selezione del gamepad nella direzione di sinistra.
Personalizza il comportamento della selezione del gamepad nella direzione giusta.
Personalizza il comportamento della selezione del gamepad nell'area di direzione up.
Consente la personalizzazione della selezione del gamepad.
Metodi
Metodi provenienti da GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Smoothly moves a GUI to a new UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Ridimensiona rapidamente una GUI in una nuova UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Smoothly sposta una GUI a una nuova dimensione e posizione.
Eventi
Si attiva quando viene attivato il pulsante.
Si è eseguito quando il mouse si è completamente lasciato fare clic sul pulsante GUI.
Si attiva quando il mouse è in stato giù sinistro sulla oggetto.
Spawna quando il mouse sinistro ha rilasciato l'oggetto GUI.
Si è eseguito quando il mouse ha fatto clic con il pulsante destro del mouse sul pulsante GUI.
Si attiva quando il mouse è in stato giusto a destra sul GUI oggetto.
Spara quando il pulsante destro del mouse è stato rilasciato su un oggetto GUI.
Si attiva quando un utente inizia a interagire con un dispositivo dell'interfaccia utente-computer (tasto del mouse, inizio del tocco, pulsante della tastiera, ecc).
Si attiva quando un utente cambia il modo in cui interagisce con un dispositivo dell'interfaccia utente-computer (tasto del mouse, inizio del tocco, pulsante del tastiera, ecc).
Si esegue quando un utente smette di interagire tramite un dispositivo di interfaccia uomo-corrispettore (tasto del mouse, inizio del tocco, pulsante del tastiera, ecc).
Si attiva quando un utente muove il mouse in un elemento GUI.
Si attiva quando un utente muove il mouse da un elemento GUI.
Si attiva ogni volta che un utente muove il mouse quando è all'interno di un elemento GUI.
Si attiva quando un utente fa scorrere la rotella del mouse quando il mouse è su un elemento GUI.
Si attiva quando un utente fa clic con il mouse sulla ruota del mouse quando il mouse è su un elemento GUI.
Fired quando l'oggetto GuiObject viene focalizzato con il Gamepad Selector.
Si è spento quando il Gamepad Selector ha smesso di concentrarsi sull'oggetto Gui.
Si attiva quando il giocatore inizia, continua e si ferma quando viene premuto a lungo sull'elemento UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore muove il dito sull'elemento UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore esegue un gesto di pizzico o di trazione utilizzando due dita sull'elemento UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore esegue una rotazione utilizzando due dita sull'elemento UI.
Si attiva quando il giocatore esegue una manovra di swipe sull'elemento UI.
Si attiva quando il giocatore esegue un gesto di tocco sull'elemento UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si attiva quando la selezione del gamepad si muove, si lascia o cambia all'interno della GuiBase2d connessa o di qualsiasi altro GuiObjects.
Proprietà
AutoButtonColor
Il pulsante AutoButtonColor determina se il pulsante cambia automaticamente colore quando l'utente Mouse passa il mouse su o fa clic su di esso.
Se è vero, il pulsante cambierà automaticamente colore quando il mouse si posiziona su o clicca su di esso. Se è falso, il pulsante non cambierà.
Se desideri personalizzare il modo in cui un pulsante cambia quando il mouse dell'utente si posa su o clicca su di esso, considera di utilizzare un ImageButton GUI e cambiare il ImageButton.HoverImage e ImageButton.PressedImage dell'elemento.
Nota che questa proprietà non avrà effetto su un ImageButton se la sua proprietà è impostata su un'immagine e non è nulla. Inoltre, la proprietà non influirà su un elemento ImageButton durante il mouse hover quando la sua proprietà ImageButton.Image non è nulla né sul mouse click se ImageButton.HoverImage
Campioni di codice
The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.
In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Se vero mentre l'elemento GUI è visibile, il mouse non sarà bloccato a meno che il pulsante del mouse destro non sia down.
Metodi
Eventi
Activated
Si attiva quando il pulsante viene attivato. Poiché questo evento non viene attivato sul Server, dovrebbe essere utilizzato solo in un LocalScript , o in un Script con RunContext di 2>Class.Script2> .
Parametri
MouseButton1Click
L'evento MouseButton1Click si attiva quando l'utente ha Mouse completamente lasciato i clic sul pulsante GUI.
Cliccando, il mouse deve essere all'interno dei limiti del pulsante e deve essere premuto e ripetuto prima che questo evento si attivi. Se il mouse lascia i limiti del pulsante e viene rilasciato, l'evento non si Lanciare. Se vuoi evitare questa limitazione, puoi usare GuiButton.MouseButton1Down e MouseButton1Up . Questi
Questo evento è simile a GuiButton.MouseButton2Click , che si comporta identificatamente ad eccezione del fatto che è connesso al pulsante destro del mouse dell'utente.
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Campioni di codice
The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
L'evento MouseButton1Down si attiva quando l'utente premere il oggettoa sinistra di Class.Mouse sulla GUI.
Questo evento è simile a GuiButton.MouseButton2Down , che si comporta identificatamente ad eccezione del fatto che è connesso al pulsante destro del mouse dell'utente.
Se stai cercando un evento che richiede l'utente di premere e rilasciare il mouse sinistro su un'GUI per il quale l'evento si Lanciare, considera di utilizzare GuiButton.MouseButton1Click .
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Parametri
La x screen coordinate del Topo, or mouse as computer mousein pixel.
La posizione dello schermo del Topo, or mouse as computer mousein pixel.
Campioni di codice
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
L'evento MouseButton1Up si attiva quando l'utente rilascia il suo pulsante sinistro Mouse fuori dall'oggetto GUI.
Questo evento è simile a GuiButton.MouseButton2Up , che si comporta identificatamente ad eccezione del fatto che è connesso al pulsante destro del mouse dell'utente.
Se stai cercando un evento che richiede l'utente di premere e rilasciare il mouse sinistro su un'GUI per il quale l'evento si Lanciare, considera di utilizzare GuiButton.MouseButton1Click .
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Parametri
La x screen coordinate del Topo, or mouse as computer mousein pixel.
La posizione dello schermo del Topo, or mouse as computer mousein pixel.
Campioni di codice
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
L'evento MouseButton2Click si attiva quando l'utente ha Mouse clic completi il pulsante GUI.
Cliccando, il mouse deve essere all'interno dei limiti del pulsante e deve essere premuto e ripetuto prima che questo evento si attivi. Se il mouse lascia i limiti del pulsante e viene rilasciato, l'evento non si Lanciare. Se vuoi evitare questa limitazione, puoi usare GuiButton.MouseButton2Down e MouseButton2Up . Questi
Questo evento è simile a GuiButton.MouseButton1Click , che si comporta identificatamente ad eccezione che è connesso al pulsante sinistro del mouse dell'utente.
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Campioni di codice
Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.
The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.
Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
L'evento MouseButton2Down si attiva quando l'utente premere il suo pulsante destro Mouse su l'oggetto GUI.
Questo evento è simile a GuiButton.MouseButton1Down , che si comporta identificatamente ad eccezione che è connesso al pulsante sinistro del mouse dell'utente.
Se stai cercando un evento che richiede l'utente di premere e rilasciare il suo pulsante destro del mouse su un'GUI per il quale l'evento si Lanciare, considera l'uso di GuiButton.MouseButton2Click .
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Parametri
La x screen coordinate del Topo, or mouse as computer mousein pixel.
La posizione dello schermo del Topo, or mouse as computer mousein pixel.
Campioni di codice
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
L'evento MouseButton2Up si attiva quando l'utente rilascia il suo diritto Mouse fuori dall'oggetto GUI.
Questo evento è simile a GuiButton.MouseButton1Up , che si comporta identificatamente ad eccezione che è connesso al pulsante sinistro del mouse dell'utente.
Se stai cercando un evento che richiede l'utente di premere e rilasciare il suo pulsante destro del mouse su un'GUI per il quale l'evento si Lanciare, considera l'uso di GuiButton.MouseButton2Click .
Nota che questo evento si attiverà solo per i pulsanti GUI, tra cui TextButtons e ImageButton . Non si attiverà per altri GuiObjects .
Parametri
La x screen coordinate del Topo, or mouse as computer mousein pixel.
La posizione dello schermo del Topo, or mouse as computer mousein pixel.
Campioni di codice
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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)