StringValue

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

StringValue は、単一の Luau 文字列 を保存する目的のオブジェクトです。文字列の長さは 200,000 文字を超えることはできません (「文字列が長すぎる」エラーが発生します)。すべての "-Value" オブジェクトと同様、この単一の値は値プロパティに保存されます。この (およびそれと同様の他のオブジェクト) の変更されたイベントは、プロパティが変更されていることを示すストリングではなく、オブジェクトに新しい値が保存されて発射します。

文字列がプロパティウィンドウの値フィールドに表示されるのに十分長すぎる場合、文字列のコンテンツを省略して(...)で示すことがあります。

コードサンプル

This sample demonstrates the subtleties of the Changed event on normal objects and "-Value" objects.

Changed Event

-- Demonstrate the Changed event by creating a Part
local part = Instance.new("Part")
part.Changed:Connect(print)
-- This fires Changed with "Transparency"
part.Transparency = 0.5
-- Similarly, this fires Changed with "Number"
part.Name = "SomePart"
-- Since changing BrickColor will also change other
-- properties at the same time, this line fires Changed
-- with "BrickColor", "Color3" and "Color3uint16".
part.BrickColor = BrickColor.Red()
-- A NumberValue holds a double-precision floating-point number
local vNumber = Instance.new("NumberValue")
vNumber.Changed:Connect(print)
-- This fires Changed with 123.456 (not "Value")
vNumber.Value = 123.456
-- This does not fire Changed
vNumber.Name = "SomeNumber"
-- A StringValue stores one string
local vString = Instance.new("StringValue")
vString.Changed:Connect(print)
-- This fires Changed with "Hello" (not "Value")
vString.Value = "Hello"

プロパティ

Value

並列読み取り

保存された 文字列

方法

イベント

Changed

発射されるのは、StringValue.ValueStringValue が変更されたときです。新しい値が引数オブジェクトに保存される代わりに、変更されるプロパティを表すストリングではなく、新しい値が引数オブジェクトで実行されます。

このイベントは、他の変更されたイベントと同様、変更された時刻を追跡し、変更される可能性のある異なる値を追跡することができます。

たとえば、NPC またはアイテム名のような値を追跡するゲームでは、これが役に立つかもしれません。

同等の変更イベントは、NumberValueBoolValue など、必要に最適なオブジェクトタイプによって異なります。

パラメータ

value: string

変更後の新しい値。


コードサンプル

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!"