Botões de texto e imagem

GuiButtons são GuiObjects que permitem que os jogadores realizem uma ação. Você pode personalizar esses botões para fornecer contexto e feedback, como mudar a aparência visual ou scripting feedback audível quando um jogador interage com um botão.

Existem dois tipos de botões que você pode colocar na tela ou no jogo:

• Um TextButton é um retângulo com texto que aciona o evento Activated e/ou SecondaryActivated ao clicar/tocar.

• Um ImageButton é um retângulo com uma imagem que aciona o evento Activated e/ou SecondaryActivated ao clicar/tocar. Ele possui estados adicionais para trocar a imagem ao passar o mouse ou pressionar.

Botões na tela

Botões na tela são úteis para guiar rapidamente os jogadores a vários menus ou páginas. Para adicionar esse tipo de botão:

1. Na janela Explorer, passe o mouse sobre StarterGui, clique no botão ⊕ e insira um ScreenGui.

2. Passe o mouse sobre o novo ScreenGui, clique no botão ⊕ e insira um TextButton ou ImageButton.

   

Botões nas faces das partes

Botões em uma parte são úteis para permitir que os jogadores interajam com partes. Por exemplo, você pode permitir que os jogadores pisem em um botão para completar uma ação.

Para adicionar um botão à face de uma parte:

1. Na janela Explorer, passe o mouse sobre a parte, clique no botão ⊕ e insira um SurfaceGui.

2. Passe o mouse sobre o novo SurfaceGui, clique no botão ⊕ e insira um TextButton ou ImageButton.

   

   Se você não ver o botão, tente escolher uma face diferente (Top, Bottom, Front, Back, Left, ou Right) para a propriedade Face do SurfaceGui.

Aparência do botão

Tanto TextButton quanto ImageButton herdam de GuiObject, que contém propriedades como BackgroundColor3, Rotation, e Size. Os botões também aceitam os modificadores de aparência comuns à maioria dos objetos de UI.

Único para TextButton são várias propriedades para mudar sua aparência visual:

• FontFace — A fonte usada para renderizar texto.
• Text — A string de texto renderizada no botão.
• TextSize — A altura da linha do texto em offsets.
• TextColor3 — Cor do texto renderizado.

Um ImageButton tem várias propriedades para mudar sua aparência visual, incluindo variantes de imagem ao passar o mouse e pressionado para indicar a interação de um jogador com o botão:

• Image — A imagem que é exibida quando um jogador não está interagindo com o ImageButton.
• HoverImage — A imagem que é exibida quando um jogador está passando o cursor sobre o ImageButton.
• PressedImage — A imagem que é exibida quando um jogador clica/toca no ImageButton.

Botões de script

Você pode scriptar uma ação quando um jogador pressiona um botão conectando o botão ao evento GuiButton.Activated, ou ao GuiButton.SecondaryActivated para entrada secundária multiplataforma, como clique direito no desktop e pressionamento longo no celular. Por exemplo, quando você parenta o seguinte LocalScript a um botão, o botão muda para uma cor aleatória toda vez que um jogador clica/toca nele.

local button = script.Parent
local RNG = Random.new()

local function onButtonActivated()
	-- Randomize a cor do botão
	button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end

button.Activated:Connect(onButtonActivated)