Lernen
Engine-Klasse
ImageButton

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.



API-Referenz
Eigenschaften
HoverImage
Parallel lesen
Funktionen: UI
ImageButton.HoverImage:ContentId

HoverImageContent
Parallel lesen
Funktionen: UI
ImageButton.HoverImageContent:Content

Image
Parallel lesen
Funktionen: UI
ImageButton.Image:ContentId
Code-Beispiele
Bild Hover Schloss
local imageLabel = script.Parent
-- Die Bilder in diesem Beispiel sind 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Entsperrtes Schloss (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dunkelgrün
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Verschlossenes Schloss (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dunkelrot
end
-- Verbinde Ereignisse; unser Standardzustand ist gesperrt
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageColor3
Parallel lesen
Funktionen: UI
ImageButton.ImageColor3:Color3
Code-Beispiele
Bild Hover Schloss
local imageLabel = script.Parent
-- Die Bilder in diesem Beispiel sind 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Entsperrtes Schloss (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dunkelgrün
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Verschlossenes Schloss (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dunkelrot
end
-- Verbinde Ereignisse; unser Standardzustand ist gesperrt
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageContent
Parallel lesen
Funktionen: UI
ImageButton.ImageContent:Content

ImageRectOffset
Parallel lesen
Funktionen: UI
ImageButton.ImageRectOffset:Vector2
Code-Beispiele
Bildanimation mit Spritesheet
-- Platziere dies in einem ImageLabel/ImageButton mit der Größe 256x256
local imageLabel = script.Parent
-- Das folgende Bild hat die Größe 1024x1024 mit 12 Frames (256x256)
-- Die Frames zeigen eine Animation eines Mannes, der einen Schlag ausführt
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- Die Reihenfolge der anzuzeigenden Frames (von links nach rechts, dann von oben nach unten)
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),
}
-- Animieren Sie die Frames nacheinander in einer Schleife
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageRectSize
Parallel lesen
Funktionen: UI
ImageButton.ImageRectSize:Vector2
Code-Beispiele
Bildanimation mit Spritesheet
-- Platziere dies in einem ImageLabel/ImageButton mit der Größe 256x256
local imageLabel = script.Parent
-- Das folgende Bild hat die Größe 1024x1024 mit 12 Frames (256x256)
-- Die Frames zeigen eine Animation eines Mannes, der einen Schlag ausführt
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- Die Reihenfolge der anzuzeigenden Frames (von links nach rechts, dann von oben nach unten)
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),
}
-- Animieren Sie die Frames nacheinander in einer Schleife
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageTransparency
Parallel lesen
Funktionen: UI
ImageButton.ImageTransparency:number

IsLoaded
Schreibgeschützt
Nicht repliziert
Parallel lesen
Funktionen: UI
ImageButton.IsLoaded:boolean
Code-Beispiele
Bildladezeit
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Warte, bis das Bild geladen ist
while not imageLabel.IsLoaded do
task.wait()
end
-- Messe und zeige an, wie lange das Laden gedauert hat
local deltaTime = workspace.DistributedGameTime - startTime
print(("Bild wurde in %.3f Sekunden geladen"):format(deltaTime))

PressedImage
Parallel lesen
Funktionen: UI
ImageButton.PressedImage:ContentId

PressedImageContent
Parallel lesen
Funktionen: UI
ImageButton.PressedImageContent:Content

ResampleMode
Parallel lesen
Funktionen: UI
ImageButton.ResampleMode:Enum.ResamplerMode

ScaleType
Parallel lesen
Funktionen: UI
ImageButton.ScaleType:Enum.ScaleType

SliceCenter
Parallel lesen
Funktionen: UI
ImageButton.SliceCenter:Rect

SliceScale
Parallel lesen
Funktionen: UI
ImageButton.SliceScale:number

TileSize
Parallel lesen
Funktionen: UI
ImageButton.TileSize:UDim2

©2026 Roblox Corporation. Roblox, das Roblox-Logo und "Powering Imagination" gehören zu unseren eingetragenen und nicht eingetragenen Markenzeichen in den USA und anderen Ländern.