一個 StringValue 是一個用於儲存單個 Luau 字串 的目標的對象。字串長度不能超過 200,000 個字元 (這會導致「字串過長」錯誤)。像所有 "-Value" 對象一樣,這個單值存儲在價值屬性中。對於這個 (以及其他像它一樣的對象) 所做的更改事件將使用新值存儲在對物件中,而不是使用代表被更改的屬性的字串。
如果字串過長以至於無法在屬性窗戶中的值欄中顯示,它將顯示一部分字串內容,以及一個 ellipsis(...)。
範例程式碼
這個範例展示了普通對象和 "-Value" 對象上變更事件的微妙。
已變更的事件
-- 透過創建零件來展示更改的事件
local part = Instance.new("Part")
part.Changed:Connect(print)
-- 這會發射「透明」變更
part.Transparency = 0.5
-- 相同地,這會發射「數字」變更
part.Name = "SomePart"
-- 因為變更磚塊顏色也會改變其他
-- 在同一時間屬性,此行發射變更
-- 使用「BrickColor」、「Color3」和「Color3uint16」。
part.BrickColor = BrickColor.Red()
-- 數值包含雙精度浮點數字
local vNumber = Instance.new("NumberValue")
vNumber.Changed:Connect(print)
-- 這會發射變更為 123.456(不是「值」)
vNumber.Value = 123.456
-- 這不會發射變更的
vNumber.Name = "SomeNumber"
-- 一個 StringValue 儲存一個字串
local vString = Instance.new("StringValue")
vString.Changed:Connect(print)
-- 這會發射「Hello」而不是「Value」進行變更
vString.Value = "Hello"
概要
活動
每當 StringValue.Value 被更改時發射。
屬性
方法
活動
Changed
每當 StringValue.Value 的 StringValue 被更改時,都會發射。它將使用新值存儲在參數對物件中,而不是代表正在變更的屬性的字串。
這個事件,像其他已變更的事件一樣,可以用來跟蹤當 StringValue 變更時以及可能變更的不同值。
例個體、實例,這可能對依賴 StringValues 來跟蹤值,例如 NPC 或物品名稱的遊戲有用。
相同類型的變更事件存在於類似物件,例如 NumberValue 和 BoolValue,取決於哪種物件類型最適合需求。
參數
變更後的新值。
範例程式碼
The below example, assuming all referenced objects existed, would print the StringValue's new value each time it changed. In the example below it would print "Hello world!".
How to Use StringValue.Changed
local value = Instance.new("StringValue")
value.Parent = workspace
value.Changed:Connect(function(NewValue)
print(NewValue)
end)
value.Value = "Hello world!"