StringValue

Afficher les obsolètes

*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

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"

Propriétés

Value

Lecture parallèle

La chaîne stockée .

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

value: string

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

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