Aprender
Clase de motor
ImageButton

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.



Referencia API
Propiedades
HoverImage
Leer paralelo
Capacidades: UI
ImageButton.HoverImage:ContentId

HoverImageContent
Leer paralelo
Capacidades: UI
ImageButton.HoverImageContent:Content

Image
Leer paralelo
Capacidades: UI
ImageButton.Image:ContentId
Muestras de código
Bloqueo de Imagen al Pasar el Ratón
local imageLabel = script.Parent
-- Las imágenes en este ejemplo son 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Candado desbloqueado (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Verde oscuro
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Candado bloqueado (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Rojo oscuro
end
-- Conectar eventos; nuestro estado predeterminado es bloqueado
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageColor3
Leer paralelo
Capacidades: UI
ImageButton.ImageColor3:Color3
Muestras de código
Bloqueo de Imagen al Pasar el Ratón
local imageLabel = script.Parent
-- Las imágenes en este ejemplo son 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Candado desbloqueado (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Verde oscuro
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Candado bloqueado (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Rojo oscuro
end
-- Conectar eventos; nuestro estado predeterminado es bloqueado
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageContent
Leer paralelo
Capacidades: UI
ImageButton.ImageContent:Content

ImageRectOffset
Leer paralelo
Capacidades: UI
ImageButton.ImageRectOffset:Vector2
Muestras de código
Animación de Imagen usando Spritesheet
-- Coloca esto en un ImageLabel/ImageButton con tamaño 256x256
local imageLabel = script.Parent
-- La siguiente imagen es 1024x1024 con 12 fotogramas (256x256)
-- Los fotogramas reproducen una animación de un hombre lanzando un puñetazo
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- El orden de los fotogramas a ser mostrados (de izquierda a derecha, luego de arriba a abajo)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Anima los fotogramas uno a la vez en un bucle
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageRectSize
Leer paralelo
Capacidades: UI
ImageButton.ImageRectSize:Vector2
Muestras de código
Animación de Imagen usando Spritesheet
-- Coloca esto en un ImageLabel/ImageButton con tamaño 256x256
local imageLabel = script.Parent
-- La siguiente imagen es 1024x1024 con 12 fotogramas (256x256)
-- Los fotogramas reproducen una animación de un hombre lanzando un puñetazo
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- El orden de los fotogramas a ser mostrados (de izquierda a derecha, luego de arriba a abajo)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Anima los fotogramas uno a la vez en un bucle
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageTransparency
Leer paralelo
Capacidades: UI
ImageButton.ImageTransparency:number

IsLoaded
Solo lectura
No replicado
Leer paralelo
Capacidades: UI
ImageButton.IsLoaded:boolean
Muestras de código
Tiempo de Carga de Imagen
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Espera a que la imagen se cargue
while not imageLabel.IsLoaded do
task.wait()
end
-- Mide y muestra cuánto tiempo tomó cargar
local deltaTime = workspace.DistributedGameTime - startTime
print(("La imagen se cargó en %.3f segundos"):format(deltaTime))

PressedImage
Leer paralelo
Capacidades: UI
ImageButton.PressedImage:ContentId

PressedImageContent
Leer paralelo
Capacidades: UI
ImageButton.PressedImageContent:Content

ResampleMode
Leer paralelo
Capacidades: UI
ImageButton.ResampleMode:Enum.ResamplerMode

ScaleType
Leer paralelo
Capacidades: UI
ImageButton.ScaleType:Enum.ScaleType

SliceCenter
Leer paralelo
Capacidades: UI
ImageButton.SliceCenter:Rect

SliceScale
Leer paralelo
Capacidades: UI
ImageButton.SliceScale:number

TileSize
Leer paralelo
Capacidades: UI
ImageButton.TileSize:UDim2

©2026 Roblox Corporation. Roblox, el logotipo de Roblox y "Powering Imagination" son algunas de nuestras marcas registradas y no registradas en los Estados Unidos y otros países.