Instance

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.

Le type de données Instance conserve les constructeurs pour Instance les objets.

Résumé

Constructeurs

Constructeurs

new

Crée un nouveau Instance de type className . Les classes et services abstraits ne peuvent pas être créés avec ce constructeur.

Notez que lorsque le Parent d'un objet est configurer, Luau écoute une variété de modifications de propriétés différentes pour la réplication, le rendu et la physique.Pour des raisons de performance, il est recommandé de définir la propriété Parent de l'instance dernière lors de la création de nouveaux objets, au lieu d'indiquer le deuxième argument ( parent ) de ce constructeur.


local Workspace = game:GetService("Workspace")
-- Définir le parent de la nouvelle instance en dernier (recommandé)
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Parent = Workspace
-- Définir le parent de la nouvelle instance dans le constructeur (déconseillé)
local part = Instance.new("Part", Workspace)
part.Position = Vector3.new(0, 10, 0)

Paramètres

className: string

Nom de classe de la nouvelle instance à créer.

parent: Instance

Objet facultatif pour parent la nouvelle instance. Non recommandé pour des raisons de performance (voir description ci-dessus).

fromExisting

Crée un nouvel objet avec les mêmes valeurs de type et de propriété qu'un objet existant.Dans la plupart des cas, l'utilisation de Instance:Clone() est plus appropriée, mais ce constructeur est utile lors de l'implémentation de bibliothèques ou de systèmes de bas niveau.

Il y a deux différences comportementales entre ce constructeur et la méthode Instance:Clone() :

  • Ce constructeur ne copiera aucun des descendants Instances parentés à l'objet existant.

  • Ce constructeur retournera un nouvel objet même si l'objet existant avait Instance.Archivable défini à false .

Paramètres

existingInstance: Instance

L'existant Instance pour copier les valeurs de propriété.