Ghi chú phát hành
Học
Lớp công cụ
ImageButton

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.


Tóm Tắt
Thành viên kế thừa

Tài Liệu Tham Khảo API
Thuộc Tính
HoverImage
Đọc Song Song
Các khả năng: UI
ImageButton.HoverImage:ContentId

HoverImageContent
Đọc Song Song
Các khả năng: UI
ImageButton.HoverImageContent:Content

Image
Đọc Song Song
Các khả năng: UI
ImageButton.Image:ContentId
Mẫu mã
Khóa Hình Ảnh Khi Di Chuột
local imageLabel = script.Parent
-- Các hình ảnh trong ví dụ này có kích thước 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Ổ khóa đã mở (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Xanh lá tối
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Ổ khóa đã khóa (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Đỏ tối
end
-- Kết nối sự kiện; trạng thái mặc định của chúng tôi là đã khóa
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageColor3
Đọc Song Song
Các khả năng: UI
ImageButton.ImageColor3:Color3
Mẫu mã
Khóa Hình Ảnh Khi Di Chuột
local imageLabel = script.Parent
-- Các hình ảnh trong ví dụ này có kích thước 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Ổ khóa đã mở (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Xanh lá tối
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Ổ khóa đã khóa (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Đỏ tối
end
-- Kết nối sự kiện; trạng thái mặc định của chúng tôi là đã khóa
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageContent
Đọc Song Song
Các khả năng: UI
ImageButton.ImageContent:Content

ImageRectOffset
Đọc Song Song
Các khả năng: UI
ImageButton.ImageRectOffset:Vector2
Mẫu mã
Hoạt Hình Hình Ảnh Sử Dụng Spritesheet
-- Đặt dòng này trong một ImageLabel/ImageButton với kích thước 256x256
local imageLabel = script.Parent
-- Hình ảnh sau đây có kích thước 1024x1024 với 12 khung hình (256x256)
-- Các khung hình phát hoạt hình của một người đàn ông đang tung cú đấm
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- Thứ tự của các khung hình sẽ được hiển thị (từ trái sang phải, sau đó từ trên xuống dưới)
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),
}
-- Hoạt hình các khung hình một cách từng cái một trong một vòng lặp
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageRectSize
Đọc Song Song
Các khả năng: UI
ImageButton.ImageRectSize:Vector2
Mẫu mã
Hoạt Hình Hình Ảnh Sử Dụng Spritesheet
-- Đặt dòng này trong một ImageLabel/ImageButton với kích thước 256x256
local imageLabel = script.Parent
-- Hình ảnh sau đây có kích thước 1024x1024 với 12 khung hình (256x256)
-- Các khung hình phát hoạt hình của một người đàn ông đang tung cú đấm
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- Thứ tự của các khung hình sẽ được hiển thị (từ trái sang phải, sau đó từ trên xuống dưới)
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),
}
-- Hoạt hình các khung hình một cách từng cái một trong một vòng lặp
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageTransparency
Đọc Song Song
Các khả năng: UI
ImageButton.ImageTransparency:number

IsLoaded
Chỉ Đọc
Không Sao Chép
Đọc Song Song
Các khả năng: UI
ImageButton.IsLoaded:boolean
Mẫu mã
Thời gian tải hình ảnh
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Chờ hình ảnh tải
while not imageLabel.IsLoaded do
task.wait()
end
-- Đo và hiển thị thời gian cần để tải
local deltaTime = workspace.DistributedGameTime - startTime
print(("Hình ảnh đã tải trong %.3f giây"):format(deltaTime))

PressedImage
Đọc Song Song
Các khả năng: UI
ImageButton.PressedImage:ContentId

PressedImageContent
Đọc Song Song
Các khả năng: UI
ImageButton.PressedImageContent:Content

ResampleMode
Đọc Song Song
Các khả năng: UI
ImageButton.ResampleMode:Enum.ResamplerMode

ScaleType
Đọc Song Song
Các khả năng: UI
ImageButton.ScaleType:Enum.ScaleType

SliceCenter
Đọc Song Song
Các khả năng: UI
ImageButton.SliceCenter:Rect

SliceScale
Đọc Song Song
Các khả năng: UI
ImageButton.SliceScale:number

TileSize
Đọc Song Song
Các khả năng: UI
ImageButton.TileSize:UDim2

©2026 Roblox Corporation. Roblox, logo Roblox và Powering Imagination là các nhãn hiệu đã đăng ký và chưa đăng ký của chúng tôi tại Hoa Kỳ và các quốc gia khác.