`Class.BillboardGui` est un conteneur pour les objets UI qui apparaissent dans l'espace 3D
mais font toujours face à la caméra. La position du conteneur est relative à la partie
parent `Class.BasePart` ou `Class.Attachment` (ou au
`Class.BillboardGui.Adornee|Adornee`). Pour les `Class.BasePart|BaseParts`, la
propriété `Class.BasePart.Position|Position` est utilisée, tandis que pour
les `Class.Attachment|Attachments`, la
propriété `Class.Attachment.WorldPosition|WorldPosition` est utilisée.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui avec un TextLabel décrivant la console de l'écran au-dessus de laquelle elle flotte." />

La propriété `Class.BillboardGui.Size|Size` d'un panneau fonctionne légèrement
différemment de `Class.GuiObject.Size`. Alors que les composants **offset** fonctionnent de la même manière, les composants **scale** sont utilisés comme tailles de studs dans l'espace 3D.

Lors de la création d'un `Class.BillboardGui` à taille échelonnée qui contient un
`Class.TextLabel`, il est utile d'activer la propriété `Class.TextLabel.TextScaled|TextScaled` de l'étiquette afin que son texte soit mis à l'échelle avec le canevas du panneau à mesure que la distance de la caméra change.

Notez que les éléments UI interactifs comme les `Class.ImageButton|ImageButtons` et
`Class.TextButton|TextButtons` à l'intérieur d'un `Class.BillboardGui` ne recevront l'entrée utilisateur que s'ils sont parentés au `Class.PlayerGui`, généralement en plaçant le `Class.BillboardGui` à l'intérieur de `Class.StarterGui`. La
propriété `Class.BillboardGui.Adornee|Adornee` peut être utilisée pour cibler une partie ou
une attache dans le monde 3D, tandis que le `Class.BillboardGui` reste dans
le `Class.PlayerGui`.

Consultez [UI en expérience](/ui/in-experience-containers#billboard-ui)
pour un guide sur le travail avec les conteneurs `Class.BillboardGui`.

##### Comportement de mise en cache

Pour améliorer les performances, l'apparence d'un `Class.BillboardGui` est
mise en cache jusqu'à ce que l'un des événements suivants se produise, après quoi son apparence sera
recalculée lors de la prochaine image de rendu.

- Un descendant est ajouté ou retiré du `Class.BillboardGui`.
- Une propriété d'un descendant du `Class.BillboardGui` change.
- Une propriété du `Class.BillboardGui` lui-même change.


BillboardGui

Contrôle si les descendants recevront des événements d'entrée. Si le
`Class.BillboardGui` contient un `Class.GuiButton`, ce bouton deviendra
cliquable uniquement si `Class.BillboardGui.Active|Active` est défini sur `true` tant sur
le `Class.BillboardGui` **que** sur le bouton.

Notez que les éléments UI interactifs comme les `Class.ImageButton|ImageButtons`
et `Class.TextButton|TextButtons` à l'intérieur d'un `Class.BillboardGui` ne recevront
l'entrée utilisateur que s'ils sont parentés au `Class.PlayerGui`, généralement en plaçant le `Class.BillboardGui` à l'intérieur de `Class.StarterGui`.
La propriété `Class.BillboardGui.Adornee|Adornee` peut être utilisée pour cibler une
partie ou une attache dans le monde 3D, tandis que le `Class.BillboardGui` lui-même
reste dans le `Class.PlayerGui`.


BillboardGui.Active

Contrôle si les descendants recevront des événements d'entrée.


Définit la `Class.BasePart` ou `Class.Attachment` cible par rapport à laquelle le
`Class.BillboardGui` est positionné, remplaçant la partie parent
ou l'attache.


BillboardGui.Adornee

Définit la partie ou l'attache cible par rapport à laquelle le `Class.BillboardGui` est
positionné.


Cette propriété détermine si le `Class.BillboardGui` sera toujours
rendu au-dessus des autres objets 3D.

Lorsqu'elle est définie sur `false` (par défaut), le `Class.BillboardGui` est rendu comme d'autres
informations 3D et est obstrué par d'autres objets 3D. Lorsqu'elle est définie sur `true`, le
`Class.BillboardGui` est toujours rendu au-dessus du contenu 3D, et l'apparence change de manière significative :

- Les couleurs correspondent à leur apparence dans un `Class.ScreenGui`.
- Le texte peut apparaître plus net sur les appareils à haute DPI.
- `Class.BillboardGui.LightInfluence|LightInfluence` est traité comme s'il était `0`.
- `Class.BillboardGui.Brightness|Brightness` n'a aucun effet.


BillboardGui.AlwaysOnTop

Détermine si le `Class.BillboardGui` sera toujours rendu au-dessus des autres objets 3D.


Cette propriété détermine le facteur par lequel la lumière du\conteneur `Class.BillboardGui` est mise à l'échelle lorsque
`Class.BillboardGui.LightInfluence|LightInfluence` est `0`. Par défaut,
ceci est `1` et peut être défini sur n'importe quel nombre entre `0` et `1000`.
En modifiant cette propriété, la luminosité apparente d'un
`Class.BillboardGui` peut être mieux assortie à son environnement. Par
exemple, un panneau vidéo peut être éclairci à l'intérieur d'une pièce sombre en
augmentant `Class.BillboardGui.Brightness|Brightness` à `10`.

Notez que `Class.BillboardGui.Brightness|Brightness` est inaccessible dans
Studio et n'a aucun effet lorsque soit
`Class.BillboardGui.LightInfluence|LightInfluence` est `1`, soit
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` est `true`.


BillboardGui.Brightness

Détermine le facteur par lequel la lumière du conteneur `Class.BillboardGui` est mise à l'échelle lorsque
`Class.BillboardGui.LightInfluence|LightInfluence` est `0`.


Lorsqu'elle est définie sur `true` (par défaut), les portions de `Class.GuiObject|GuiObjects`
qui tombent en dehors des bords du canevas `Class.BillboardGui` ne seront pas
dessinées.

Même lorsque cette propriété est `false`, les `Class.GuiObject|GuiObjects` qui sont
**complètement** en dehors du canevas ne seront pas rendues.


BillboardGui.ClipsDescendants

Détermine si les portions de `Class.GuiObject|GuiObjects` qui tombent en dehors des
bords du canevas `Class.BillboardGui` seront dessinées.


La distance actuelle en studs entre le `Class.BillboardGui` et la
caméra du joueur. Un événement de changement ne se déclenche pas pour cette propriété à moins que
`Class.BillboardGui.DistanceStep|DistanceStep` soit supérieur à `0`.


BillboardGui.CurrentDistance

La distance actuelle en studs entre le `Class.BillboardGui` et la
caméra du joueur.


Détermine la distance en studs à laquelle le `Class.BillboardGui` arrêtera de
s'agrandir par rapport à la caméra actuelle du joueur, avec
une valeur par défaut de `0`. Si le
`Class.BillboardGui.CurrentDistance|CurrentDistance` du
`Class.BillboardGui` est inférieur à cette valeur, il ne s'agrandira pas plus
que ce qu'il ferait à cette distance.


BillboardGui.DistanceLowerLimit

Détermine la distance en studs à laquelle le `Class.BillboardGui` arrêtera de
s'agrandir.


Détermine les incréments et décréments de taille `Class.BillboardGui.CurrentDistance|CurrentDistance`
in studs à mesure que la caméra du joueur se rapproche et s'éloigne du
`Class.BillboardGui`. La propriété par défaut est `0`.


BillboardGui.DistanceStep

Détermine les incréments et décréments de taille `Class.BillboardGui.CurrentDistance|CurrentDistance`
in studs à mesure que la caméra du joueur se rapproche et s'éloigne du
`Class.BillboardGui`.


Détermine la distance en studs à laquelle le `Class.BillboardGui` arrêtera de
rétrécir par rapport à la caméra actuelle du joueur. Si
le `Class.BillboardGui.CurrentDistance|CurrentDistance` du
`Class.BillboardGui` est supérieur à cette valeur, il ne rétrécira pas plus
que ce qu'il ferait à cette distance.

Cette propriété est ignorée si la valeur est inférieure à `0`. La valeur par défaut
est `-1`, ce qui signifie que la propriété est ignorée par défaut.


BillboardGui.DistanceUpperLimit

Détermine la distance en studs à laquelle le `Class.BillboardGui` arrêtera de
rétrécir.


Cette propriété détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee`, par rapport à l'orientation de
la `Class.Camera`, en unités d'une demi-dimension des
boîtes de détection alignées sur l'axe de la caméra.

Consultez également `Class.BillboardGui.StudsOffset|StudsOffset` qui fonctionne
similairement mais utilise des unités de studs, ou
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` qui
fonctionne de manière similaire mais avec une orientation de décalage relative aux axes globaux.


BillboardGui.ExtentsOffset

Détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee`, par rapport à l'orientation de
la `Class.Camera`, en unités d'une demi-dimension des
boîtes de détection alignées sur l'axe de la caméra.


Cette propriété détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee`, par rapport aux axes globaux, en
unités d'une demi-dimension des boîtes de détection alignées sur l'axe du modèle.

Consultez également `Class.BillboardGui.StudsOffset|StudsOffset` qui fonctionne
similairement mais utilise des unités de studs, ou
`Class.BillboardGui.ExtentsOffset|ExtentsOffset` qui fonctionne de manière similaire
sauf que l'orientation du décalage est relative à la `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee`, par rapport aux axes globaux, en
unités d'une demi-dimension des boîtes de détection alignées sur l'axe du modèle.


Contrôle la mesure dans laquelle le `Class.BillboardGui` est influencé par l'éclairage
environnemental, dans une plage de `0` à `1`. Définir cela sur `1` signifie que
l'éclairage environnant a le contrôle total sur l'apparence, tandis que
le définir sur `0` signifie que l'éclairage n'a aucun effet.


BillboardGui.LightInfluence

Contrôle la mesure dans laquelle le `Class.BillboardGui` est influencé par l'éclairage
environnemental.


Cette propriété contrôle à quelle distance de la caméra le `Class.BillboardGui`
era affiché avant d'arrêter de rendre. Une valeur de `0` ou `inf`
(par défaut) signifie qu'il n'y a pas de limite et qu'il sera rendu à une distance infinie.

Pour les `Class.BillboardGui|BillboardGuis` qui apparaissent en extérieur, il est
recommandé que `Class.BillboardGui.MaxDistance|MaxDistance` soit suffisamment élevé
pour s'assurer que l'UI du conteneur est suffisamment petite à l'écran lorsqu'elle apparaît ou disparaît,
minimisant l'effet de pop‑in/out soudain.


BillboardGui.MaxDistance

Contrôle jusqu'où le `Class.BillboardGui` peut être affiché avant d'arrêter de
rendre.


Utilisé par des scripts pour cacher le `Class.BillboardGui` d'un joueur spécifique.

Pour cacher un `Class.BillboardGui` de plusieurs joueurs, placez-le dans
`Class.StarterGui` et utilisez un script pour définir la
propriété `Class.BillboardGui.Enabled|Enabled` en fonction de si le
`Class.Players.LocalPlayer|LocalPlayer` doit pouvoir le voir. La
propriété `Class.BillboardGui.Adornee|Adornee` peut être utilisée pour attacher le
`Class.BillboardGui` à une `Class.BasePart` ou `Class.Attachment` dans le
`Class.Workspace`, au lieu de le parenté.


BillboardGui.PlayerToHideFrom

Utilisé par des scripts pour cacher le `Class.BillboardGui` d'un joueur spécifique.


Contrôle la taille que le `Class.BillboardGui` aura à l'écran.
Contrairement à `Class.GuiObject.Size`, les composants
[scale](/ui/position-and-size#size) de cette propriété
définissent la taille en studs du panneau dans l'espace 3D.


BillboardGui.Size

Contrôle la taille que le `Class.BillboardGui` aura à l'écran.


Un décalage 2D en unités relatives à la taille qui agit comme un point d'ancrage. Cela
peut être utilisé de manière similaire à la propriété `Class.GuiObject.AnchorPoint`, mais
les valeurs sont différentes.

<table size="small">
<thead>
<th>Décalage de taille</th>
<th>Explication</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>La valeur par défaut dans laquelle l'UI sera ancrée au centre.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>L'UI sera ancrée en bas à gauche.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>L'UI sera ancrée en haut à gauche.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>L'UI sera ancrée en haut à droite.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>L'UI sera ancrée en bas à droite.</td>
</tr>
</tbody>
</table>

Consultez également `Class.BillboardGui.StudsOffset|StudsOffset`, `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`, `Class.BillboardGui.ExtentsOffset|ExtentsOffset`, et
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` qui sont des propriétés de décalage qui fonctionnent dans l'espace 3D à la place.


BillboardGui.SizeOffset

Un décalage 2D en unités relatives à la taille qui agit comme un point d'ancrage.


Cette propriété détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee` en studs, par rapport à l'orientation de
la `Class.Camera`.

Consultez également `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`
qui fonctionne de manière similaire, sauf que l'orientation du décalage est relative aux
dimensions globales.


BillboardGui.StudsOffset

Détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee` en studs, par rapport à l'orientation de
la `Class.Camera`.


Cette propriété détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee` en studs, par rapport aux axes globaux.

Consultez également `Class.BillboardGui.StudsOffset|StudsOffset` qui fonctionne
similairement sauf que l'orientation du décalage est relative à la `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Détermine comment le `Class.BillboardGui` est décalé par rapport à son
`Class.BillboardGui.Adornee|Adornee` en studs, par rapport aux axes globaux.


Un conteneur pour `Class.GuiObject|GuiObjects` qui s'affiche dans l'espace 3D face à
la caméra.


**LayerCollector** est la classe de base des conteneurs UI 2D qui rendent
les descendants de `Class.GuiObject`, comme `Class.ScreenGui`.

Pour améliorer les performances, l'apparence d'un `Class.LayerCollector` est
mise en cache jusqu'à ce qu'un des événements suivants se produise :

- Un descendant est ajouté ou retiré.
- Une propriété d'un descendant change.
- Une propriété du `Class.LayerCollector` lui-même change.

LayerCollector:GetLayoutNodeTree

LayerCollector

Active ou désactive la visibilité de ce `Class.LayerCollector`. Lorsque `false`, le
contenu de l'UI ne sera pas rendu, ne traitera pas les entrées utilisateur, ou ne se mettra pas à jour en réponse aux
changements.

LayerCollector.Enabled

Active ou désactive la visibilité de ce `Class.LayerCollector`.

Lorsqu'il est défini sur `false` et que ce `Class.LayerCollector` est un enfant direct de
`Class.StarterGui`, il sera seulement copié dans le `Class.PlayerGui` de chaque joueur
une fois et il ne sera pas supprimé lorsque le personnage du joueur
réapparaît.

Lorsqu'il est défini sur `true` (par défaut), ou si ce `Class.LayerCollector` est un
**descendant** **indirect** de `Class.StarterGui`, il sera copié dans le `Class.PlayerGui`
de chaque joueur lorsque leur personnage réapparaît, et il se supprimera lorsqu'un
nouveau personnage du joueur réapparaît.

LayerCollector.ResetOnSpawn

Détermine si le `Class.LayerCollector` se réinitialise (supprime lui-même et
se recopie dans le `Class.PlayerGui` du joueur) chaque fois que le personnage du joueur
réapparaît.

Contrôle le comportement de `Class.GuiObject.ZIndex` sur tous les descendants de ce
`Class.LayerCollector`.

Avec `Enum.ZIndexBehavior.Sibling` (par défaut), les enfants s'affichent toujours au-dessus
de leurs parents, et le `Class.GuiObject.ZIndex|ZIndex` est utilisé pour décider
de l'ordre dans lequel les enfants d'un seul objet UI s'afficheront les uns
par rapport aux autres.

`Enum.ZIndexBehavior.Global` trie tous les descendants selon le
`Class.GuiObject.ZIndex|ZIndex`, puis résout les égalités en utilisant l'ordre
hiérarchique. Par conséquent, les descendants d'un `Class.GuiObject` doivent avoir un
valeur de `Class.GuiObject.ZIndex|ZIndex` au moins aussi élevée que celle de
leur parent, sinon ils s'afficheront en dessous de leur parent.


LayerCollector.ZIndexBehavior

Contrôle le comportement de `Class.GuiObject.ZIndex` sur tous les descendants de ce
`Class.LayerCollector`.


La classe de base des conteneurs UI 2D qui rendent des `Class.GuiObject|GuiObjects`
par niveaux.

`Class.GuiBase2d` est une classe abstraite héritée par 2D
`Class.GuiObject|GuiObjects`.

Cet événement se déclenche lorsque la sélection du gamepad passe à, sort de, ou change
au sein du `Class.GuiBase2d` connecté ou de tout descendant
`Class.GuiObject|GuiObjects`. Lorsque le surlignage de sélection se déplace vers un
`Class.GuiObject`, l'événement remonte de ce `Class.GuiObject` à tous ses ancêtres, leur
informant que la sélection a changé/est entrée/a quitté un `Class.GuiObject` dans leur
arbre descendant.

GuiBase2d.SelectionChanged

amISelected

Vrai si la nouvelle sélection correspond au GuiBase2d attaché.

previousSelection

newSelection

Se déclenche lorsque la sélection du gamepad passe à, sort de, ou change au sein du
`Class.GuiBase2d` connecté ou de tout descendant
`Class.GuiObject|GuiObjects`.

GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` est une propriété en lecture seule
qui fournit la position à l'écran d'un élément `Class.GuiBase2d`
en pixels. Cela représente la position pixel réelle à laquelle un élément
se rend comme résultat des tailles et positions de ses ancêtres. Notez que
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` représente toujours le
coin supérieur gauche de l'élément `Class.GuiBase2d`.

Si le `Class.GuiBase2d` est dans un `Class.ScreenGui`, la
propriété `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` utilise le
système de coordonnées du viewport `Enum.ScreenInsets|CoreUISafeInsets`. L'origine de ce
système de coordonnées est située dans le coin inférieur gauche de
la barre supérieure de Roblox. Notez que c'est le même système de
coordonnées utilisé par la propriété `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagramme montrant l'origine du système de coordonnées AbsolutePosition." />

Voir aussi `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` et
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsolutePosition

Décrit la position réelle à l'écran d'un élément `Class.GuiBase2d`, en
pixels.

`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` est une propriété en lecture seule
qui décrit la rotation réelle à l'écran d'un élément `Class.GuiBase2d`, en degrés. Elle ne
fait **pas** de vérification de limites, donc sa valeur
peut ne pas être dans la plage `0` à `360`.

Voir aussi `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` et
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsoluteRotation

Décrit la rotation réelle à l'écran d'un élément `Class.GuiBase2d`, en
dégrees.

`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` est une propriété en lecture seule qui
décrit la taille réelle à l'écran d'un élément `Class.GuiBase2d`, en
pixels.

Voir aussi `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` et
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.

GuiBase2d.AbsoluteSize

Décrit la taille réelle à l'écran d'un élément `Class.GuiBase2d`, en
pixels.

Lorsqu'il est défini sur `true`, la localisation sera appliquée à ce `Class.GuiBase2d`
et ses descendants. Les entrées utilisées pour la localisation sont le même ensemble d'
entrées retournées par `Class.LocalizationService:GetTableEntries()`. Les entrées
avec `Class.GuiBase2d.AutoLocalize|AutoLocalize` activé sont automatiquement
re-traduites après le chargement de la table cloud si nécessaire.

Voir aussi `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.

GuiBase2d.AutoLocalize

Lorsqu'il est défini sur `true`, la localisation sera appliquée à ce `Class.GuiBase2d`
et ses descendants.

Cette propriété est automatiquement définie sur vrai lorsqu'une table de localisation
`Class.LocalizationTable.Root` cible cet objet, ou un ancêtre de cet
objet. `Class.LocalizationTable|LocalizationTables` avec leur
propriété `Class.LocalizationTable.Root` pointant vers une instance
localisera tous les `Class.TextLabel.TextButton` qui sont des descendants de la racine
instance.

GuiBase2d.Localize

Automatiquement défini sur vrai lorsqu'une table de localisation
`Class.LocalizationTable.Root` cible cet objet, ou un ancêtre de cet
objet.

Une référence à une `Class.LocalizationTable` à utiliser pour appliquer une
localisation automatisée à ce `Class.GuiBase2d` et ses descendants.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` doit être défini sur `true` sur le
`Class.GuiBase2d` et ses ancêtres pour que la localisation automatisée soit
appliquée.

Vous pouvez définir cela pour référencer une `Class.LocalizationTable` n'importe où dans le
`Class.DataModel`. L'objet `Class.GuiBase2d` et tous ses enfants
essaieront d'utiliser cette `Class.LocalizationTable` spécifique et ses ancêtres
pour le remplacement automatique de texte avant d'utiliser les tables sous
`Class.LocalizationService` dans un ordre non défini et la table cloud.

S'il n'y a pas de traduction disponible dans la table référencée, elle cherchera
une traduction dans le parent de cette table, si c'est aussi une
`Class.LocalizationTable`, et ainsi de suite.

Voir aussi `Class.LocalizationService:GetTableEntries()` qui explique comment
le `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` est utilisé
pour la localisation automatisée.

GuiBase2d.RootLocalizationTable

Une référence à une `Class.LocalizationTable` à utiliser pour appliquer une
localisation automatisée à ce `Class.GuiBase2d` et ses descendants.

Personnalise le comportement de sélection du gamepad dans la direction vers le bas.

GuiBase2d.SelectionBehaviorDown

Personnalise le comportement de sélection du gamepad dans la direction vers la gauche.

GuiBase2d.SelectionBehaviorLeft

Personnalise le comportement de sélection du gamepad dans la direction vers la droite.

GuiBase2d.SelectionBehaviorRight

Personnalise le comportement de sélection du gamepad dans la direction vers le haut.

GuiBase2d.SelectionBehaviorUp

Permet de personnaliser la manière dont la sélection du gamepad peut se déplacer entre
les boutons, qui sont des descendants du groupe de sélection, quitter le groupe,
et sélectionner d'autres boutons.

Définir `Class.GuiBase2d.SelectionGroup|SelectionGroup` sur `true` expose
les propriétés `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, et
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`.
Pour ces comportements de sélection, un paramètre de
`Enum.SelectionBehavior.Escape` (par défaut) signifie que la sélection du gamepad
essaie d'abord de trouver une sélection au sein du groupe de sélection et ne se déplace
à l'extérieur que si elle ne trouve pas de bouton approprié. Alternativement, un paramètre de
`Enum.SelectionBehavior.Stop` signifie que la sélection du gamepad ne regarde que dans
le groupe de sélection et ne se déplace pas en dehors du groupe dans la direction du
comportement de sélection.

GuiBase2d.SelectionGroup

Permet la personnalisation du mouvement de sélection du gamepad.

Une classe abstraite héritée par 2D `Class.GuiObject|GuiObjects`.

GuiBase est une classe abstraite dont la plupart des objets d'interface graphique
héritent.


GuiBase

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

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

Démontre la détection des changements dans la descendance d'une instance en se connectant à l'événement
`Class.Instance.AncestryChanged`.

Le Parent de ChangingPart est défini sur différentes valeurs au fil du temps. Le parent de
la pièce est l'ancêtre de la pièce, donc l'événement `Class.Instance.AncestryChanged`
se déclenchera chaque fois qu'il change.


Déclenche lorsque cette instance est re-parentée ou lorsque l'un de ses
ancêtres est re-parenté.

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

Instance.AncestryChanged

child

L'instance dont la propriété `Class.Instance.Parent|Parent` a changé,
qui peut être cette instance ou un ancêtre plus lointain, **pas**
nécessairement l'instance à laquelle le gestionnaire est connecté.

parent

Déclenche lorsqu'il y a un changement dans la propriété `Class.Instance.Parent`
de cet objet ou de l'un de ses ancêtres.

Cet événement déclenche chaque fois qu'un attribut est modifié sur l'instance,
notamment lorsque l'attribut est défini sur `nil`. Le nom de l'attribut modifié
est passé à la fonction connectée.

Par exemple, le snippet de code suivant connecte la fonction `attributeChanged()`
qui se déclenche chaque fois qu'un des attributs de la pièce change:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "modifié")
end

part.AttributeChanged:Connect(attributeChanged)
```
Voir aussi `Class.Instance:GetAttributeChangedSignal()` qui renvoie un
event qui se déclenche lorsqu'un attribut spécifique donné change.

Instance.AttributeChanged

attribute

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

Déclenche chaque fois qu'un attribut est modifié sur la `Class.Instance`.

Ce fragment imprime les noms des objets lorsqu'ils sont ajoutés à l'espace de travail :

Déclenche après qu'un objet a été parenté à cette `Class.Instance`.

Notez que, lors de l'utilisation de cette méthode sur un client pour détecter des objets créés par le
serveur, il est nécessaire d'utiliser `Class.Instance:WaitForChild()` lors
de l'indexation des descendants de ces objets. Cela est dû au fait que l'objet et ses
descendants ne sont pas garantis d'être répliqués du serveur au client
simultanément. Par exemple:

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

Workspace.ChildAdded:Connect(function(child)
	-- Utilisez WaitForChild() car les descendants peuvent ne pas avoir encore été répliqués
	local head = child:WaitForChild("Head")
end)
```
Notez que cet événement ne fonctionne que pour les enfants immédiats de la
`Class.Instance`. Pour un événement qui capture tous les descendants, utilisez
`Class.Instance.DescendantAdded`.

Voir aussi `Class.Instance.ChildRemoved`.

Instance.ChildAdded

La `Class.Instance` qui a été ajoutée.

Déclenche après qu'un objet a été parenté à cette `Class.Instance`.

Instance.childAdded

Ce fragment imprime les noms des objets au fur et à mesure qu'ils sont retirés du
Workspace :

Déclenche après qu'un enfant a été supprimé de cette `Class.Instance`.

Supprimé fait référence au moment où le parent d'un objet est changé de
cette `Class.Instance` à autre chose que cette `Class.Instance`. Notez que cet\événement sera également déclenché lorsqu'un enfant est détruit (à l'aide de
`Class.Instance:Destroy()`) car la fonction de destruction définit le parent d'un objet
sur `nil`.

Cet événement ne fonctionne que pour les enfants immédiats de la `Class.Instance`.
Pour un événement qui capture tous les descendants, utilisez
`Class.Instance.DescendantRemoving`.

Voir aussi `Class.Instance.ChildAdded`.

Instance.ChildRemoved

La `Class.Instance` qui a été supprimée.

Déclenche après qu'un enfant a été supprimé de cette `Class.Instance`.

Cet exemple suivant affichera le nom de tout objet ajouté au
Espace de travail :

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

Comme il se déclenche pour chaque descendant, la parenté d'un objet à la
`Class.Instance` déclenchera l'événement pour cet objet et tous ses
descendants individuellement.

Si vous vous préoccupez uniquement des **enfants directs** de la
`Class.Instance`, utilisez `Class.Instance.ChildAdded` à la place.

Voir aussi `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Déclenche après qu'un descendant a été ajouté à la `Class.Instance`.

L'exemple suivant affiche le nom de tout descendant au moment où il est supprimé
du Workspace :

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

Puisque cet événement se déclenche **avant** la suppression du descendant, le parent du
descendant ne sera pas modifié 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 `Class.Instance.ChildRemoved`.

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

#### Avertissement

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

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Ne pas manipuler le parent du descendant dans cette fonction!
	-- Cet événement se déclenche PARCE QUE le parent a été manipulé, et le changement n'est pas encore arrivé
	-- Par conséquent, il est problématique de changer le parent de cette manière:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Voir aussi `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

La `Class.Instance` qui est en cours de suppression.

Déclenche immédiatement avant qu'un descendant de la `Class.Instance` ne soit supprimé.

Cet exemple montre comment, lors de l'utilisation du comportement de signal immédiat, une
Instance étant détruite reste en place jusqu'à ce que la fonction connectée se mette en attente.


Cet exemple démontre comment, lors de l'utilisation du comportement de signal différé, une Instance
est détruite avant que le signal ne se déclenche.


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 se met en pause à tout moment,
la `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 le
`Class.Instance` ou l'un de ses ancêtres 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
ergonomie, qui sera après que le `Class.Instance` ou l'un de ses ancêtres soit
détruit avec `Class.Instance:Destroy()`.

Avec le comportement `Enum.SignalBehavior.Deferred|Deferred`, connecter 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 s'exécutera pas).

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

Instance.Destroying

Déclenche immédiatement avant (ou est différé jusqu'après) que l'instance soit
détruite via `Class.Instance:Destroy()`.

Cet événement se déclenche chaque fois qu'une propriété de style est modifiée sur l'instance,
notamment lorsque l'attribut est défini 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("Les propriétés de style ont changé")
end

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

Instance.StyledPropertiesChanged

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

Cette méthode applique une étiquette à l'instance, sans effet si l'étiquette est
déjà appliquée. L'ajout réussi d'une étiquette déclenchera un signal créé par
`Class.CollectionService:GetInstanceAddedSignal()` avec l'étiquette donnée.

#### Avertissements

- Les étiquettes d'une instance ajoutées côté client seront supprimées si le
  serveur ajoute ou supprime plus tard une étiquette sur cette instance car le serveur
  réplique toutes les étiquettes ensemble et écrase les étiquettes précédentes.

- Lors de l'étiquetage d'une instance, il est courant que des ressources soient
  utilisées pour donner à l'étiquette sa fonctionnalité, par exemple des connexions d'événements ou des tables.
  Pour éviter les fuites de mémoire, il est bon de nettoyer cela (déconnecter,
  définir à `nil`, etc.) lorsque ce n'est plus nécessaire pour une étiquette. Faites le lorsque
  vous appelez `Class.Instance:RemoveTag()`, en appelant
  `Class.Instance:Destroy()` ou dans une fonction connectée à un signal
  renvoyé par `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

La fonction enfants renvoie un tableau des enfants de l'objet.

Instance:children

Renvoie un tableau des enfants de l'objet.

Cette méthode détruit tous les enfants d'une instance ainsi que ses descendants.

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

-- Ajouter des étincelles
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Enfants:", #part:GetChildren())  --> Enfants: 0
```
Si vous ne souhaitez pas détruire **tous** les enfants et descendants, utilisez soit
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` pour
parcourir ces enfants/descendants et sélectionner ceux à détruire. Par
exemple, l'échantillon 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 méthode détruit tous les enfants d'une instance.

Démontre le clonage d'un modèle en utilisant `Class.Instance:Clone()`.

`Clone()` crée une copie d'une instance et de tous ses descendants,
ignorant toutes les instances qui ne sont pas
`Class.Instance.Archivable|Archivable`. La copie de l'instance racine est
renvoyé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éfini sur `false`, cette méthode renverra
`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épendra de la
valeur d'origine :

- Si une propriété de référence fait référence à une instance qui a également été clonée,
  la copie fera référence à la copie.
- Si une propriété de référence fait référence à une instance qui n'a **pas** été clonée,
  la même valeur est maintenue dans la copie.

Instance:Clone

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

Instance:clone

Démontre la destruction d'une Partie en utilisant la fonction `Class.Instance:Destroy()`.

Cette fonction est la manière correcte de se débarrasser des objets qui ne sont plus
nécessaires.


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

Se débarrasser des objets inutiles est important, car des objets et des
connexions inutiles dans un endroit utilisent de la mémoire, ce qui peut
entraîner de graves problèmes de performance dans le temps.

En tant que meilleure pratique, après avoir appelé `Destroy()` sur un objet, définissez toute
variable faisant référence à l'objet (ou à ses descendants) à `nil`. Cela
empêche votre code d'accéder à quoi que ce soit lié à l'objet.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Ne pas faire cela :
print(part.Name)  --> "Hello, world"
-- Faites cela pour empêcher la ligne ci-dessus de fonctionner :
part = nil
```
Une fois qu'un `Class.Instance` a été détruit par cette méthode, il ne peut pas être
réutilisé car la propriété `Class.Instance.Parent` est verrouillée. Pour
**supprimer temporairement** 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 temps défini, utilisez
`Class.Debris:AddItem()`.

Instance:Destroy

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

Instance:destroy

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

Cette méthode fonctionne vers le haut, ce qui signifie qu'elle commence par le `Class.Instance.Parent` immédiat
et remonte vers le `Class.DataModel`. Si aucun ancêtre correspondant n'est trouvé, elle renvoie `nil`.

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

```
local car = object:FindFirstAncestor("Car")
```
Pour les variantes de cette méthode 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 de l'`Class.Instance` dont
`Class.Instance.Name` est égal au nom donné.

Renvoie le premier ancêtre de l'`Class.Instance` dont
`Class.Object.ClassName` est égal au nom de classe donné.

Cette méthode fonctionne vers le haut, ce qui signifie qu'elle commence par le `Class.Instance.Parent` immédiat
et remonte vers le `Class.DataModel`. Si aucun ancêtre correspondant n'est trouvé, elle renvoie `nil`.

Une utilisation courante de cette méthode est de trouver le `Class.Model` auquel
un `Class.BasePart` appartient. Par exemple :

```
local model = part:FindFirstAncestorOfClass("Model")
```
Cette méthode 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()` à la place pour respecter l'héritage des classes.

Instance:FindFirstAncestorOfClass

className

Le `Class.Object.ClassName` à rechercher.

Renvoie le premier ancêtre de l'`Class.Instance` dont
`Class.Object.ClassName` est égal au nom de classe donné.

Renvoie le premier ancêtre de l'`Class.Instance` pour qui
`Class.Object:IsA()` renvoie vrai pour le nom de classe donné.

Cette méthode fonctionne vers le haut, ce qui signifie qu'elle commence par le `Class.Instance.Parent` immédiat
et remonte vers le `Class.DataModel`. Si aucun ancêtre correspondant n'est trouvé, elle renvoie `nil`.

Contrairement à `Class.Instance:FindFirstAncestorOfClass()`, cette méthode utilise
`Class.Object:IsA()` qui respecte l'héritage des classes. Par exemple :

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Par conséquent, l'extrait de code suivant renverra le premier
ancêtre `Class.BasePart`, peu importe s'il s'agit d'un `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Voir aussi `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Renvoie le premier ancêtre de l'`Class.Instance` pour qui
`Class.Object:IsA()` renvoie vrai pour le nom de classe donné.

Le code ci-dessous cherchera dans Workspace un objet nommé "Brick". S'il est trouvé, il changera le nom de l'objet en "Foo".

Renvoie le premier enfant de l'`Class.Instance` avec le nom donné, ou
`nil` si aucun enfant de ce type n'existe. Si l'argument optionnel `recursive` est
`true`, cette méthode recherche tous les descendants plutôt que seulement les
enfants immédiats de l'`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. Essayer d'indexer un enfant par son nom en utilisant l'opérateur
point génère une erreur si l'enfant n'existe pas.

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

-- La ligne suivante génère une erreur si la partie n'existe pas dans l'espace de travail
Workspace.Part.Transparency = 0.5
```
Une meilleure approche est d'utiliser `FindFirstChild()` pour d'abord vérifier `Part`,
puis d'utiliser une instruction `if` pour exécuter le 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
des propriétés de son `Class.Instance.Parent|Parent`. Lorsqu'on utilise l'opérateur point, les propriétés
dépassent les enfants s'ils ont le même 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` fait référence à la valeur de la propriété `Datatype.Color3`, et non à l'instance de
l'enfant `Class.Folder`. Un avantage d'utiliser
`Class.Instance:FindFirstChild()|FindFirstChild()` est que l'introduction de nouvelles propriétés ne pose
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")  -- Le dossier enfant
```

#### Remarques de performance

`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 stocker
une référence à un objet. Par conséquent, vous devriez éviter de l'appeler dans
un code dépendant de la performance tel que 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
donné nom devient disponible.

Instance:FindFirstChild

recursive

Si la recherche doit être effectuée récursivement ou non.

Renvoie le premier enfant de l'`Class.Instance` trouvé avec le nom donné.

Instance:findFirstChild

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

Instance:FindFirstChildOfClass

Renvoie le premier enfant de l'`Class.Instance` dont
`Class.Object.ClassName|ClassName` est égal au nom de classe donné.

Renvoie le premier enfant de l'`Class.Instance` pour qui
`Class.Object:IsA()` renvoie vrai pour le nom de classe donné.

Si aucun enfant correspondant n'est trouvé, cette méthode renvoie `nil`. Si l'argument
optionnel `recursive` est vrai, cette méthode recherche tous les descendants plutôt
que seulement les enfants immédiats de l'`Class.Instance`.

Contrairement à `Class.Instance:FindFirstChildOfClass()`, cette méthode utilise
`Class.Object:IsA()` qui respecte l'héritage des classes. Par exemple :

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Par conséquent, l'échantillon de code suivant renverra le premier
enfant `Class.BasePart`, peu importe s'il s'agit d'un `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Les développeurs cherchant un enfant par nom devraient utiliser
`Class.Instance:FindFirstChild()` à la place.

Instance:FindFirstChildWhichIsA

Renvoie le premier enfant de l'`Class.Instance` pour qui
`Class.Object:IsA()` renvoie vrai pour le nom de classe donné.

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

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 `Class.Instance.Name` donné.

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

Instance:GetActor

Renvoie le `Class.Actor` associé à l'Instance, le cas échéant.

Instance

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

/reference/engine/classes/BillboardGui.yaml