定義覆蓋受 Selector 屬性影響的實例的屬性的風格特性。
概要
屬性
一個數字，決定如何使 StyleRule 的屬性相對於其他 StyleRules 的相同屬性應用。優先級更高的值會取代更低的值。
一個字串指定哪些實例應受到 StyleRule 的影響。
一個只讀的字串，顯示來自 Selector 屬性的錯誤。
方法
返回描述 StyleRule 屬性的鑰匙值對陣典字典。
在 StyleRule 中返回特定屬性的值。
讓你一次宣言並設定多個 StyleRule 的屬性。
返回一個相關的 StyleRules 陣列。
插入新的 StyleRule 到規則陣列中。
與 InsertStyleRule() 相似，但可讓您一次宣言並設置多個 StyleRules。
屬性
Priority
一個數字，決定如何使 StyleRule 的屬性相對於其他 StyleRules 的相同屬性應用。優先級更高的值會取代更低的值。例如，如果一個具有優先級 的 與 屬性的 具有 屬性，它將取代低優先級的 具有 屬性。
Selector
一個字串指定哪些實例應受到 StyleRule 的影響。這可能是選擇器和組合器的混合物，用於匹配特性，例如類別名稱、實例名稱和層級關係。
例如， 有效地意味著風格規則會覆蓋每個 被標記為具有 （ > ） 和 被標記為具有 > （ > ） 的子標籤（ > ），而且 和 處於 > 狀態（ > ）。
選擇器
| 選擇器 |
|---|
組合器
| 組合器 |
|---|
範例程式碼
The following example shows how to define a class selector which targets all TextButton instances and styles them with blue background and light grey text. To test, paste the code into a LocalScript which is a child of a ScreenGui located inside the StarterGui container.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local screenGui = script.Parent
local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet
-- Class selector
rule.Selector = "TextButton"
-- Set rule properties
rule:SetProperties({
["BackgroundColor3"] = Color3.fromHex("335FFF"),
["TextColor3"] = Color3.fromHex("E1E1E1"),
["Size"] = UDim2.new(0.15, 0, 0, 40),
["BorderSizePixel"] = 0
})
local button = Instance.new("TextButton")
button.Text = "Main Menu"
button.Parent = screenGuiThe following example shows how to define a tag selector which utilizes tags applied through CollectionService to target a TextButton tagged with ButtonPrimary. To test, paste the code into a LocalScript which is a child of a ScreenGui located inside the StarterGui container.
local CollectionService = game:GetService("CollectionService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local screenGui = script.Parent
local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet
-- Tag selector
rule.Selector = ".ButtonPrimary"
-- Set rule properties
rule:SetProperties({
["BackgroundColor3"] = Color3.fromHex("FF0099"),
["TextColor3"] = Color3.fromHex("E1E1E1"),
["Size"] = UDim2.new(0.15, 0, 0, 40),
["BorderSizePixel"] = 0
})
local button = Instance.new("TextButton")
button.Text = "Main Menu"
button.Parent = screenGui
-- Apply tag to button
CollectionService:AddTag(button, "ButtonPrimary")The following example shows how to define a UI modifier selector which applies a phantom UICorner instance to a Frame tagged with RoundedCorner20. To test, paste the code into a LocalScript which is a child of a ScreenGui located inside the StarterGui container.
local CollectionService = game:GetService("CollectionService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local screenGui = script.Parent
local coreSheet = Instance.new("StyleSheet")
coreSheet.Parent = ReplicatedStorage
local styleLink = Instance.new("StyleLink")
styleLink.StyleSheet = coreSheet
styleLink.Parent = screenGui
local rule = Instance.new("StyleRule")
rule.Parent = coreSheet
-- UI component selector
rule.Selector = "Frame.RoundedCorner20::UICorner"
-- Set rule property
rule:SetProperty("CornerRadius", UDim.new(0, 20))
-- Create frame
local frame = Instance.new("Frame")
frame.Size = UDim2.new(0.4, 0, 0.2, 0)
frame.Parent = screenGui
-- Apply tag to frame
CollectionService:AddTag(frame, "RoundedCorner20")方法
GetProperties
返回一個包含鑰匙值對描述 StyleRule 特性的字典，例如：
返回
鑰匙值對描述 StyleRule 的屬性的字典。
GetProperty
在 StyleRule 中返回特定屬性的值。
參數
屬性名稱，例如 "AnchorPoint" 或 "BackgroundColor3" 。
返回
屬性的值。
SetProperties
與 SetProperty() 相似，但可讓您一次宣言並設置多個 StyleRule 的屬性。每個任務應該是受影響的 GuiObject 或 UIComponent ( UICorner , UIGradient ,等)的有效屬性,每個指定值應該匹配其屬性值類型,例如 Vector2 對於 AnchorPoint 或 Color3 對於 BackgroundColor3 。
嘗試指定無效的屬性名稱，例如 "AnchorPt" 或 "BkColor" 將無聲失敗。輸入不匹配類型，例如 CFrame 對於 AnchorPoint 或 UDim2 對於 BackgroundColor3 也會失敗，並且在 輸出窗口 中會出現錯誤。
若要設置或更新 StyleRule 的單一屬性，請參閱 SetProperty() 。
請注意，您可以通過 $ 前缀將 代幣 指定為屬性值：
參數
定義要設置的屬性的鑰值對字典。
返回
SetProperty
為 StyleRule 設置新屬性 (或修改現有屬性)。參數 name 應為受影響的 GuiObject 或 UIComponent ( UICorner , UIGradient ,等) 的有效屬性，並應與屬性值類型匹配,例如 Vector2 對於 AnchorPoint 或 Color3 對於 BackgroundColor3 。
嘗試指定無效的屬性名稱，例如 "AnchorPt" 或 "BkColor" 將無聲失敗。輸入不匹配類型，例如 CFrame 對於 AnchorPoint 或 UDim2 對於 BackgroundColor3 也會失敗，並且在 輸出窗口 中會出現錯誤。
要一次設置多個屬性給 StyleRule ，請參閱 SetProperties()。
請注意，您可以通過 $ 前缀將 代幣 指定為屬性值：
參數
要設置的屬性名稱，例如 "BackgroundColor3"。
要設置的屬性值，例如 Color3.new(1, 0, 0.25) 。