StringValue
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Un StringValue est un objet dont le but est de stocker un seul Lua string . La longueur de la chaîne ne peut pas être plus de 200 000 caractères (cela provoquera une erreur «String too long»). Comme tous les objets «StringValue», cette chaîne unique est stockée dans la propriété Value. L'événement Changed pour ceci (et d'autres objets comme lui) se déclenchera avec la nouvelle valeur stock
Si la chaîne est trop longue pour être affichée dans le champ de valeur dans la fenêtre propriétés, elle affichera partiellement le contenu de la chaîne suivi d'un tiret (...).
Échantillons de code
-- 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"Propriétés
Méthodes
Évènements
Changed
Tiré chaque fois que la valeur StringValue.Value du StringValue est modifiée. Il s'exécutera avec la nouvelle valeur stockée dans l'objet d'argument, au lieu d'une chaîne représentant la propriété modifiée.
Cet événement, comme d'autres événements modifiés, peut être utilisé pour suivre quand une valeur de chaîne change et pour suivre les différentes valeurs que elle peut changer.
Par instance, cela peut être utile dans les jeux qui utilisent les valeurs de chaîne pour suivre des valeurs telles que le nom d'un PNJ ou d'un élément.
Des événements équivalents existent pour des objets similaires, tels que NumberValue et BoolValue, en fonction du type d'objet qui convient le mieux au besoin.
Paramètres
La nouvelle valeur après le changement.
Échantillons de code
local value = Instance.new("StringValue")
value.Parent = workspace
value.Changed:Connect(function(NewValue)
print(NewValue)
end)
value.Value = "Hello world!"