ImageLabel
*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
Nội dung hình ảnh hiển thị bởi thành phần UI. Đọc và viết vào ImageContent .
Xác định cách màu sắc hình ảnh được tạo.
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 .
Số lệch trong pixel của khu vực dưới đấy của hình ảnh để hiển thị.
Xác định kích thước trong pixel của khu vực hình ảnh để được hiển thị.
Xác định độ trong suốt của hình ảnh đã tạo.
Chỉ ra nếu hình ảnh đã tải xong từ Roblox.
Chọn chế độ điều chỉnh hình ảnh cho nhãn.
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.
Đặt giới hạn cắt của hình ảnh 9-sliced.
Tăng 9 cạnh mép bằng tỷ lệ được xác định.
Điều chỉnh kích thước thẻ hiển thị của hình ảnh.
Xác định whether this UI element sinks input.
Xác định điểm nguồn của một GuiObject , so với kích thước tương đối của nó.
Xác định xem resize có xảy ra dựa trên nội dung con hay không.
Xác định màu nền GuiObject .
Xác định độ trong suốt của GuiObject hình ảnh và biên giới.
Xác định màu của GuiObject border.
Xác định cách mà GuiObject biên giới được phân bố đối với kích thước của nó.
Xác định chiều rộng pixel của GuiObject biên giới.
Xác định nếu con cháu GuiObjects nằm ngoài giới hạn của một thành phần GUI cha mẹ nên tạo ra.
Xác định apakah chuột của người chơi đang được nhấn chủ động trên GuiObject hay không.
Xác định có thể hay không tương tác với GuiButton , hoặc liệu GuiState của GuiObject đang thay đổi hay không.
Điều khiển thứ tự sắp xếp của GuiObject khi được sử dụng với một UIGridStyleLayout .
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển xuống.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang bên trái.
Điều chỉnh GuiObject được chọn khi gamepad selector được di chuyển sang phải.
Điều chỉnh GuiObject được chọn khi gamepad selector di chuyển lên trên.
Xác định vị trí pixel và vị trí trục của GuiObject .
Xác định số độ bằng mà GuiObject được quay.
Xác định có thể chọn GUI bằng gamepad.
Làm cho trang trí chọn mặc định của gamepad bị tắt.
Thứ tự của GuiObjects được chọn bởi gamepad UI lựa chọn.
Xác định kích thước pixel và kích thước trục của GuiObject .
Điều chỉnh các trục Size mà GuiObject sẽ dựa trên, so với kích thước của cha mình.
Một tính chất hỗn hợp của BackgroundTransparency và TextTransparency .
Xác định có phải GuiObject và con cháu của nó sẽ được xử lý.
Xác định thứ tự mà một GuiObject tạo gần những người khác.
Mô tả vị trí màn hình thực tế của một thành phần UI, bằng cách đếm các pixel.
Mô tả sự quay màn hình thực tế của một thành phần UI, bằng độ.
Mô tả kích thước màn hình thực tế của một thành phần UI, bằng các pixel.
Khi đặt về true, localization sẽ được áp dụng cho GuiBase2d và những con cháu của nó.
Một tham khảo đến một LocalizationTable để ứng dụng hóa học hóa toàn bộ vào GuiBase2d và các con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng dưới.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad ở hướng phải.
Tùy chỉnh hành vi lựa chọn gamepad trong hướng lên.
Cho phép tùy chỉnh chuyển động của nút gamepad.
Phương Pháp
Phương Pháp kế thừa từ GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI mượt mà đến một new UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Điều chỉnh mượt mà một GUI lên một new Datatype.UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Di chuyển một GUI một cách mượt mà đến kích thước và vị trí mới.
Sự Kiện
Sự Kiện kế thừa từ GuiObjectĐược kích hoạt khi một người bắt đầu tương tác thông qua một thiết bị giao tiếp người-máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.v).
Bị kích động khi một người thay đổi cách họ tương tác thông qua thiết bị giao tiếp Người-Máy (chuột, bắt đầu, nhấn bàn phím, v.v..).
Đã kết thúc khi một người dừng tương tác thông qua thiết bị Giao tiếp Người-Máy (chuột bên dưới, chạm bắt đầu, nút bàn phím xuống, v.v.);.
Bắt đầu khi người dùng di chuyển chuột vào một thành phần GUI.
Bắt đầu khi người dùng di chuyển chuột khỏi một thành phần GUI.
Bắt lửa mỗi khi một người dịch chuột trong khi nó ở trong một thành phần GUI.
Bắt đầu khi người dùng cuộn chuột chuột của họ trở lại khi chuột đang ở trên một thành phần GUI.
Bắt đầu khi người dùng di chuyển bánh xe chuột của họ khi chuột ở trên một thành phần GUI.
Được kích hoạt khi GuiObject đang được tập trung với GamepadSelector.
Bị kích hoạt khi GamepadSelector ngưng tập trung vào GuiObject.
Lửa khi người chơi bắt đầu, tiếp tục và dừng lại sau khi nhấn mạnh UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi di chuyển ngón tay của họ trên thành phần UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt lửa khi người chơi thực hiện một hành động nhấn hoặc kéo dùng hai ngón tay trên thành phần UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Bắt đầu khi người chơi thực hiện một hành động quay bằng hai ngón tay trên thành phần UI.
Bắt đầu khi người chơi thực hiện một động tác trượt tuyết trên một thành phần UI.
Bắt đầu khi người chơi thực hiện một hành động nhấn chuột trên thành phần UI.
- 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.
Thuộc Tính
Image
Đâ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
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
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
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
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
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ã
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
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ã
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
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
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
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
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
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ã
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