GuiButtons sono GuiObjects che consentono ai giocatori di eseguire un'azione. Puoi personalizzare questi pulsanti per fornire contesto e feedback, come cambiare l'aspetto visivo o scripting feedback udibili quando un giocatore interagisce con un pulsante.
Ci sono due tipi di pulsanti che puoi posizionare sullo schermo o in gioco:
Un TextButton è un rettangolo con testo che attiva l'evento Activated e/o SecondaryActivated al clic/tap.
Un ImageButton è un rettangolo con un'immagine che attiva l'evento Activated e/o SecondaryActivated al clic/tap. Presenta stati aggiuntivi per cambiare l'immagine quando il giocatore passa il mouse o preme.
Pulsanti sullo schermo
I pulsanti sullo schermo sono utili per guidare rapidamente i giocatori verso vari menu o pagine. Per aggiungere questo tipo di pulsante:
Nella finestra Explorer, passa il mouse su StarterGui, fai clic sul pulsante ⊕ e inserisci un ScreenGui.
Passa il mouse sul nuovo ScreenGui, fai clic sul pulsante ⊕ e inserisci un TextButton o un ImageButton.

Pulsanti sulle facce dei pezzi
I pulsanti su un pezzo sono utili per consentire ai giocatori di interagire con i pezzi. Ad esempio, puoi consentire ai giocatori di calpestare un pulsante per completare un'azione.
Per aggiungere un pulsante alla faccia di un pezzo:
Nella finestra Explorer, passa il mouse sul pezzo, fai clic sul pulsante ⊕ e inserisci un SurfaceGui.
Passa il mouse sul nuovo SurfaceGui, fai clic sul pulsante ⊕ e inserisci un TextButton o un ImageButton.

Aspetto del pulsante
Sia TextButton che ImageButton ereditano da GuiObject, che contiene proprietà come BackgroundColor3, Rotation, e Size. I pulsanti accettano anche i modificatori di aspetto comuni alla maggior parte degli oggetti UI.
Unici per TextButton ci sono varie proprietà per cambiare il suo aspetto visivo:
- FontFace — Il font utilizzato per rendere il testo.
- Text — La stringa di testo visualizzata sul pulsante.
- TextSize — L'altezza della linea del testo in offset.
- TextColor3 — Colore del testo visualizzato.
Un ImageButton ha diverse proprietà per cambiare il suo aspetto visivo, comprese le varianti dell'immagine al passaggio del mouse e quando è premuto per indicare l'interazione di un giocatore con il pulsante:
- Image — L'immagine che viene visualizzata quando un giocatore non interagisce con il ImageButton.
- HoverImage — L'immagine che viene visualizzata quando un giocatore passa il cursore sopra il ImageButton.
- PressedImage — L'immagine che viene visualizzata quando un giocatore clicca/tocca il ImageButton.



Pulsanti di script
Puoi programmare un'azione quando un giocatore preme un pulsante collegando il pulsante all'evento GuiButton.Activated, o a GuiButton.SecondaryActivated per input secondari multipiattaforma come il clic destro su desktop e la pressione prolungata su mobile. Ad esempio, quando posizioni il seguente LocalScript su un pulsante, il pulsante cambia in un colore casuale ogni volta che un giocatore clicca/tocca.
local button = script.Parent
local RNG = Random.new()
local function onButtonActivated()
-- Randomizza il colore del pulsante
button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end
button.Activated:Connect(onButtonActivated)