Botões de texto e imagem

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Botões são GuiObjects que permitem que os usuários realizem uma ação. Você pode personalizar botões para fornecer contexto e feedback, como mudar a aparência visual ou rotear feedback auditivo quando um usuário clica em um botão.

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

Um TextButton é um retângulo com texto que dispara o evento Activated ao clicar/tocar.
Um ImageButton é um retângulo com uma imagem que dispara o evento Activated ao clicar/tocar. Ele possui estados adicionais para trocar a imagem quando o usuário passar o mouse ou pressionar.

Criar botões na tela

Botões na tela são úteis para guiar rapidamente os usuários a vários menus ou páginas.

Para adicionar um botão à tela:

Na janela Explorer, selecione StarterGui e adicione um ScreenGui.
1. Passe o mouse sobre StarterGui e clique no botão ⊕. Um menu contextual será exibido.
2. Insira um ScreenGui.
Selecione o novo ScreenGui e adicione um botão.
1. Passe o mouse sobre ScreenGui e clique no botão ⊕. Um menu contextual será exibido.
2. Insira um TextButton ou ImageButton.

Criar botões nas faces das peças

Botões em uma peça são úteis para permitir que os usuários interajam com as peças. Por exemplo, você pode permitir que os usuários pisem em um botão para completar uma ação.

Para adicionar um botão à face de uma peça:

Na janela Explorer, selecione a peça e adicione um SurfaceGui.
1. Passe o mouse sobre a peça e clique no botão ⊕. Um menu contextual será exibido.
2. Insira um SurfaceGui.
Selecione o novo SurfaceGui e adicione qualquer tipo de botão ou entrada.
1. Passe o mouse sobre SurfaceGui e clique no botão ⊕. Um menu contextual será exibido.
2. Insira um TextButton ou ImageButton.
Se você não ver o botão, tente escolher uma face diferente na propriedade Face do SurfaceGui.

Mudar a aparência de um ImageButton

Mudar a aparência de um ImageButton quando um usuário está interagindo com ele fornece um feedback visual útil. Por exemplo, quando um ImageButton muda a aparência visual quando um usuário passa o mouse sobre ele, isso informa ao usuário que ele não está desativado e que ele tem a opção de clicar nele se quiser realizar essa ação do ImageButton.

Um ImageButton possui três propriedades para mudar sua aparência visual:

Image - A imagem que é exibida quando um usuário não está interagindo com o ImageButton.
HoverImage - A imagem que é exibida quando um usuário está passando o cursor sobre o ImageButton.
PressedImage - A imagem que é exibida quando um usuário está clicando no ImageButton.

Para mudar a aparência de um ImageButton com a entrada do usuário:

Adicione um ImageButton a uma tela ou a uma superfície.
Na janela Explorer, clique no objeto ImageButton.
Na janela Properties, atribua três IDs de ativos diferentes, respectivamente, para as propriedades Image, HoverImage e PressedImage.

Roteiro de botões

Você pode roteirizar uma ação quando um usuário pressiona um botão conectando o botão a um evento GuiButton.Activated. Por exemplo, ao incluir o seguinte LocalScript como filho de um botão, o botão muda para uma cor aleatória toda vez que um usuário clica nele.


local button = script.Parent
local RNG = Random.new()
local function onButtonActivated()
	-- randomize the button color
	button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end
button.Activated:Connect(onButtonActivated)

Português (Brasil)