StringValue
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Une valeur de chaîne est un objet dont le but est de stocker une seule chaîne Luau.La longueur de la chaîne ne peut pas être supérieure à 200 000 caractères (cela provoquera une erreur "Chaîne trop longue").Comme tous les objets "-Value", cette seule valeur est stockée dans la propriété valeur.L'événement modifié pour cela (et d'autres objets comme celui-ci) se déclenchera avec la nouvelle valeur stockée dans l'objet, au lieu d'une chaîne représentant la propriété modifiée.
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'une ellipse (...).
Échantillons de code
Cet exemple montre les subtilités de l'événement modifié sur les objets normaux et les objets "-Value".
-- Démontrer l'événement modifié en créant une partie
local part = Instance.new("Part")
part.Changed:Connect(print)
-- Cela déclenche Changed avec "Transparence"
part.Transparency = 0.5
-- De même, cela déclenche Changed avec "Number"
part.Name = "SomePart"
-- Comme le changement de la couleur de brique va également changer d'autres
-- propriétés en même temps, cette ligne déclenche Changed
-- avec "BrickColor", "Color3" et "Color3uint16".
part.BrickColor = BrickColor.Red()
-- Une valeur numérique contient un nombre à double précision de point flottant
local vNumber = Instance.new("NumberValue")
vNumber.Changed:Connect(print)
-- Cela déclenche Changed avec 123.456 (pas « Valeur »)
vNumber.Value = 123.456
-- Cela ne déclenche pas Changed
vNumber.Name = "SomeNumber"
-- Une valeur de chaîne stocke une chaîne
local vString = Instance.new("StringValue")
vString.Changed:Connect(print)
-- Cela déclenche Changed avec "Hello" (pas "Value")
vString.Value = "Hello"Propriétés
Méthodes
Évènements
Changed
Tiré chaque fois que le StringValue.Value du StringValue est modifié.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 StringValue change et pour suivre les différentes valeurs qu'elle peut changer.
Par instance, cela peut être utile dans les jeux qui comptent sur des valeurs StringValues pour suivre des valeurs telles que les NPC ou les noms d'objets.
Des événements équivalents modifiés existent pour des objets similaires, tels que NumberValue et BoolValue, en fonction du type d'objet qui convient le mieux aux besoins.
Paramètres
La nouvelle valeur après le changement.
Échantillons de code
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!".
local value = Instance.new("StringValue")
value.Parent = workspace
value.Changed:Connect(function(NewValue)
print(NewValue)
end)
value.Value = "Hello world!"