Botones de texto e imagen

GuiButtons son GuiObjects que permiten a los jugadores realizar una acción. Puedes personalizar estos botones para proporcionar contexto y retroalimentación, como cambiar la apariencia visual o scripting retroalimentación audible cuando un jugador interactúa con un botón.

Hay dos tipos de botones que puedes colocar en la pantalla o en el juego:

• Un TextButton es un rectángulo con texto que activa el evento Activated y/o SecondaryActivated al hacer clic/tocar.

• Un ImageButton es un rectángulo con una imagen que activa el evento Activated y/o SecondaryActivated al hacer clic/tocar. Presenta estados adicionales para cambiar la imagen al pasar el cursor o presionar.

Botones en la pantalla

Los botones en la pantalla son útiles para guiar rápidamente a los jugadores a varios menús o páginas. Para agregar este tipo de botón:

1. En la ventana del Explorer, pasa el cursor sobre StarterGui, haz clic en el botón ⊕ y inserta un ScreenGui.

2. Pasa el cursor sobre el nuevo ScreenGui, haz clic en el botón ⊕ y inserta un TextButton o un ImageButton.

   

Botones en las caras de las piezas

Los botones en una pieza son útiles para permitir que los jugadores interactúen con las piezas. Por ejemplo, puedes permitir que los jugadores pisen un botón para completar una acción.

Para agregar un botón a la cara de una pieza:

1. En la ventana del Explorer, pasa el cursor sobre la pieza, haz clic en el botón ⊕ y inserta un SurfaceGui.

2. Pasa el cursor sobre el nuevo SurfaceGui, haz clic en el botón ⊕ y inserta un TextButton o un ImageButton.

   

   Si no ves el botón, intenta elegir una cara diferente (Top, Bottom, Front, Back, Left, o Right) para la propiedad Face del SurfaceGui.

Apariencia del botón

Tanto TextButton como ImageButton heredan de GuiObject, que contiene propiedades como BackgroundColor3, Rotation, y Size. Los botones también aceptan los modificadores de apariencia comunes a la mayoría de los objetos de UI.

Único para TextButton son varias propiedades para cambiar su apariencia visual:

• FontFace — La fuente utilizada para renderizar texto.
• Text — La cadena de texto renderizada en el botón.
• TextSize — La altura de línea del texto en desplazamientos.
• TextColor3 — Color del texto renderizado.

Un ImageButton tiene varias propiedades para cambiar su apariencia visual, incluyendo variantes de imagen al pasar el cursor y al presionar para indicar la interacción de un jugador con el botón:

• Image — La imagen que se muestra cuando un jugador no está interactuando con el ImageButton.
• HoverImage — La imagen que se muestra cuando un jugador pasa el cursor sobre el ImageButton.
• PressedImage — La imagen que se muestra cuando un jugador hace clic/toca el ImageButton.

Botones de script

Puedes programar una acción cuando un jugador presiona un botón conectando el botón al evento GuiButton.Activated, o a GuiButton.SecondaryActivated para la entrada secundaria multiplataforma como clic derecho en escritorio y presión larga en móvil. Por ejemplo, cuando pones el siguiente LocalScript como padre de un botón, el botón cambia a un color aleatorio cada vez que un jugador hace clic/toca en él.

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

local function onButtonActivated()
	-- Aleatoriza el color del botón
	button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end

button.Activated:Connect(onButtonActivated)