GuiButton
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
GuiButton è una classe astratta che eredita da GuiObject.È la classe base per gli oggetti interattivi, clickabili ImageButton e TextButton .Questa classe definisce anche diverse proprietà per il comportamento interattivo, vale a dire AutoButtonColor e Modal.
L'evento più importante di un GuiButton è Activated , un evento multi-piattaforma che si attiva quando il pulsante viene attivato.Quando si utilizza un Topo, or mouse as computer mouse, questo significa fare clic sul pulsante e rilasciare con il cursore ancora sull'oggetto UI.Per il tocco, vale lo stesso ma con un tocco invece di una Stamparedi pulsante.Infine, per i gamepad, Activated brucia se un GuiButton è selezionato quando viene premuto e rilasciato il pulsante A .In breve, questo evento è molto utile per la programmazione dell'interfaccia utente multi-piattaforma poiché fornisce una bella interfaccia generale per un singolo input dell'utente.
Sommario
Proprietà
Determina se il pulsante cambia colore automaticamente quando il mouse passa sopra o clicca su di esso.
Un'istanza HapticEffect che verrà riprodotta quando il GuiButton viene sovrapposto.
Se true mentre l'elemento GUI è visibile, il mouse non verrà bloccato a meno che il pulsante destro del mouse non sia giù.
Un'istanza HapticEffect che verrà riprodotta quando viene premuto il GuiButton .
Una proprietà booleana che indica se l'oggetto è stato selezionato.
Imposta lo stile del GuiButton in base a una lista di stili predefiniti.
Determina se questo elemento UI riceve l'input.
Determina il punto di origine di un GuiObject , rispetto alla sua dimensione assoluta.
Determina se la ridimensionamento avvenga in base al contenuto del figlio.
Determina il colore di sfondo GuiObject .
Determina la trasparenza del GuiObject.
Determina il colore del bordo GuiObject .
Determina in che modo il bordo GuiObject viene disposto rispetto alle sue dimensioni.
Determina la larghezza dei pixel del bordo GuiObject .
Determina se il discendente GuiObjects al di fuori dei confini di un elemento GUI padre deve Renderizzare.
Determina se il mouse del Giocatoreviene attivamente premuto su GuiObject o no.
Determina se il GuiButton può essere interagito o meno, o se il GuiState del GuiObject sta cambiando o meno.
Controlla l'ordine di selezione del GuiObject quando viene utilizzato con un UIGridStyleLayout .
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato verso il basso.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato a sinistra.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato a destra.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato verso l'alto.
Determina la posizione pixelare e scalare del GuiObject .
Determina il numero di gradi con cui il GuiObject viene ruotato.
Determina se il GuiObject può essere selezionato da un gamepad.
Sovrascrive l'abbellimento di selezione predefinito utilizzato per i gamepad.
L'ordine di GuiObjects selezionato dall'interfaccia utente del gamepad.
Determina la dimensione pixelare e scalare del GuiObject .
Imposta gli assi Size su cui si baserà il GuiObject , rispetto alla dimensione del suo parent.
Una proprietà mista di BackgroundTransparency e TextTransparency.
Determina se verranno resi i GuiObject e i suoi discendenti.
Determina l'ordine in cui un GuiObject rende relativamente agli altri.
Descrive la posizione effettiva dello schermo di un elemento GuiBase2d in pixel.
Descrive la rotazione effettiva dello schermo di un elemento GuiBase2d in gradi.
Descrive la dimensione effettiva dello schermo di un elemento GuiBase2d , in pixel.
Quando è impostato su true , la localizzazione verrà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable da utilizzare per applicare la localizzazione automatizzata a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento di selezione del gamepad nella direzione down.
Personalizza il comportamento di selezione del gamepad nella direzione sinistra.
Personalizza il comportamento di selezione del gamepad nella direzione giusta.
Personalizza il comportamento di selezione del gamepad nella direzione up.
Consente la personalizzazione del movimento di selezione del gamepad.
Metodi
Metodi provenienti da GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Sposta lisciamente una GUI a una nuova 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
Sposta senza problemi una GUI a una nuova dimensione e posizione.
Eventi
Si attiva quando il pulsante è attivato.
Si accende quando il mouse dell'utente fa clic completo sul GuiButton .
Si accende quando l'utente premere il pulsante sinistro del mouse su GuiButton .
Si accende quando l'utente rilascia il pulsante sinistro del mouse fuori dal GuiButton .
Si accende quando il mouse dell'utente fa clic con il pulsante destro completo su GuiButton .
Si accende quando l'utente premere il pulsante destro del mouse verso il basso sul GuiButton .
Si accende quando l'utente rilascia il pulsante destro del mouse off del GuiButton .
Spedito quando un utente inizia a interagire tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse giù, tocco di inizio, pulsante della tastiera giù, ecc.).
Spedito quando un utente cambia il modo in cui interagisce tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse verso il basso, tocco di inizio, pulsante della tastiera verso il basso, ecc.).
Spedito quando un utente smette di interagire tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse giù, tocco di inizio, pulsante della tastiera giù, ecc.).
Si attiva quando un utente muove il mouse su un elemento GUI.
Si attiva quando un utente muove il mouse fuori da un elemento GUI.
Si attiva ogni volta che un utente muove il mouse mentre è all'interno di un elemento GUI.
Si accende quando un utente fa scorrere la ruota del mouse indietro quando il mouse è sopra un elemento GUI.
Si accende quando un utente scorre la ruota del mouse in avanti quando il mouse è sopra un elemento GUI.
Spedito quando l'oggetto Gui viene focalizzato con il selettore Gamepad.
Spedito quando il selettore del Gamepad smette di concentrarsi sull'GuiObject.
Si accende quando il giocatore inizia, continua e smette di premere a lungo l'elemento UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore muove il dito sull'elemento UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore esegue una pinza o una trazione utilizzando due dita sull'elemento UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore esegue un gesto di rotazione utilizzando due dita sull'elemento UI.
Si attiva quando il giocatore esegue una gesture di scorrimento sull'elemento UI.
Si attiva quando il giocatore esegue una gesture tap sull'elemento UI.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si accende quando la selezione del gamepad si sposta, lascia o cambia all'interno del connesso GuiBase2d o di qualsiasi discendente GuiObjects .
Proprietà
AutoButtonColor
Questa proprietà determina se il pulsante cambia colore automaticamente quando l'utente lo passa sopra o lo fa clic.Se true , il pulsante cambierà automaticamente colore quando il mouse si posiziona sopra o clicca su di esso.Se false , il pulsante non cambierà.
Se vuoi personalizzare il modo in cui un pulsante cambia quando il mouse dell'utente passa sopra o clicca su di esso, considera di utilizzare un ImageButton e cambiare l'elemento HoverImage e PressedImage.
Si prega di notare che questa proprietà non avrà alcun effetto su un ImageButton se la sua proprietà Image è impostata su un'immagine.Inoltre, questa proprietà non influirà su un ImageButton quando il suo HoverImage non è nil , né su un clic del mouse se il suo PressedImage non è nil .
HoverHapticEffect
Un'istanza HapticEffect che verrà riprodotta quando il GuiButton viene sovrapposto.
Modal
Se true mentre l'elemento GUI è visibile, il mouse non verrà bloccato a meno che il pulsante destro del mouse non sia giù.
Metodi
Eventi
Activated
Si attiva quando il pulsante è attivato.Poiché questo evento non viene eseguito sul Server, deve essere utilizzato solo in un LocalScript , o in un Script con RunContext di Enum.RunContext.Client .
Parametri
MouseButton1Click
Questo evento si attiva quando il mouse dell'utente fa clic completamente a sinistra sul GuiButton .
Per quanto riguarda il clic, il mouse deve essere all'interno dei confini del GuiButton e il pulsante del mouse deve essere premuto verso il basso e nuovamente prima che questo evento si attivi.Se il mouse lascia i confini del GuiButton e viene rilasciato, l'evento non verrà Lanciare.Se vuoi evitare questa limitazione, puoi usare MouseButton1Down e MouseButton1Up ; questi eventi sono simili ma si attiveranno ogni volta che l'utente premerà il pulsante sinistro del mouse verso il basso o verso l'alto, rispettivamente.
MouseButton1Down
Questo evento si attiva quando l'utente premere il pulsante sinistro del mouse su GuiButton .
Per un evento che richiede che l'utente premetta e rilasci il mouse sinistro su un GuiButton in modo che l'evento venga Lanciare, considera l'uso di MouseButton1Click .
Parametri
Le coordinate dello schermo X del Topo, or mouse as computer mousein pixel.
Le coordinate dello schermo del Topo, or mouse as computer mouse Y in pixel.
MouseButton1Up
Questo evento si attiva quando l'utente rilascia il pulsante sinistro del mouse off del GuiButton .
Per un evento che richiede che l'utente premetta e rilasci il mouse sinistro su un GuiButton in modo che l'evento venga Lanciare, considera l'uso di MouseButton1Click .
Parametri
Le coordinate dello schermo X del Topo, or mouse as computer mousein pixel.
Le coordinate dello schermo del Topo, or mouse as computer mouse Y in pixel.
MouseButton2Click
Questo evento si attiva quando il mouse dell'utente fa clic con il pulsante destro completo su GuiButton .
Per quanto riguarda il clic, il mouse deve essere all'interno dei confini del GuiButton e il pulsante del mouse deve essere premuto verso il basso e nuovamente prima che questo evento si attivi.Se il mouse lascia i confini del GuiButton e viene rilasciato, l'evento non verrà Lanciare.Se vuoi evitare questa limitazione, puoi usare MouseButton2Down e MouseButton2Up ; questi eventi sono simili ma si attiveranno ogni volta che l'utente premerà il pulsante destro del mouse o l'alto, rispettivamente.
MouseButton2Down
Questo evento si attiva quando l'utente premere il pulsante destro del mouse verso il basso sul GuiButton .
Per un evento che richiede che l'utente premi e rilasci il mouse destro su un GuiButton in modo che l'evento venga Lanciare, considera l'uso di MouseButton2Click .
Parametri
Le coordinate dello schermo X del Topo, or mouse as computer mousein pixel.
Le coordinate dello schermo del Topo, or mouse as computer mouse Y in pixel.
MouseButton2Up
Questo evento si attiva quando l'utente rilascia il pulsante destro del mouse off del GuiButton .
Per un evento che richiede che l'utente premi e rilasci il mouse destro su un GuiButton in modo che l'evento venga Lanciare, considera l'uso di MouseButton2Click .
Parametri
Le coordinate dello schermo X del Topo, or mouse as computer mousein pixel.
Le coordinate dello schermo del Topo, or mouse as computer mouse Y in pixel.