GuiButton

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Non Navigabile

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à

Proprietà provenienti da GuiObjectProprietà provenienti da GuiBase2d

Metodi

Metodi provenienti da GuiObject

Eventi

Eventi provenienti da GuiObjectEventi provenienti da GuiBase2d

Proprietà

AutoButtonColor

Lettura Parallela

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

Lettura Parallela

Un'istanza HapticEffect che verrà riprodotta quando il GuiButton viene sovrapposto.

Lettura Parallela

Se true mentre l'elemento GUI è visibile, il mouse non verrà bloccato a meno che il pulsante destro del mouse non sia giù.

PressHapticEffect

Lettura Parallela

Un'istanza HapticEffect che verrà riprodotta quando viene premuto il GuiButton .

Selected

Lettura Parallela

Una proprietà booleana che indica se l'oggetto è stato selezionato.

Lettura Parallela

Imposta lo stile del GuiButton in base a una lista di stili predefiniti.

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

inputObject: InputObject
clickCount: number

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.