ImageLabel

Hiển Thị Bản Đã Lỗi Thời

*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.

Một ImageLabel tạo một hình chữ nhật, giống như một Frame đang làm, với một tài nguyên hình ảnh. Hiển thị c

Các hành động tiên tiến ImageLabel bao gồm:

  • Hình ảnh có thể được tạo bằng cách đặt ScaleType để Enum.ScaleType.Tile , sau đó TileSize đến kích thước của gạch đã hiển thị.

  • 9-Slice images can be created by setting ScaleType to Enum.ScaleType.Slice , then SliceCenter to the center area of the 9‑Slice image.

  • Các tấm Sprite có thể được thực hiện thông qua sử dụng các biến ImageRectOffset và ImageRectSize . Gói nhiều hình ảnh vào một và sử dụng thuộc tính này có thể làm cho các tài nguyên hình

Tóm Tắt

Thuộc Tính

  • Image:ContentId
    Đọc Song Song

    Nội dung hình ảnh hiển thị bởi thành phần UI. Đọc và viết vào ImageContent .

  • ImageColor3:Color3
    Đọc Song Song

    Xác định cách màu sắc hình ảnh được tạo.

  • ImageContent:Content
    Ẩn
    Đọc Song Song

    Nội dung hình ảnh được hiển thị bởi thành phần UI. Hỗ trợ liên kết tài sản và EditableImage .

  • ImageRectOffset:Vector2
    Đọc Song Song

    Số lệch trong pixel của khu vực dưới đấy của hình ảnh để hiển thị.

  • ImageRectSize:Vector2
    Đọc Song Song

    Xác định kích thước trong pixel của khu vực hình ảnh để được hiển thị.

  • ImageTransparency:number
    Đọc Song Song

    Xác định độ trong suốt của hình ảnh đã tạo.

  • IsLoaded:bool
    Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    Chỉ ra nếu hình ảnh đã tải xong từ Roblox.

  • ResampleMode:Enum.ResamplerMode
    Đọc Song Song

    Chọn chế độ điều chỉnh hình ảnh cho nhãn.

  • ScaleType:Enum.ScaleType
    Đọc Song Song

    Xác định cách mà hình ảnh sẽ thay đổi kích thước nếu được hiển thị trong một thành phần UI whose kích thước khác biệt từ hình ảnh nguồn.

  • SliceCenter:Rect
    Đọc Song Song

    Đặt giới hạn cắt của hình ảnh 9-sliced.

  • SliceScale:number
    Đọc Song Song

    Tăng 9 cạnh mép bằng tỷ lệ được xác định.

  • TileSize:UDim2
    Đọc Song Song

    Điều chỉnh kích thước thẻ hiển thị của hình ảnh.

Thuộc Tính kế thừa từ GuiObjectThuộc Tính kế thừa từ GuiBase2d
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

Phương Pháp kế thừa từ GuiObject
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Sự Kiện

Sự Kiện kế thừa từ GuiObjectSự Kiện kế thừa từ GuiBase2d
  • SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal

    Kích hoạt khi lựa chọn gamepad di chuyển đến, rời đi hoặc thay đổi trong khu vực GuiBase2d hoặc bất kỳ con cháu GuiObjects kế tiếp.

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Thuộc Tính

Image

ContentId
Đọc Song Song

Đây là một thuộc tính kiểu nội dung nên chứa ID tài nguyên của hình ảnh hoặc decal đã tải lên Roblox. Nó hoạt động tương tự như Decal.Texture đối với việc tải hình ảnh từ Roblox.

ImageColor3

Color3
Đọc Song Song

Thuộc tính ImageColor3 xác định cách thức mà một hình ảnh được màu sắc. Khi được đặt trên trắng, không có sự hiện diện của màu sắc. Thuộc tính này rất hữu ích cho việc tái sử dụng nguồn ảnh; nếu hình ảnh nguồn là hoàn toàn trắng với độ

ImageContent

Content
Ẩn
Đọc Song Song

Thuộc tính này nên giữ một URL tài sản hoặc một tham chiếu đến một EditableImage đối tượng.

URL tài nguyên có thể tham khảo một decal hoặc hình ảnh đã tải lên Roblox. Nó hoạt động tương tự như Decal.Texture đối với việc tải hình ảnh.

Hình ảnh được tạo sẽ được nhuộm màu bằng cách sử dụng ImageButton.ImageColor3 . Có thể tạo hình ảnh nhuộm màu bằng cách điều chỉnh thuộc tính ImageButton.ScaleType .

ImageRectOffset

Vector2
Đọc Song Song

Cho phép hiển thị một phần của hình ảnh trong khi sử dụng ImageRectSize . Điều này xác định sự thay đổi pixel (từ trên cùng bên trái) của khu vực hình ảnh để được hiển thị.

ImageRectSize

Vector2
Đọc Song Song

Cho phép hiển thị một hình ảnh bằng cách kết hợp với ImageRectOffset. This property determines the pixel size of the image area to be displayed. If either dimension is set to 0 , the entire image is displayed instead.

ImageTransparency

number
Đọc Song Song

ImageTransparency định nghĩa độ alpha của hình ảnh thuộc thể thao trong một thành phần UI. Một giá trị của 0 đang hoàn toàn bị che giấu và một giá trị của 1 đang hoàn toàn trong suốt (hiển thị).

Mẫu mã

This code sample oscillates the ImageTransparency of an ImageLabel/ImageButton from 0 to 1 using a sine wave.

Oscillate ImageTransparency
local RunService = game:GetService("RunService")



local imageLabel = script.Parent



local function onRenderStep()

	-- Oscillate ImageTransparency from 0 to 1 using a sine wave

	imageLabel.ImageTransparency = math.sin(workspace.DistributedGameTime * math.pi) * 0.5 + 0.5

end



RunService.RenderStepped:Connect(onRenderStep)

IsLoaded

bool
Chỉ Đọc
Không Sao Chép
Đọc Song Song

Thuộc tính IsLoaded cho biết có phải ImageLabel.Image đã hoàn thành việc tải từ Roblox. Các hình ảnh bị từ chối bởi kiểm duyệt sẽ không bao giờ được tải.

Mẫu mã

This code sample measures how long an ImageLabel or ImageButton takes to load an image. If the image was already loaded, this will be 0.

Image Load Time
local imageLabel = script.Parent



local startTime = workspace.DistributedGameTime



-- Wait for the image to load

while not imageLabel.IsLoaded do

	task.wait()

end



-- Measure and display how long it took to load

local deltaTime = workspace.DistributedGameTime - startTime

print(("Image loaded in %.3f seconds"):format(deltaTime))

ResampleMode

Enum.ResamplerMode
Đọc Song Song

Xác định cách hình ảnh xem khi được thiết lập. Bởi mặc định, hình ảnh mịn tay khi được hiển thị trên màn hình lớn hơn hoặc nhỏ hơn kích thước trong bộ nhớ hình ảnh. Khi được đặt để Entity.ResamplerMode.Pixelated|Entity.ResamplerMode.Pixelized

ScaleType

Enum.ScaleType
Đọc Song Song

Thuộc tính ScaleType xác định cách mà một ImageLabel.Image được hiển thị khi kích thước thực tế của yếu tố UI không khớp nối với kích thước của hình ảnh nguồn.

Bởi mặc định, thuộc tính này là Enum.ScaleType.Stretch which will simply stretch/compact the image dimensions so it fits the UI element's space exactly. Since transparent pixels are set to black when uploading to Roblox, transparent images should apply alpha bluring to avoid a blackish outline around scaled images.

Đối với Enum.ScaleType.Slice, property SliceCenter sẽ được hiển thị trong cửa sổ Properties. Đối với UI bảy-slayer, các góc sẽ ở lại kích thước hình ảnh nguồn. Các mép của

Cuối cùng, cho Enum.ScaleType.Tile, thuộc tính TileSize sẽ được tiết lộ trong cửa sổ Thông tin cá nhân. Đây là cho các hình ảnh có kích thước lớn, nơi kích thước của mỗi hì

SliceCenter

Rect
Đọc Song Song

Tính năng SliceCenter lập các giới hạn cắt của hình ảnh 9-sliced khi ScaleType được đặt thành Enum.ScaleType.Slice . Lưu ý rằng tính năng này chỉ xuất hiện trong các c

Để tìm hiểu thêm về hình ảnh 9-Slice, xem Thiết kế UI 9 Slice.

SliceScale

number
Đọc Song Song

Tăng kích thước các cạnh 9-Slice theo tỷ lệ được xác định. Điều này có nghĩa là các cạnh xung quanh 9-Slice sẽ lớn lên như thể bạn đã tải một phiên bản mới của textured upscaled. Mặc định là 1.0 .

Xem thêm ScaleType , SliceCenter và SliceScale .

TileSize

UDim2
Đọc Song Song

TileSize điều chỉnh kích thước thẻ của ImageLabel với một mức giá trị mặc định là Datatype.UDim2.new(1,

Mẫu mã

This code sample demonstrates the different ScaleType options - Stretch, Tile and Slice. It does this by resizing an ImageLabel/ImageButton in a circle.

Image ScaleType Demo
local imageLabel = script.Parent



-- Set the source image to be a 64x64 padlock

imageLabel.Image = "rbxassetid://284402752"

imageLabel.BackgroundTransparency = 0

imageLabel.BackgroundColor3 = Color3.new(1, 1, 1) -- White

imageLabel.ImageColor3 = Color3.new(0, 0, 0) -- Black



local function resizeInACircle()

	for theta = 0, 2, 0.02 do

		imageLabel.Size = UDim2.new(

			0,

			100 + math.cos(theta * 2 * math.pi) * 50,

			0,

			100 + math.sin(theta * 2 * math.pi) * 50

		)

		task.wait()

	end

end



while true do

	-- Stretch simply stretches the source image to fit

	-- the UI element's space

	imageLabel.ScaleType = Enum.ScaleType.Stretch

	resizeInACircle()

	-- Tile will render the source image multiple times

	-- enough to fill the UI element's space

	imageLabel.ScaleType = Enum.ScaleType.Tile

	imageLabel.TileSize = UDim2.new(0, 64, 0, 64)

	resizeInACircle()

	-- Slice will turn the image into a nine-slice UI.

	imageLabel.ScaleType = Enum.ScaleType.Slice

	imageLabel.SliceCenter = Rect.new(30, 30, 34, 34)

	resizeInACircle()

end
Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Phương Pháp

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object

Sự Kiện

Xem tất cả các mục kế thừa từ Instance
Xem tất cả các mục kế thừa từ Object