In this example a Tween is created to animate the position and color of a
Part. Because the position and color are part of the same tween, they will
change at the exact same rate and will reach their goal at the same time.

L'objet `Class.Tween` contrôle la lecture d'une interpolation.La création et la configuration d'un `Class.Tween` est effectuée avec la fonction `Class.TweenService:Create()` ; `Datatype.Instance.new()` ne peut pas être utilisée pour cet objet spécifique.

  Notez que bien que la configuration d'un tween puisse être accédée après la création d'un tween, il ne peut pas être modifié.Si de nouveaux objectifs sont nécessaires pour une interpolation, un nouveau `Class.Tween` doit être créé.

  Notez également que plusieurs adolescents peuvent être joués sur le même objet en même temps, mais ils ne doivent pas interpoler la même propriété.Si deux adolescents tentent de modifier la même propriété, le tween initial sera annulé et remplacé par le tween le plus récent.

Tween

This code sample includes a simple function that will return true if the
instance of a tween is a Part.

Cette propriété d'un `Class.Tween` (lecture seule) pointe vers le `Class.Instance` dont les propriétés sont interpolées.

Tween.Instance

Propriété de lecture seule qui pointe vers le `Class.Instance` dont les propriétés sont interpolées par le tween.

An example of the range of different interpolation effects that can be used in
Tweens.

Propriété de lecture seule qui inclut des informations sur la façon dont l'interpolation de la `Class.Tween` doit être effectuée, en utilisant le taperde données `Datatype.TweenInfo`.

Tween.TweenInfo

Propriété de lecture seule qui inclut des informations sur la manière dont l'interpolation de la `Class.Tween` doit être effectuée.

L'objet `Class.Tween` contrôle la lecture d'une interpolation.

Classe abstraite de base pour les gestionnaires d'interpolation entre lesquels ; classe parent de `Class.Tween`.

In this example the walkspeed of any player joining the game will be slowed to
0 over 10 seconds using a Tween. The Completed event is used to reset the
walkspeed after the Tween has finished playing.

This code sample includes a demonstration of tween conflict. A part is
instanced in the Workspace, and two tweens are created that attempt to move
the part in conflicting directions.

When both tweens are played, the first tween is cancelled and overwritten by
the second tween. This can be seen as the part moves along the Y axis as
opposed to the Z axis.

To further demonstrate this, connections have been made for both tweens to the
Tween.Completed event. Upon playing the tweens, the following is printed.

tween1: Enum.PlaybackState.Cancelled tween2: Enum.PlaybackState.Completed

These prints show that the first tween was cancelled (firing the Completed
event) immediately upon the second tween being played. The second tween then
went on to play until completion.

This code sample includes an example of how Tween.Completed can be used to
determine if a Tween has been successfully completed, or cancelled.

In this case a part is instanced and tweened towards 0, 0, 0. Once the tween
has completed, if the final PlaybackState is Completed then the part will
explode. Were the tween to be cancelled prior to completion, the explosion
would not be created.

This method can be used to link tweens to other effects, or even chain several
tweens to play after each other.

Se déclenche lorsque la nageoire adolescente finit de jouer ou lorsqu'elle est arrêtée avec `Class.TweenBase:Cancel()` .

  Passe le `Enum.PlaybackState` de l'adolescent à toutes les fonctions connectées pour donner une indication de pourquoi l'adolescent s'est terminé.Notez que l'appel de `Class.TweenBase:Pause()` ne déclenche pas l'événement `Completed`.

TweenBase.Completed

playbackState

Le `Enum.PlaybackState` de l'adolescent à la fin de l'exécution.

Se déclenche lorsque la nageoire adolescente finit de jouer ou lorsqu'elle est arrêtée avec `Class.TweenBase:Cancel()` .

Cet exemple montre l'impact de l'annulation d'un tween.

  Une partie est instancée dans l'espace de travail et un tween est configuré pour la déplacer le long de l'axe Y.A mi-chemin à travers l'adolescent, il est annulé.On peut observer ici que la partie ne revient pas à sa position d'origine, mais lorsqu'elle est reprise, elle prend toute la longueur du tween (5 secondes) pour se terminer.

  C'est la différence clé TweenBase:Pause() et TweenBase:Cancel().

Arrête la lecture d'un `Class.Tween` et réinitialise les variables d'adolescent.

  Ne réinitialise que les variables d'adolescent, pas les propriétés modifiées par l'adolescent.Si vous annulez un tween au milieu de son animations, les propriétés ne sont pas réinitialisées à leurs valeurs d'origine.Diffère de `Class.TweenBase:Pause()` en ce sens qu'une fois repris, il prend la durée complète de l'adolescent pour terminer l'animations.

TweenBase:Cancel

Arrête la lecture et réinitialise les variables d'adolescent.Si vous appelez ensuite `Class.TweenBase:Play()`, les propriétés de l'adolescent reprennent l'interpolation vers leur destination, mais prennent toute la longueur de l'animation pour le faire.

This sample demonstrates how the playback of a tween can be paused and
resumed.

A part is instanced in the Workspace and a tween is setup that will move it 50
studs along the X axis. However during playback the tween is briefly paused,
then resumed. To further illustrate this the BrickColor of the part changes
from red to green while it is paused.

Arrête la lecture du tween.Ne réinitialise pas ses variables de progression, ce qui signifie que si vous appelez `Class.TweenBase:Play()`, le préadolescent reprend le jeu à partir du moment où il a été interrompu.

  Si vous voulez réinitialiser les variables de progression du tween, utilisez `Class.TweenBase:Cancel()` .

  Vous ne pouvez suspendre que les adolescents qui se trouvent dans le `Class.TweenBase.PlaybackState|PlaybackState` de `Enum. PlaybackState.Playing` ; les adolescents dans d'autres états ne s'arrêteront pas.Si un adolescent est dans un autre `Class.TweenBase.PlaybackState|PlaybackState` tel que `Enum. PlaybackState.Delayed` (en raison de son `Datatype.TweenInfo.DelayTime` étant supérieur à 0), l'essai de pause du adolescent échouera et le adolescent jouera après son temps de pause spécifié.

TweenBase:Pause

Arrête la lecture du tween.Ne réinitialise pas ses variables de progression, ce qui signifie que si vous appelez `Class.TweenBase:Play()`, le préadolescent reprend le jeu à partir du moment où il a été interrompu.

Démarre la lecture d'un tween.Notez que si la lecture a déjà commencé, l'appel de `Play()` n'a aucun effet à moins que le pré-adolescent n'ait fini ou ne soit arrêté (par `Class.TweenBase:Cancel()` ou `Class.TweenBase:Pause()` ).

  Plusieurs adolescents peuvent être joués sur le même objet en même temps, mais ils ne doivent pas animer la même propriété.Si deux adolescents tentent de modifier la même propriété, le tween initial est annulé et remplacé par le tween le plus récent (voir exemples).

TweenBase:Play

Démarre la lecture d'un tween.Notez que si la lecture a déjà commencé, l'appel de `Play()` n'a aucun effet à moins que le pré-adolescent n'ait fini ou ne soit arrêté (par `Class.TweenBase:Cancel()` ou `Class.TweenBase:Pause()` ).

TweenBase

In this example a part is rotated by a Tween back and forth several times. The
TweenInfo in this case is configured to make the tween repeat twice after the
first playback and pause between each playback. A function is connected to
when the tween's PlaybackState changes. When run, this function will fire
whenever the tween starts, pauses between playback, and ends.

Propriété de lecture seule qui montre la phase actuelle pour l'animations`Class.Tween` .Voir `Enum.PlaybackState` pour les descriptions de chaque état.Changer en utilisant des fonctions comme `Class.Tween:Play()` .

TweenBase.PlaybackState

Propriété de lecture seule qui montre l'état actuel de l'animations`Class.Tween`.

Classe abstraite de base pour les gestionnaires d'interpolation entre lesquels. `Class.Tween` hérite de `Class.TweenBase`.

`Instance` est la classe de base pour toutes les classes dans la hiérarchie de classe Roblox qui peuvent faire partie de l'arbre `Class.DataModel`.

  Il n'est pas possible de créer directement des objets racine `Instance` , mais le constructeur spécial `Datatype.Instance.new()` crée des objets via du code, en prenant le nom de la classe en paramètre et en retournant l'objet créé.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

S'enflamme lorsque la propriété `Class.Instance.Parent` de l'objet ou l'une de ses ancêtres est modifiée.

  Cet événement inclut deux paramètres : `child` se réfère au `Class.Instance` dont le `Class.Instance.Parent` a été effectivement modifié, alors que `parent` se réfère au nouveau `Class.Instance.Parent` de cette instance.

  Vous pouvez utiliser cet événement pour suivre la suppression d'une instance dans Studio, comme la suppression manuelle dans l'Explorateur ou via un plugin.Si vous devez détecter quand une instance est détruite en utilisant `Class.Instance:Destroy()` , utilisez l'événement `Class.Instance.Destroying` à la place.

Instance.AncestryChanged

child

Le `Class.Instance` dont le `Class.Instance.Parent` a été modifié.

parent

Le nouveau `Class.Instance.Parent` de la `Class.Instance` dont le `Class.Instance.Parent` a été modifié.

S'enflamme lorsque la propriété `Class.Instance.Parent` de l'objet ou l'une de ses ancêtres est modifiée.

Cet événement se déclenche chaque fois que n'importe quel attribut est modifié sur l'instance, y compris lorsqu'un attribut est défini sur `nil`.Le nom de l'attribut modifié est transmis à la fonction connectée.

  Par exemple, le fragment de code suivant connecte la fonction `attributeChanged()` à tirer chaque fois que l'un des attributs de la partie change :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Voir aussi `Class.Instance:GetAttributeChangedSignal()` qui renvoie un événement qui se déclenche lorsqu'un attribut spécifique change.

Instance.AttributeChanged

attribute

Le nom de l'attribut qui a été modifié.

S'enflamme chaque fois qu'un attribut est modifié sur le `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Feux après qu'un objet soit parenté à ceci `Class.Instance` .

  Remarque, lors de l'utilisation de cette fonction sur un client pour détecter les objets créés par le serveur, il est nécessaire d'utiliser `Class.Instance:WaitForChild()` lors de l'indexation des descendants de cet objet.C'est parce que l'objet et ses descendants ne sont pas garantis de se répliquer simultanément du serveur au client.Par exemple :

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Notez que cette fonction ne fonctionne que pour les enfants immédiats du `Class.Instance` . Pour une fonction qui capture tous les descendants, utilisez `Class.Instance.DescendantAdded` .

  Voir aussi `Class.Instance.ChildRemoved` .

Instance.ChildAdded

Feux après qu'un objet soit parenté à ceci `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Feux après qu'un enfant a été retiré de ce `Class.Instance` .

  Supprimé fait référence au moment où le parent d'un objet est modifié de cette `Class.Instance` à quelque chose d'autre que ceci `Class.Instance` .Notez que cet événement se déclenchera également lorsqu'un enfant est détruit (en utilisant `Class.Instance:Destroy()` ) car la fonction destroy définira le parent d'un objet à `nil` .

  Cette fonction ne fonctionne que pour les enfants immédiats du `Class.Instance`. Pour une fonction qui capture tous les descendants, utilisez `Class.Instance.DescendantRemoving`.

  Voir aussi `Class.Instance.ChildAdded` .

Instance.ChildRemoved

Le `Class.Instance` qui a été supprimé.

Feux après qu'un enfant a été retiré de ce `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Cet événement se déclenche après l'ajout d'un descendant à la `Class.Instance`.

  Comme il tire pour chaque descendant, parenter un objet à la `Class.Instance` fera tirer l'événement pour cet objet et tous ses descendants individuellement.

  Si vous ne vous souciez que des enfants directs de la , utilisez à la place.

  Voir aussi `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Feux après qu'un descendant ait été ajouté à la `Class.Instance`.

The following example prints the name of any descendant as it is being removed
from the Workspace:

Cet événement se déclenche **immédiatement avant** que le parent `Class.Instance` de telle sorte qu'une instance **descendante** ne sera plus une descendante.`Class.Instance:Destroy()|Destroy()` change le `Class.Instance.Parent|Parent` d'une instance en `nil`, donc l'appel de cette méthode sur un descendant du parent provoquera le déclenchement de cet événement.

  Puisque cet événement se déclenche avant **la suppression du descendant, le parent du descendant sera inchangé au moment du déclenchement de cet événement** .Si le descendant est également un enfant direct du parent, cet événement se déclenchera avant .

  Si un descendant a des enfants, cet événement se déclenche d'abord avec le descendant, suivi de ses descendants.

  ##### Avertissement

  Cet événement se déclenche avec l'objet descendant qui est supprimé.Tenter de définir le `Class.Instance.Parent|Parent` du descendant sur autre chose échouera.Ci-dessous est un exemple qui montre cela :

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Voir aussi `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Le `Class.Instance` qui est en train d'être supprimé.

S'enflamme immédiatement avant que le descendant du `Class.Instance` soit supprimé.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

La `Class.Instance` ne sera jamais supprimée de la mémoire tant qu'une fonction connectée l'utilise encore.Cependant, si la fonction produit à tout moment, le `Class.Instance` et ses descendants seront parentés à `nil` .

  Si la propriété `Class.Workspace.SignalBehavior` est définie sur `Enum.SignalBehavior.Immediate`, cet événement se déclenche immédiatement avant que `Class.Instance` ou l'un de ses ancêtres ne soit détruit avec `Class.Instance:Destroy()` .

  Si la propriété `Class.Workspace.SignalBehavior` est définie sur `Enum.SignalBehavior.Deferred`, cet événement se déclenche au prochain point de reprise, qui sera après que le `Class.Instance` ou l'un de ses ancêtres a été détruit avec `Class.Instance:Destroy()` .

  Avec le comportement `Enum.SignalBehavior.Deferred|Deferred`, la connexion d'un script à son propre événement `Class.Instance.Destroying` est problématique, car le script sera détruit avant que le rappel puisse être appelé (ce qui signifie qu'il ne sera pas exécuté).

  Lors de la suppression d'un `Class.Instance` dans Studio, comme la suppression manuelle via le [Explorateur](/studio/explorer) ou via un plugin, le `Class.Instance` n'est pas détruit.Au lieu de cela, le parent est défini sur `nil` que vous pouvez suivre avec `Class.Instance.AncestryChanged` .

Instance.Destroying

Il se déclenche immédiatement avant (ou est reporté jusqu'à ce que) l'instance soit détruite via `Class.Instance:Destroy()` .

Cet événement se déclenche chaque fois que toute propriété de style est modifiée sur l'instance, y compris lorsque une propriété est définie sur `nil` .

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

Il se déclenche chaque fois que toute propriété de style est modifiée sur l'instance, y compris lorsqu'une propriété est définie sur `nil` .

Instance.childAdded

Cette méthode applique une balise à l'instance, sans effet si la balise est déjà appliquée.Ajouter avec succès une balise déclenchera un signal créé par `Class.CollectionService:GetInstanceAddedSignal()` avec la balise donnée.

  ##### Avertissements

  *   Les balises d'une instance qui ont été ajoutées côté client seront supprimées si le serveur ajoute ou supprime plus tard une balise sur cette instance car le serveur réplique toutes les balises ensemble et remplace les balises précédentes.

  *   Lors du marquage d'une instance, il est courant que certaines ressources soient utilisées pour donner au tag sa fonctionnalité, par exemple des connexions d'événements ou des tables.Pour empêcher les fuites de mémoire, il est une bonne idée de les nettoyer (débrancher, réinitialiser à `nil` , etc.) lorsqu'elles ne sont plus nécessaires pour une balise.Faites ceci lorsque vous appelez `Class.Instance:RemoveTag()`, appelez `Class.Instance:Destroy()` ou dans une fonction connectée à un signal retourné par `Class.CollectionService:GetInstanceRemovedSignal()` .

Instance:AddTag

Cette fonction détruit tous les enfants et les descendants d'une instance.

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  for i = 1, 3 do
  	local sparkles = Instance.new("Sparkles")
  	sparkles.Parent = part

    local sc = Instance.new("Sparkles")
    sc.Parent = sparkles
  end

  print("Children:", #part:GetChildren())  --> Children: 3

  part:ClearAllChildren()

  print("Children:", #part:GetChildren())  --> Children: 0
  ```

  Si vous ne souhaitez pas détruire **tous** les enfants et les descendants, utilisez `Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` pour parcourir ces enfants/descendants et sélectionnez ce que vous devez détruire.Par exemple, l'exemple de code suivant détruira tous les `Class.BasePart|BaseParts` descendant d'un `Class.Model` :

  ```
  local Workspace = game:GetService("Workspace")

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

Cette fonction détruit tous les enfants d'une instance.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` crée une copie d'une instance et de tous ses descendants, en ignorant toutes les instances qui ne sont pas `Class.Instance.Archivable|Archivable` .Une copie de l'instance racine est retournée par cette méthode et son `Class.Instance.Parent|Parent` est défini sur `nil` .Notez que si l'instance elle-même a `Class.Instance.Archivable|Archivable` définie à `false`, cette fonction retournera `nil` .

  Si une propriété de référence telle que `Class.ObjectValue.Value` est définie dans une instance clonée, la valeur de la propriété de la copie dépend de la valeur de l'original :

  *   Si une propriété de référence se réfère à une instance qui a été **également** clonée, la copie se référera à la copie.
  *   Si une propriété de référence se réfère à un objet qui n'a pas été **cloné** , la même valeur est maintenue dans la copie.

Instance:Clone

Créer une copie d'une instance et de tous ses descendants, en ignorant les instances qui ne sont pas `Class.Instance.Archivable|Archivable` .

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.

Définit la propriété `Class.Instance.Parent` à `nil`, verrouille la propriété `Class.Instance.Parent` et déconnecte toutes les connexions, puis appelle `Destroy()` sur tous les enfants.Cette fonction est la bonne façon de se débarrasser d'objets qui ne sont plus nécessaires.

  L'élimination des objets inutiles est importante, car les objets inutiles et les connexions dans un endroit utilisent la mémoire qui peut entraîner des problèmes de performance sérieux au fil du temps.

  En tant que meilleure pratique après avoir appelé `Destroy()` sur un objet, définissez toutes les variables qui font référence à l'objet (ou à ses descendants) à `nil` .Cela empêche votre code d'accéder à quoi que ce soit ayant à voir avec l'objet.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Ne faites pas cela :
  print(part.Name)  --> "Bonjour, monde"
  -- Faites ceci pour empêcher la ligne ci-dessus de fonctionner :
  part = nil
  ```

  Une fois qu'une `Class.Instance` a été détruite par cette méthode, elle ne peut pas être réutilisée car la propriété `Class.Instance.Parent` est verrouillée.Pour **temporairement** supprimer un objet au lieu de le détruire, définissez `Class.Instance.Parent|Parent` à `nil` .Par exemple :

  ```
  local Workspace = game:GetService("Workspace")

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Pour détruire un objet après un certain nombre de temps, utilisez `Class.Debris:AddItem()` .

Instance:Destroy

Définit la propriété `Class.Instance.Parent` à `nil`, verrouille la propriété `Class.Instance.Parent` et déconnecte toutes les connexions, puis appelle `Destroy()` sur tous les enfants.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Instance.Name` est égal au nom donné.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Le fragment de code suivant trouverait le premier ancêtre de l'objet nommé `Car` .

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Pour les variantes de cette fonction qui trouvent des ancêtres d'une classe spécifique, voir `Class.Instance:FindFirstAncestorOfClass()` et `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Instance.Name` est égal au nom donné.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Object.ClassName` est égal à la classe donnée.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Un usage commun de cette fonction est de trouver le appartient à. Par exemple :

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Cette fonction est une variante de `Class.Instance:FindFirstAncestor()` qui vérifie la propriété `Class.Object.ClassName` plutôt que `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` existe également, en utilisant la méthode `Class.Object:IsA()` au lieu de respecter l'héritage de classe.

Instance:FindFirstAncestorOfClass

className

Le `Class.Object.ClassName` à rechercher.

Renvoie le premier ancêtre du `Class.Instance` dont le `Class.Object.ClassName` est égal à la classe donnée.

Retourne le premier ancêtre du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

  Cette fonction fonctionne en aval, ce qui signifie qu'elle commence à l'instant immédiat de l'instance `Class.Instance.Parent` et fonctionne vers le `Class.DataModel`.Si aucun ancêtre correspondant n'est trouvé, il renvoie `nil` .

  Contrairement à `Class.Instance:FindFirstAncestorOfClass()`, cette fonction utilise `Class.Object:IsA()` qui respecte l'héritage de classe. Par exemple :

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  La suite du code suivante retournera donc le premier ancêtre , ou , indépendamment du fait qu'il s'agisse d'un , ou .

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  Voir aussi `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

Retourne le premier ancêtre du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

Ce qui suit rechercherait dans l'espace de travail un nom d'objet « Brick ». S'il est trouvé, il changerait le nom de l'objet en « Foo ».

Retourne le premier enfant du `Class.Instance` avec le nom donné, ou `nil` si aucun tel enfant n'existe.Si l'argument facultatif `recursive` optionnel est `true`, cette fonction recherche tous les descendants plutôt que les enfants immédiats du `Class.Instance`.

  ##### Vérification de l'existence d'un objet

  `FindFirstChild()` est nécessaire si vous devez vérifier qu'un objet existe avant de continuer.Tenter d'indexer un enfant par son nom en utilisant l'opérateur point provoque une erreur si l'enfant n'existe pas.

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Les erreurs suivantes se produisent si la partie n'existe pas dans l'espace de travail
  Workspace.Part.Transparency = 0.5
  ```

  Une meilleure approche consiste à utiliser `FindFirstChild()` pour vérifier d'abord `Part` , puis à utiliser une déclaration `if` pour exécuter du code qui en a besoin.

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace:FindFirstChild("Part")
  if part then
  	part.Transparency = 0.5
  end
  ```

  ##### Trouver un enfant dont le nom correspond à une propriété

  Parfois, le `Class.Instance.Name|Name` d'un objet est le même que celui d'une propriété de son `Class.Instance.Parent|Parent` .Lors de l'utilisation de l'opérateur point, les propriétés prennent le pas sur les enfants s'ils partagent un nom.

  Dans l'exemple suivant, un `Class.Folder` appelé `Color` est ajouté à un `Class.Part` qui a également la propriété `Class.Part.Color`.Remarquez que `part.Color` se réfère à la valeur de propriété `Datatype.Color3`, pas à l'instance enfant `Class.Folder`.Un avantage de l'utilisation de `Class.Instance:FindFirstChild()|FindFirstChild()` est que l'introduction de nouvelles propriétés n'impose pas de risque pour votre code.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- La propriété
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Notes de performances

  `Class.Instance:FindFirstChild()|FindFirstChild()` prend environ 20 % plus de temps que l'utilisation de l'opérateur point et presque 8 fois plus de temps que simplement le stockage d'une référence à un objet.Vous devez donc éviter de l'appeler dans du code dépendant de la performance, comme dans des boucles serrées ou des fonctions connectées à `Class.RunService.Heartbeat` et `Class.RunService.PreRender` .Au lieu de cela, stockez le résultat dans une variable, ou envisagez d'utiliser `Class.Instance.ChildAdded|ChildAdded` ou `Class.Instance:WaitForChild()|WaitForChild()` pour détecter quand un enfant d'un nom donné devient disponible.

Instance:FindFirstChild

recursive

Si la recherche doit être menée de manière récursive ou non.

Renvoie le premier enfant du `Class.Instance` trouvé avec le nom donné.

Retourne le premier enfant du `Class.Instance` dont le `Class.Object.ClassName|ClassName` est égal au donné `className` .Contrairement à `Class.Instance:FindFirstChildWhichIsA()` , cette fonction ne renvoie que des objets dont la classe correspond à `className` , en ignorant l'héritage de classe.Si aucun enfant correspondant n'est trouvé, cette fonction renvoie `nil` .

Instance:FindFirstChildOfClass

Retourne le premier enfant du `Class.Instance` dont le `Class.Object.ClassName|ClassName` est égal au nom de classe donné.

Retourne le premier enfant du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

  Si aucun enfant correspondant n'est trouvé, cette fonction renvoie `nil` .Si l'argument récursif facultatif est vrai, cette fonction recherche tous les descendants plutôt que les enfants immédiats de la `Class.Instance` .

  Contrairement à `Class.Instance:FindFirstChildOfClass()`, cette fonction utilise `Class.Object:IsA()` qui respecte l'héritage de classe. Par exemple :

  ```lua
  print(part:IsA("Part")) --> vrai
  print(part:IsA("BasePart")) --> vrai
  print(part:IsA("Instance")) --> true
  ```

  Par conséquent, l'exemple de code suivant retournera le premier enfant `Class.BasePart` , indépendamment du fait qu'il s'agisse d'un `Class.WedgePart` , `Class.MeshPart` ou `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Les développeurs qui recherchent un enfant par nom devraient utiliser `Class.Instance:FindFirstChild()` à la place.

Instance:FindFirstChildWhichIsA

Retourne le premier enfant du `Class.Instance` pour lequel `Class.Object:IsA()` renvoie vrai pour la classe donnée.

Renvoie le premier descendant trouvé avec le donné `Class.Instance.Name` .

  Cette méthode est désactivée et ne peut pas être utilisée.Pour trouver le premier descendant d'une instance, envisagez d'utiliser le paramètre `recursive` sur `Class.Instance:FindFirstChild()` à la place.

Instance:FindFirstDescendant

Renvoie le premier descendant trouvé avec le donné `Class.Instance.Name` .

Si le `Class.Instance` est un `Class.Actor`, le `Class.Actor` lui-même est renvoyé.Sinon, son ancêtre le plus proche `Class.Actor` est retourné.Si aucun ancêtre n'est un `Class.Actor` , le résultat est `nil` .

Instance:GetActor

Retourne le `Class.Actor` associé à l'instance, si nécessaire.

Cette méthode renvoie la valeur qui a été attribuée au nom d'attribut donné. Si aucun attribut n'a été attribué, `nil` est renvoyé.

  Par exemple, le fragment de code suivant définit puis obtient la valeur de l'attribut `InitialPosition` de l'instance :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local initialPosition = instance:GetAttribute("InitialPosition")
  print(initialPosition)
  ```

  ##### Voir aussi

  *   `Class.Instance:SetAttribute()` qui définit l'attribut avec le nom donné à la valeur donnée.
  *   `Class.Instance:GetAttributes()` qui renvoie un dictionnaire de paires clé-valeur pour chacun des attributs de l'instance.

Instance:GetAttribute

La valeur qui a été attribuée au nom d'attribut donné. Si aucun attribut n'a été attribué, `nil` est retournée.

Renvoie la valeur qui a été attribuée au nom d'attribut donné.

Cette fonction renvoie un événement qui se comporte exactement comme l'événement `Class.Object.Changed|Changed`, sauf qu'il ne se déclenche que lorsque l'attribut spécifique change ; efficacement, c'est similaire à `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` pour les attributs.

  Il est généralement une bonne idée d'utiliser cette méthode au lieu d'une connexion à `Class.Object.Changed|Changed` avec une fonction qui vérifie le nom de l'attribut.Les appels ultérieurs à cette méthode sur le même objet avec le même nom d'attribut retournent le même événement.

  L'exemple de code suivant renvoie un signal qui déclenche la fonction `attributeChanged()` lorsque l'attribut de la partie `InitialPosition` change :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Voir aussi `Class.Instance.AttributeChanged` qui se déclenche chaque fois que n'importe quel attribut est modifié sur l'instance.

Instance:GetAttributeChangedSignal

Le nom de l'attribut spécifié pour lequel le signal de changement est renvoyé.

Un événement qui se déclenche lorsque l'attribut donné change.

Renvoie un événement qui se déclenche lorsque l'attribut donné change.

Cette méthode renvoie un dictionnaire de paires clé-valeur pour chaque attribut où la clé est le nom de l'attribut et la valeur est une valeur non `nil` .

  Par exemple, le fragment de code suivant affiche les attributs et les valeurs d'une instance :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)
  part:SetAttribute("CanUse", true)

  for name, value in part:GetAttributes() do
  	print(name .. " = " .. value)
  end
  ```

  Voir aussi `Class.Instance:GetAttribute()` qui renvoie la valeur qui a été attribuée au nom d'attribut donné.

Instance:GetAttributes

Un dictionnaire de paires de chaîne → variantes pour chaque attribut où la chaîne est le nom de l'attribut et la variante est une valeur non nulle.

Renvoie un dictionnaire des attributs de l'instance.

The below would print the name of all objects currently in Workspace when ran.

Renvoie un tableau (une table numérotée) contenant tous les enfants directs de l'instance, ou chaque `Class.Instance` dont le `Class.Instance.Parent|Parent` est égal à l'objet.L'array peut être itérée en utilisant un boucle for numérique ou générique :

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Exemple de boucle for numérique
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Exemple générique de boucle while
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Les enfants sont triés par l'ordre dans lequel leur propriété `Class.Instance.Parent|Parent` a été définie à l'objet.

  Voir aussi la fonction `Class.Instance:GetDescendants()|GetDescendants`.

Instance:GetChildren

Un tableau contenant les enfants de l'instance.

Renvoie un tableau contenant tous les enfants de l'instance.

Renvoie une chaîne codée de l'ID de débogage utilisé internement par Roblox. Notez que :

  *   Cet élément est protégé. Tenter de l'utiliser dans un `Class.Script` ou `Class.LocalScript` provoquera une erreur.
  *   Un ID de débogage est un ID utilisé dans les processus de débogage.Il permet à un débogueur de lire chaque instruction avant qu'une application ne la traite.Tous les objets dans Roblox agissent comme des processus et chaque instruction d'exécution (ou «code») qui peut être débogée si nécessaire.
  *   Cela peut être utile pour les plugins qui doivent distinguer des objets similaires les uns des autres (tels que les objets qui partagent le même nom).

Instance:GetDebugId

scopeLength

Renvoie une chaîne codée de l'ID de débogage utilisé internement par Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Cette méthode d'objet renvoie une liste qui contient tous les descendants de cet objet.Contrairement à `Class.Instance:GetChildren()`, qui ne renvoie que les enfants immédiats d'un objet, cette méthode trouve chaque enfant de l'objet, chaque enfant de ces enfants, et ainsi de suite.

Instance:GetDescendants

Un tableau contenant les descendants de l'instance.

Renvoie un tableau contenant tous les descendants de l'instance.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Renvoie une chaîne décrivant l'ascendance de l'instance.La chaîne est une concaténation du `Class.Instance.Name|Name` de l'objet et de ses ancêtres, séparée par des périodes.Le `Class.DataModel` ( `game` ) n'est pas pris en compte.Par exemple, un `Class.Part` dans le `Class.Workspace` peut retourner `Class.Workspace.Part`.

  Lorsqu'on appelle sur un `Class.Instance` qui n'est pas un descendant du `Class.DataModel` , cette fonction prend en compte tous les ancêtres jusqu'à et y compris le plus ancien sans `Class.Instance.Parent|Parent` .

  Cette fonction est utile pour l'enregistrement et le débogage.Vous ne devriez pas essayer d'analyser la chaîne renvoyée pour toute opération utile ; cette fonction n'échappe pas les périodes (ou tout autre symbole) dans les noms d'objets.En d'autres termes, bien que son résultat semble souvent être un identifiant Luau valide, il n'est pas garanti.

Instance:GetFullName

Renvoie une chaîne décrivant l'ascendance de l'instance.

Cette méthode renvoie la valeur stylée ou explicitement modifiée de la propriété spécifiée, ou la valeur par défaut de la propriété si elle n'a pas été stylée/modifiée.Cela diffère légèrement de l'accès à la valeur de propriété directement, comme `[GuiObject].Rotation` , qui renvoie la valeur par défaut ou modifiée de la propriété.

  ```lua
  local Players = game:GetService("Players")
  local ReplicatedStorage = game:GetService("ReplicatedStorage")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")

  local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
  local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
  rule.Selector = "TextButton"

  -- Référence à un bouton
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (valeur par défaut)
  print(button.Rotation) --> 0 (valeur par défaut)

  -- Appliquer la rotation via la propriété règle de style
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (valeur stylée basée sur la règle)
  print(button.Rotation) --> 0 (valeur par défaut)

  -- Modifier/annuler explicitement la propriété style
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 ( valeur modifiée )
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

La valeur style ou explicitement modifiée de la propriété spécifiée, ou la valeur de propriété par défaut si elle n'a pas été style/modifiée.

Renvoie la valeur stylée ou explicitement modifiée de la propriété spécifiée, ou la valeur de propriété par défaut si elle n'a pas été stylée/modifiée.

Cette méthode renvoie un événement qui se comporte exactement comme l'événement `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, sauf qu'il ne se déclenche que lorsque la propriété de style donnée change.Il est généralement une bonne idée d'utiliser cette méthode au lieu d'une connexion à `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` avec une fonction qui vérifie le nom de propriété.Les appels ultérieurs à cette méthode sur le même objet avec le même nom de propriété retournent le même événement.

  Notez que cet événement ne passera aucun argument à une fonction connectée, la valeur de la propriété modifiée devant être lue directement dans un script.

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Style property changed!")
  end

  meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
  ```

Instance:GetStyledPropertyChangedSignal

property

Nom de la propriété de style pour laquelle écouter les modifications.

Événement qui se déclenche lorsque la propriété de style donnée change.

Cette méthode renvoie une liste des balises appliquées à l'instance donnée, en tant que chaînes.Vous pouvez ajouter des balises dans Studio dans la fenêtre [propriétés](/studio/properties) ou en temps d'exécution avec `Class.Instance:AddTag()|AddTag()` .

  Cette méthode est utile lorsque vous voulez faire quelque chose avec plusieurs balises sur une instance à la fois.Cependant, il est inefficace d'utiliser cette méthode pour vérifier l'existence d'une seule balise ; au lieu de cela, utilisez `Class.Instance:HasTag()|HasTag()` pour vérifier une balise spécifique.

Instance:GetTags

Obtient une liste de toutes les balises appliquées à l'instance.

Cette méthode renvoie `true` si la balise fournie a été ajoutée à l'objet.Vous pouvez ajouter des balises dans Studio dans la fenêtre [propriétés](/studio/properties) ou en temps d'exécution avec `Class.Instance:AddTag()|AddTag()` .

Instance:HasTag

Vérifiez si l'instance a une balise donnée.

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Renvoie vrai si un `Class.Instance` est un ancêtre du descendant donné.

  Un `Class.Instance` est considéré comme l'ancêtre d'un objet si la valeur `Class.Instance.Parent` ou une des valeurs de ses parents `Class.Instance.Parent` est définie sur `Class.Instance` .

  Voir aussi, `Class.Instance:IsDescendantOf()` .

Instance:IsAncestorOf

Vrai si le `Class.Instance` est un ancêtre du descendant donné.

Renvoie vrai si un `Class.Instance` est un ancêtre du descendant donné.

Renvoie `true` si un `Class.Instance` est un descendant de l'ancêtre donné.

  Notez que `IsDescendantOf()` ne peut pas être utilisé avec un paramètre de `nil` pour vérifier si un objet a été supprimé.

  Voir aussi `Class.Instance:IsAncestorOf()` .

Instance:IsDescendantOf

ancestor

Vrai si le `Class.Instance` est un descendant de l'ancêtre donné.

Renvoie `true` si un `Class.Instance` est un descendant de l'ancêtre donné.

Renvoie `true` si la valeur stockée dans la propriété spécifiée est égale au code instantané par défaut.Par exemple, si l'exportation de la propriété `Class.TextLabel.TextSize|TextSize` de un `Class.TextLabel` indique `8` , alors l'appel de `IsPropertyModified("TextSize")` sur l'étiquette retournera `false` car `8` est la valeur par défaut pour `Class.TextLabel.TextSize` lorsque l'étiquette est créée via `Instance.new("TextLabel")` plutôt que d'être insérée via les flux de travail d'insertion de Studio.

  Notez que si cette méthode renvoie , le style n'affectera pas la propriété car la modification explicite d'une propriété aura priorité sur le style.

Instance:IsPropertyModified

Booléen indiquant si la propriété est modifiée.

Renvoie `true` si la valeur stockée dans la propriété spécifiée est égale au code instantané par défaut.

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Cette fonction définit le `Class.Instance.Parent` de l'objet à `nil` et fait de même pour tous ses descendants.

  Si l'objet est référencé avant d'être supprimé, il est possible de récupérer l'objet à un point ultérieur.

Instance:Remove

Définit l'objet `Parent` à `nil` et fait de même pour tous ses descendants.

Cette méthode supprime une balise d'une instance.Il ne lancera pas d'erreur si l'objet n'a pas la balise.L'élimination réussie d'une balise déclenchera un signal créé par `Class.CollectionService:GetInstanceRemovedSignal()` avec la balise donnée.

  Notez que lorsque vous marquez une instance, il est courant que certaines ressources soient utilisées pour donner au tag sa fonctionnalité, par exemple des connexions d'événements ou des tables.Pour empêcher les fuites de mémoire, il est une bonne idée de les nettoyer (débrancher, réinitialiser à `nil` , etc.) lorsqu'elles ne sont plus nécessaires pour une balise.

Instance:RemoveTag

Réinitialise une propriété à sa valeur par défaut.Par exemple, appeler `ResetPropertyToDefault("Rotation")` sur un `Class.TextLabel` est équivalent à définir son `Class.TextLabel.Rotation|Rotation` à `0` (la valeur par défaut de la propriété).Cette méthode peut être utilisée pour garantir que le style annulera la valeur par défaut de cette propriété.

Instance:ResetPropertyToDefault

Réinitialise une propriété à sa valeur par défaut.

Cette méthode définit l'attribut avec le nom donné à la valeur donnée.Si la valeur donnée est `nil` , l'attribut sera supprimé, car `nil` est renvoyé par défaut.

  Par exemple, le fragment de code suivant définit l'attribut `InitialPosition` de l'instance à `Datatype.Vector3|Vector3.new(0, 10, 0)` :

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
  ```

  ##### Limites

  Exigences et restrictions de nomination :

  *   Les noms ne doivent utiliser que des caractères alphanumériques et un tiret.
  *   Aucun espace ou symbole unique n'est autorisé.
  *   Les chaînes doivent comporter 100 caractères ou moins.
  *   Les noms ne sont pas autorisés à commencer par **RBX** à moins que le déclencheur ne soit un script de noyau Roblox (réservé à Roblox).

  Lors de l'essai de définir une propriété à un type non pris en charge, une erreur sera lancée.

  ##### Voir aussi

  *   `Class.Instance:GetAttribute()` qui renvoie la valeur qui a été attribuée au nom d'attribut donné.
  *   `Class.Instance:GetAttributes()` qui renvoie un dictionnaire de paires clé-valeur pour chacun des attributs de l'instance.

Instance:SetAttribute

value

La valeur pour définir l'attribut spécifié.

Définit l'attribut avec le nom donné à la valeur donnée.

The following code waits for an instance named "Part" to be added to
Workspace.

Retourne l'enfant du `Class.Instance` avec le nom donné.Si l'enfant n'existe pas, il produira le thread actuel jusqu'à ce qu'il le fasse.Si le paramètre `timeOut` est spécifié, cette méthode expirera après le nombre spécifié de secondes et renverra `nil` .

  ##### Utilisation principale

  `Class.Instance:WaitForChild()|WaitForChild()` est extrêmement important lorsque vous travaillez sur du code exécuté par le client dans un `Class.LocalScript` .Le moteur Roblox ne garantit pas le temps ou l'ordre dans lequel les objets sont répliqués du serveur au client.De plus, si une expérience a `Class.Workspace.StreamingEnabled` définie sur vrai, `Class.BasePart|BaseParts` qui sont loin du personnage du joueur peuvent ne pas être diffusées au client, ce qui peut potentiellement provoquer des échecs de scripts lors de l'indexation des objets qui n'existent pas encore sur le client.

  ##### Notations

  *   Cette fonction ne renvoie pas si un enfant avec le nom donné existe lorsque l'appel est fait.
  *   `Class.Instance:FindFirstChild()` est une alternative plus efficace à `Class.Instance:WaitForChild()|WaitForChild()` pour les objets qui sont supposés exister.
  *   Si un appel à cette méthode dépasse 5 secondes sans retour et qu'aucun paramètre `timeOut` n'a été spécifié, un avertissement sera imprimé dans la sortie que le thread peut produire indéfiniment.

Instance:WaitForChild

Retourne l'enfant du `Class.Instance` avec le nom donné. S'il n'existe pas, il produira le thread actuel jusqu'à ce qu'il le fasse.

Instance

`Instance` est la classe de base pour toutes les classes dans la hiérarchie de classe Roblox qui peuvent faire partie de l'arbre `Class.DataModel`.

Tween

Échantillons de code

Résumé

Propriétés

Propriétés

Méthodes

Méthodes

Événements

Événements

Propriétés

Méthodes

Événements