`Class.BillboardGui` is een container voor UI-objecten die in de 3D-ruimte verschijnen maar altijd naar de camera zijn gericht. De positie van de container is relatief ten opzichte van het bovenliggende `Class.BasePart` of `Class.Attachment` (of de `Class.BillboardGui.Adornee|Adornee`). Voor `Class.BasePart|BaseParts` wordt de `Class.BasePart.Position|Position` eigenschap gebruikt, terwijl voor `Class.Attachment|Attachments` de `Class.Attachment.WorldPosition|WorldPosition` eigenschap wordt gebruikt.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui met een TextLabel die de schermconsole beschrijft waarboven het zweeft." />

De `Class.BillboardGui.Size|Size` eigenschap van een billboard werkt iets anders dan `Class.GuiObject.Size`. Terwijl de **offset** componenten hetzelfde werken, worden de **scale** componenten gebruikt als studgroottes in 3D-ruimte.

Bij het maken van een grootte-schaal `Class.BillboardGui` die een `Class.TextLabel` bevat, is het nuttig om de `Class.TextLabel.TextScaled|TextScaled` eigenschap van het label in te schakelen, zodat de tekst meeschaaalt met het billboardcanvas naarmate de afstand tot de camera verandert.

Let op dat interactieve UI-elementen zoals `Class.ImageButton|ImageButtons` en `Class.TextButton|TextButtons` binnen een `Class.BillboardGui` alleen gebruikersinvoer ontvangen als ze zijn gekoppeld aan de `Class.PlayerGui`, meestal door de `Class.BillboardGui` in `Class.StarterGui` te plaatsen. De `Class.BillboardGui.Adornee|Adornee` eigenschap kan worden gebruikt om een onderdeel of bijlage in de 3D-wereld te targeten terwijl de `Class.BillboardGui` zelf in de `Class.PlayerGui` blijft.

Zie [In-Experience UI](/ui/in-experience-containers#billboard-ui) voor een gids over het werken met `Class.BillboardGui` containers.

##### Caching Gedrag

Om de prestaties te verbeteren, wordt het uiterlijk van een `Class.BillboardGui` gecached totdat een van de volgende gebeurtenissen zich voordoet, waarna het uiterlijk opnieuw zal worden berekend in het volgende renderframe.

- Een afgeleide wordt toegevoegd aan of verwijderd uit de `Class.BillboardGui`.
- Een eigenschap van een afgeleide van de `Class.BillboardGui` verandert.
- Een eigenschap van de `Class.BillboardGui` zelf verandert.


BillboardGui

Bepaalt of de afgeleiden invoerevenementen ontvangen. Als de `Class.BillboardGui` een `Class.GuiButton` bevat, wordt die knop alleen klikbaar als `Class.BillboardGui.Active|Active` op `true` is ingesteld voor zowel de `Class.BillboardGui` **als** de knop.

Let op dat interactieve UI-elementen zoals `Class.ImageButton|ImageButtons` en `Class.TextButton|TextButtons` binnen een `Class.BillboardGui` alleen gebruikersinvoer ontvangen als ze zijn gekoppeld aan de `Class.PlayerGui`, meestal door de `Class.BillboardGui` in `Class.StarterGui` te plaatsen. De `Class.BillboardGui.Adornee|Adornee` eigenschap kan worden gebruikt om een onderdeel of bijlage in de 3D-wereld te targeten terwijl de `Class.BillboardGui` zelf in de `Class.PlayerGui` blijft.


BillboardGui.Active

Bepaalt of de afgeleiden invoerevenementen ontvangen.


Stelt het doel `Class.BasePart` of `Class.Attachment` in dat de `Class.BillboardGui` relatief is gepositioneerd, waarbij het bovenliggende onderdeel of de bijlage wordt overschreven.


BillboardGui.Adornee

Stelt het doelonderdeel of de bijlage in dat de `Class.BillboardGui` relatief is gepositioneerd.


Deze eigenschap bepaalt of de `Class.BillboardGui` altijd boven andere 3D-objecten wordt weergegeven.

Wanneer ingesteld op `false` (standaard), wordt de `Class.BillboardGui` weergegeven zoals andere 3D-inhoud en wordt deze occluded door andere 3D-objecten. Wanneer ingesteld op `true`, wordt de `Class.BillboardGui` altijd boven 3D-inhoud weergegeven en verandert het uiterlijk aanzienlijk:

- Kleuren komen overeen met hoe ze binnen een `Class.ScreenGui` verschijnen.
- Tekst kan scherper lijken op apparaten met een hoge DPI.
- `Class.BillboardGui.LightInfluence|LightInfluence` wordt behandeld alsof het `0` is.
- `Class.BillboardGui.Brightness|Brightness` heeft geen effect.


BillboardGui.AlwaysOnTop

Bepaalt of de `Class.BillboardGui` altijd boven andere 3D-objecten wordt weergegeven.


Deze eigenschap bepaalt de factor waarmee het licht van de `Class.BillboardGui` container wordt geschaald wanneer `Class.BillboardGui.LightInfluence|LightInfluence` `0` is. Standaard is deze eigenschap `1` en kan deze op elk getal tussen `0` en `1000` worden ingesteld. Door deze eigenschap te wijzigen, kan de schijnbare helderheid van een `Class.BillboardGui` beter worden afgestemd op zijn omgeving. Bijvoorbeeld, een videobillboard kan worden verhelderd in een donkere kamer door `Class.BillboardGui.Brightness|Brightness` op `10` in te stellen.

Let op dat `Class.BillboardGui.Brightness|Brightness` niet toegankelijk is in Studio en geen effect heeft wanneer ofwel `Class.BillboardGui.LightInfluence|LightInfluence` `1` is of `Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` `true` is.


BillboardGui.Brightness

Bepaalt de factor waarmee het licht van de `Class.BillboardGui` container wordt geschaald wanneer `Class.BillboardGui.LightInfluence|LightInfluence` `0` is.


Wanneer ingesteld op `true` (standaard), worden delen van `Class.GuiObject|GuiObjects` die buiten de randen van het `Class.BillboardGui` canvas vallen, niet getekend.

Zelfs wanneer deze eigenschap `false` is, zullen `Class.GuiObject|GuiObjects` die **volledig** buiten het canvas vallen, niet worden weergegeven.


BillboardGui.ClipsDescendants

Of delen van `Class.GuiObject|GuiObjects` die buiten de randen van het `Class.BillboardGui` canvas vallen, worden getekend.


De huidige afstand in studs die de `Class.BillboardGui` van de camera van de speler is. Een veranderingsgebeurtenis wordt niet geactiveerd voor deze eigenschap tenzij `Class.BillboardGui.DistanceStep|DistanceStep` meer dan `0` is.


BillboardGui.CurrentDistance

De huidige afstand in studs die de `Class.BillboardGui` van de camera van de speler is.


Bepaalt de afstand in studs waarop de `Class.BillboardGui` stopt met groter worden ten opzichte van de huidige camera van de speler, met een standaardwaarde van `0`. Als de `Class.BillboardGui.CurrentDistance|CurrentDistance` van de `Class.BillboardGui` onder deze waarde ligt, zal deze niet groter worden dan het zou zijn op deze afstand.


BillboardGui.DistanceLowerLimit

Bepaalt de afstand in studs waarop de `Class.BillboardGui` stopt met groter worden.


Bepaalt de grootte `Class.BillboardGui.CurrentDistance|CurrentDistance` verhogingen en verlagingen in studs naarmate de camera van de speler dichterbij en verder van de `Class.BillboardGui` beweegt. De eigenschap heeft standaard de waarde `0`.


BillboardGui.DistanceStep

Bepaalt de grootte `Class.BillboardGui.CurrentDistance|CurrentDistance` verhogingen en verlagingen in studs naarmate de camera van de speler dichterbij en verder van de `Class.BillboardGui` beweegt.


Bepaalt de afstand in studs waarop de `Class.BillboardGui` stopt met kleiner worden ten opzichte van de huidige camera van de speler. Als de `Class.BillboardGui.CurrentDistance|CurrentDistance` van de `Class.BillboardGui` boven deze waarde ligt, zal deze niet kleiner worden dan het zou zijn op deze afstand.

Deze eigenschap wordt genegeerd als de waarde minder is dan `0`. De standaardwaarde is `-1`, wat betekent dat de eigenschap standaard wordt genegeerd.


BillboardGui.DistanceUpperLimit

Bepaalt de afstand in studs waarop de `Class.BillboardGui` stopt met kleiner worden.


Deze eigenschap bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee`, relatief aan de oriëntatie van de `Class.Camera`, in eenheden die de helft van de afmetingen van de as-aligned bounding box van het model zijn.

Zie ook `Class.BillboardGui.StudsOffset|StudsOffset` die op een vergelijkbare manier werkt maar studeenheden gebruikt, of `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` die op een vergelijkbare manier werkt, behalve dat de offsetoriëntatie relatief is aan de globale assen.


BillboardGui.ExtentsOffset

Bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee`, relatief aan de oriëntatie van de `Class.Camera`, in eenheden die de helft van de afmetingen van de as-aligned bounding box van het model zijn.


Deze eigenschap bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee`, relatief aan de globale assen, in eenheden die de helft van de afmetingen van de as-aligned bounding box van het model zijn.

Zie ook `Class.BillboardGui.StudsOffset|StudsOffset` die op een vergelijkbare manier werkt maar studeenheden gebruikt, of `Class.BillboardGui.ExtentsOffset|ExtentsOffset` die op een vergelijkbare manier werkt, behalve dat de offsetoriëntatie relatief is aan de `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee`, relatief aan de globale assen, in eenheden die de helft van de afmetingen van de as-aligned bounding box van het model zijn.


Bepaalt hoeveel de `Class.BillboardGui` wordt beïnvloed door omgevingsverlichting, in een bereik van `0` tot `1`. Dit op `1` instellen betekent dat de omringende verlichting volledige controle heeft over het uiterlijk, terwijl het op `0` instellen betekent dat de verlichting geen effect heeft.


BillboardGui.LightInfluence

Bepaalt hoeveel de `Class.BillboardGui` wordt beïnvloed door omgevingsverlichting.


Deze eigenschap bepaalt hoe ver van de camera de `Class.BillboardGui` wordt weergegeven voordat deze stopt met renderen. Een waarde van `0` of `inf` (standaard) betekent dat er geen limiet is en dat deze oneindig ver weg zal renderen.

Voor `Class.BillboardGui|BillboardGuis` die buiten verschijnen, wordt aanbevolen dat `Class.BillboardGui.MaxDistance|MaxDistance` hoog genoeg is om ervoor te zorgen dat de UI van de container voldoende klein is op het scherm wanneer deze verschijnt of verdwijnt, waardoor het plotselinge pop-in/out-effect wordt geminimaliseerd.


BillboardGui.MaxDistance

Bepaalt hoe ver weg de `Class.BillboardGui` kan worden weergegeven voordat deze stopt met renderen.


Wordt door scripts gebruikt om de `Class.BillboardGui` voor een specifieke speler te verbergen.

Om een `Class.BillboardGui` voor meer dan één speler te verbergen, plaats deze in `Class.StarterGui` en gebruik een script om de `Class.BillboardGui.Enabled|Enabled` eigenschap in te stellen op basis van of de `Class.Players.LocalPlayer|LocalPlayer` deze zou moeten kunnen zien. De `Class.BillboardGui.Adornee|Adornee` eigenschap kan worden gebruikt om de `Class.BillboardGui` aan een `Class.BasePart` of `Class.Attachment` in de `Class.Workspace` te koppelen, in plaats van deze te koppelen.


BillboardGui.PlayerToHideFrom

Wordt door scripts gebruikt om de `Class.BillboardGui` voor een specifieke speler te verbergen.


Bepaalt de grootte die de `Class.BillboardGui` op het scherm zal hebben. In tegenstelling tot `Class.GuiObject.Size`, stellen de [schaal](/ui/position-and-size#size) componenten van deze eigenschap de studgrootte van het billboard in 3D-ruimte in.


BillboardGui.Size

Bepaalt de grootte die de `Class.BillboardGui` op het scherm zal hebben.


Een 2D-offset in grootte-relatieve eenheden die fungeert als een ankerpunt. Dit kan op een vergelijkbare manier worden gebruikt als de `Class.GuiObject.AnchorPoint` eigenschap, maar de waarden zijn anders.

<table size="small">
<thead>
<th>Grootte Offset</th>
<th>Uitleg</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>De standaard waarbij de UI in het midden wordt verankerd.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI wordt verankerd in de linkerbenedenhoek.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI wordt verankerd in de linkerbovenhoek.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI wordt verankerd in de rechterbovenhoek.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI wordt verankerd in de rechterbenedenhoek.</td>
</tr>
</tbody>
</table>

Zie ook `Class.BillboardGui.StudsOffset|StudsOffset`, `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`, `Class.BillboardGui.ExtentsOffset|ExtentsOffset`, en `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` die offset-eigenschappen zijn die in 3D-ruimte werken.


BillboardGui.SizeOffset

Een 2D-offset in grootte-relatieve eenheden die fungeert als een ankerpunt.


Deze eigenschap bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee` in studs, relatief aan de oriëntatie van de `Class.Camera`.

Zie ook `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace` die op een vergelijkbare manier werkt, behalve dat de offsetoriëntatie relatief is aan de globale assen.


BillboardGui.StudsOffset

Bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee` in studs, relatief aan de oriëntatie van de `Class.Camera`.


Deze eigenschap bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee` in studs, relatief aan de globale assen.

Zie ook `Class.BillboardGui.StudsOffset|StudsOffset` die op een vergelijkbare manier werkt, behalve dat de offsetoriëntatie relatief is aan de `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Bepaalt hoe de `Class.BillboardGui` is verplaatst ten opzichte van zijn `Class.BillboardGui.Adornee|Adornee` in studs, relatief aan de globale assen.


Een container voor `Class.GuiObject|GuiObjects` die in 3D-ruimte wordt weergegeven en naar de camera is gericht.


**LayerCollector** is de basisklasse van 2D UI-containers die
`Class.GuiObject` afgeleiden weergeven, zoals `Class.ScreenGui`.

Voor prestatieverbeteringen wordt het uiterlijk van een `Class.LayerCollector`
gcached totdat een van de volgende gebeurtenissen zich voordoet:

- Een afgeleide wordt eraan toegevoegd of ervan verwijderd.
- Een eigenschap van een afgeleide verandert.
- Een eigenschap van de `Class.LayerCollector` zelf verandert.


LayerCollector:GetLayoutNodeTree

LayerCollector

Schakelt de zichtbaarheid van deze `Class.LayerCollector` in of uit. Wanneer `false`, de
UI-inhoud zal niet worden weergegeven, gebruikersinvoer verwerken of
bijwerken als reactie op veranderingen.


LayerCollector.Enabled

Schakelt de zichtbaarheid van deze `Class.LayerCollector` in of uit.


Wanneer ingesteld op `false` en deze `Class.LayerCollector` een directe
kind is van `Class.StarterGui`, zal het slechts één keer worden gekloond
in de `Class.PlayerGui` van elke speler en zal het niet worden verwijderd
wanneer de karakter van de speler opnieuw verschijnt.

Wanneer ingesteld op `true` (standaard), of als deze `Class.LayerCollector`
een **indirecte** afgeleide is van `Class.StarterGui`, zal het worden gekloond
in de `Class.PlayerGui` van elke speler wanneer hun karakter opnieuw
verschijnt, en het zal zichzelf verwijderen wanneer de karakter van de
speler opnieuw verschijnt.


LayerCollector.ResetOnSpawn

Bepaalt of de `Class.LayerCollector` reset (verwijdert zichzelf en
herkloneert in de `Class.PlayerGui` van de speler) elke keer dat de
karakter van de speler opnieuw verschijnt.


Beheert hoe `Class.GuiObject.ZIndex` zich gedraagt op alle afgeleiden van deze
`Class.LayerCollector`.

Met `Enum.ZIndexBehavior.Sibling` (standaard) worden kinderen altijd boven
hun ouders weergegeven, en de `Class.GuiObject.ZIndex|ZIndex` wordt gebruikt om
de volgorde te bepalen waarin kinderen van een enkel UI-object over elkaar
zullen worden weergegeven.

`Enum.ZIndexBehavior.Global` sorteert alle afgeleiden op basis van de
`Class.GuiObject.ZIndex|ZIndex`, en breekt vervolgens gelijke standen met behulp van de
hiërarchievolgorde. Als gevolg hiervan moeten afgeleiden van een `Class.GuiObject`
een `Class.GuiObject.ZIndex|ZIndex` waarde hebben die minstens zo hoog is als de
ouder, anders worden ze onder hun ouder weergegeven.


LayerCollector.ZIndexBehavior

Beheert hoe `Class.GuiObject.ZIndex` zich gedraagt op alle afgeleiden van deze
`Class.LayerCollector`.


De basisklasse van 2D UI-containers die `Class.GuiObject|GuiObjects`
in lagen weergeven.


`Class.GuiBase2d` is een abstracte klasse die wordt geërfd door 2D
`Class.GuiObject|GuiObjects`.


Dit evenement wordt geactiveerd wanneer de gamepadselectie beweegt naar, verlaat, of verandert
binnen de verbonden `Class.GuiBase2d` of een afstammeling
`Class.GuiObject|GuiObjects`. Wanneer de selectie-highlight naar een
`Class.GuiObject` beweegt, bubbelt het evenement van dat `Class.GuiObject` naar al zijn
voorouders, en informeert hen dat de selectie is
veranderd/ingevoerd/verlaten naar een `Class.GuiObject` in hun afstammingsboom.


GuiBase2d.SelectionChanged

amISelected

Waar als de nieuwe selectie overeenkomt met de gekoppelde GuiBase2d.


previousSelection

De `Class.GuiObject` die eerder was geselecteerd voordat de
selectie veranderde, of nil als er niets was geselecteerd.


newSelection

De `Class.GuiObject` die nu is geselecteerd na de selectie
verandering, of nil als er niets is geselecteerd.


Wordt geactiveerd wanneer de gamepadselectie beweegt naar, verlaat, of verandert binnen de
verbonden `Class.GuiBase2d` of een afstammeling
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` is een alleen-lezen
property die de schermpositie van een `Class.GuiBase2d` element
in pixels biedt. Dit vertegenwoordigt de werkelijke pixelpositie waarop een element
wordt weergegeven als gevolg van de afmetingen en posities van zijn voorouders. Let op dat
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` altijd de
linkerbovenhoek van het `Class.GuiBase2d` element vertegenwoordigt.

Als de `Class.GuiBase2d` zich in een `Class.ScreenGui` bevindt, gebruikt de
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` property het
`Enum.ScreenInsets|CoreUISafeInsets` viewport coördinatensysteem. De
oorsprong van dit coördinatensysteem bevindt zich in de linkerbenedenhoek van
de Roblox bovenbalk. Let op dat dit hetzelfde coördinatensysteem is dat wordt gebruikt door
de `Class.InputObject.Position` property.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagram dat de oorsprong van het AbsolutePosition coördinatensysteem toont." />

Zie ook `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` en
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

Beschrijft de werkelijke schermpositie van een `Class.GuiBase2d` element, in
pixels.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` is een alleen-lezen
property die de werkelijke schermrotatie van een `Class.GuiBase2d`
element beschrijft, in graden. Het voert **geen** grenscontrole uit, dus de waarde
kan buiten het bereik van `0` tot `360` liggen.

Zie ook `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` en
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

Beschrijft de werkelijke schermrotatie van een `Class.GuiBase2d` element, in
graad.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` is een alleen-lezen property die
de werkelijke schermgrootte van een `Class.GuiBase2d` element beschrijft, in
pixels.

Zie ook `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` en
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

Beschrijft de werkelijke schermgrootte van een `Class.GuiBase2d` element, in
pixels.


Wanneer ingesteld op `true`, wordt lokalisatie toegepast op deze `Class.GuiBase2d`
en zijn afstammelingen. De vermeldingen die worden gebruikt voor lokalisatie zijn dezelfde set van
vermeldingen die worden geretourneerd door `Class.LocalizationService:GetTableEntries()`. Vermeldingen
met `Class.GuiBase2d.AutoLocalize|AutoLocalize` ingeschakeld worden automatisch
hervertaald nadat de cloudtabel is geladen, indien nodig.

Zie ook `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

Wanneer ingesteld op `true`, wordt lokalisatie toegepast op deze `Class.GuiBase2d`
en zijn afstammelingen.


Deze property wordt automatisch ingesteld op true wanneer de root van een lokalisatietabel
`Class.LocalizationTable.Root` dit object of een voorouder van dit
object target. `Class.LocalizationTable|LocalizationTables` met hun
`Class.LocalizationTable.Root` property gericht op een instantie zullen
alle `Class.TextLabel.TextButton` die afstammelingen zijn van de root
instantie lokaliseren.


GuiBase2d.Localize

Automatisch ingesteld op true wanneer de root van een lokalisatietabel
`Class.LocalizationTable.Root` dit object of een voorouder van dit
object target.


Een referentie naar een `Class.LocalizationTable` die gebruikt zal worden om geautomatiseerde
lokalisatie toe te passen op deze `Class.GuiBase2d` en zijn afstammelingen.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` moet ingesteld zijn op `true` op de
`Class.GuiBase2d` en zijn voorouders om geautomatiseerde lokalisatie toe te passen.

Je kunt dit instellen om te verwijzen naar een `Class.LocalizationTable` ergens in de
`Class.DataModel`. Het `Class.GuiBase2d` object en al zijn kinderen
zullen proberen die specifieke `Class.LocalizationTable` en zijn voorouders
te gebruiken voor automatische tekstvervanging voordat ze de tabellen onder
`Class.LocalizationService` in een ongedefinieerde volgorde en de cloudtabel gebruiken.

Als er geen vertaling beschikbaar is in de verwijzende tabel, zal het zoeken
naar een vertaling in de ouder van die tabel, als het ook een
`Class.LocalizationTable` is, enzovoort.

Zie ook `Class.LocalizationService:GetTableEntries()` die uitlegt hoe
de `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` wordt gebruikt
voor geautomatiseerde lokalisatie.


GuiBase2d.RootLocalizationTable

Een referentie naar een `Class.LocalizationTable` die gebruikt zal worden om geautomatiseerde
lokalisatie toe te passen op deze `Class.GuiBase2d` en zijn afstammelingen.


`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown` past aan
hoe gamepadselectie beweegt in de neerwaartse richting uit een selectie
groep. Het heeft alleen effect wanneer
`Class.GuiBase2d.SelectionGroup|SelectionGroup` `true` is;
`SelectionGroup` is standaard `false`, en zolang het `false` blijft, heeft deze
property geen effect.

De standaardwaarde is `Enum.SelectionBehavior.Escape`, die prioriteit geeft aan
knoppen binnen de selectie groep, maar het staat de selectie toe om naar een
`Class.GuiObject` buiten de groep te bewegen in de neerwaartse richting als er geen geschikte
knop binnen te vinden is. Het instellen op `Enum.SelectionBehavior.Stop`
beperkt de selectie in plaats daarvan tot de groep, waardoor het niet naar beneden
buiten de groep kan bewegen.

Zie ook `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorDown

Past het gedrag van gamepadselectie aan in de neerwaartse richting.


`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft` past aan
hoe gamepadselectie beweegt in de linker richting uit een selectie
groep. Het heeft alleen effect wanneer
`Class.GuiBase2d.SelectionGroup|SelectionGroup` `true` is;
`SelectionGroup` is standaard `false`, en zolang het `false` blijft, heeft deze
property geen effect.

De standaardwaarde is `Enum.SelectionBehavior.Escape`, die prioriteit geeft aan
knoppen binnen de selectie groep, maar het staat de selectie toe om naar een
`Class.GuiObject` buiten de groep te bewegen in de linker richting als er geen geschikte
knop binnen te vinden is. Het instellen op `Enum.SelectionBehavior.Stop`
beperkt de selectie in plaats daarvan tot de groep, waardoor het niet naar links
buiten de groep kan bewegen.

Zie ook `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorLeft

Past het gedrag van gamepadselectie aan in de linker richting.


`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight` past aan
hoe gamepadselectie beweegt in de rechter richting uit een selectie
groep. Het heeft alleen effect wanneer
`Class.GuiBase2d.SelectionGroup|SelectionGroup` `true` is;
`SelectionGroup` is standaard `false`, en zolang het `false` blijft, heeft deze
property geen effect.

De standaardwaarde is `Enum.SelectionBehavior.Escape`, die prioriteit geeft aan
knoppen binnen de selectie groep, maar het staat de selectie toe om naar een
`Class.GuiObject` buiten de groep te bewegen in de rechter richting als er geen geschikte
knop binnen te vinden is. Het instellen op `Enum.SelectionBehavior.Stop`
beperkt de selectie in plaats daarvan tot de groep, waardoor het niet naar rechts
buiten de groep kan bewegen.

Zie ook `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorRight

Past het gedrag van gamepadselectie aan in de rechter richting.


`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp` past aan hoe
gamepadselectie beweegt in de opwaartse richting uit een selectie groep. Het
heeft alleen effect wanneer `Class.GuiBase2d.SelectionGroup|SelectionGroup` is
`true`; `SelectionGroup` is standaard `false`, en zolang het `false` blijft,
has deze property geen effect.

De standaardwaarde is `Enum.SelectionBehavior.Escape`, die prioriteit geeft aan
knoppen binnen de selectie groep, maar het staat de selectie toe om naar een
`Class.GuiObject` buiten de groep te bewegen in de opwaartse richting als er geen geschikte
knop binnen te vinden is. Het instellen op `Enum.SelectionBehavior.Stop`
beperkt de selectie in plaats daarvan tot de groep, waardoor het niet naar boven
buiten de groep kan bewegen.

Zie ook `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorUp

Past het gedrag van gamepadselectie aan in de opwaartse richting.


Stelt aanpassing mogelijk van hoe gamepadselectie kan bewegen tussen
knoppen, die afstammelingen zijn van de selectie groep, de groep verlaten,
en andere knoppen selecteren.

Het instellen van `Class.GuiBase2d.SelectionGroup|SelectionGroup` op `true` maakt
de `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, en
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`
properties zichtbaar. Voor deze selectiegedragingen betekent een instelling van
`Enum.SelectionBehavior.Escape` (standaard) dat de gamepadselectie
probeert eerst een selectie binnen de selectie groep te vinden en alleen naar
buiten te bewegen als er geen geschikte knop wordt gevonden. Alternatief betekent een instelling van
`Enum.SelectionBehavior.Stop` dat gamepadselectie alleen binnen
de selectie groep kijkt en niet buiten de groep beweegt vanuit de
selectiegedragingrichting.


GuiBase2d.SelectionGroup

Stelt aanpassing van de beweging van gamepadselectie mogelijk.


Een abstracte klasse die wordt geërfd door 2D `Class.GuiObject|GuiObjects`.


GuiBase is een abstracte klasse waarvan de meeste grafische gebruikersinterface-objecten
afstammen.


GuiBase

`Instance` is de basis klasse voor alle klassen in de Roblox klasse hiërarchie
waarvan de onderdelen deel kunnen uitmaken van de `Class.DataModel` boom.

Het is niet mogelijk om direct root `Instance` objecten te creëren, maar de speciale
`Datatype.Instance.new()` constructor creëert objecten via code, waarbij de
naam van de klasse als parameter wordt genomen en het gemaakte object wordt
teruggegeven.


Toont aan hoe veranderingen in de afstamming van een instantie kunnen worden gedetecteerd door verbinding te maken met het
`Class.Instance.AncestryChanged`-evenement.

De Parent van de ChangingPart wordt in de loop van de tijd op verschillende waarden ingesteld. De ouder van
de part is de voorouder van de part, dus het `Class.Instance.AncestryChanged`-evenement
zal worden geactiveerd telkens wanneer het verandert.


Wordt geactiveerd wanneer deze instantie opnieuw wordt gepaard of wanneer een van zijn voorouders wordt
gepaard.

Je kunt dit evenement gebruiken om de verwijdering van een instantie in Studio bij te houden,
zoals handmatige verwijdering in de Explorer of via een plugin. Als je moet
detecteren wanneer een instantie wordt vernietigd met `Class.Instance:Destroy()`,
gebruik dan in plaats daarvan het `Class.Instance.Destroying` evenement.


Instance.AncestryChanged

child

De instantie wiens `Class.Instance.Parent|Parent` eigenschap is gewijzigd,
wat deze instantie of een meer verre voorouder kan zijn, **niet**
per se de instantie waarmee de handler is verbonden.


parent

De nieuwe ouder van de `child` parameter.


Wordt geactiveerd wanneer de `Class.Instance.Parent` eigenschap van dit object of een van
zijn voorouders wordt gewijzigd.


Dit evenement wordt geactiveerd wanneer een eigenschap wordt gewijzigd op de instantie,
waaronder wanneer een eigenschap wordt ingesteld op `nil`. De naam van de gewijzigde
eigenschap wordt doorgegeven aan de verbonden functie.

Bijvoorbeeld, de volgende codefragment verbindt de `attributeChanged()`
funtie om te activeren wanneer een van de eigenschappen van het onderdeel verandert:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Zie ook `Class.Instance:GetAttributeChangedSignal()` die een
evenement retourneert dat wordt geactiveerd wanneer een specifieke gegeven eigenschap verandert.


Instance.AttributeChanged

attribute

De naam van de eigenschap die is gewijzigd.


Wordt geactiveerd wanneer een eigenschap wordt gewijzigd op de `Class.Instance`.


Dit fragment drukt de namen van objecten af wanneer ze aan de Workspace worden toegevoegd:


Wordt geactiveerd nadat een object aan deze `Class.Instance` is gepaard.

Let op, wanneer je deze methode op een client gebruikt om objecten te detecteren die door de
server zijn gemaakt, is het noodzakelijk om `Class.Instance:WaitForChild()` te gebruiken bij
het indexeren van de afstammelingen van deze objecten. Dit komt omdat het object en zijn
afstammelingen niet gegarandeerd gelijktijdig van de server naar de client worden gerepliceerd. Bijvoorbeeld:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gebruik WaitForChild() aangezien afstammelingen mogelijk nog niet zijn gerepliceerd
	local head = child:WaitForChild("Head")
end)
```
Let op, dit evenement werkt alleen voor directe kinderen van de
`Class.Instance`. Voor een evenement dat alle afstammelingen vastlegt, gebruik
`Class.Instance.DescendantAdded`.

Zie ook `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Wordt geactiveerd nadat een object aan deze `Class.Instance` is gepaard.


Instance.childAdded

Dit fragment drukt de namen van objecten af terwijl ze worden verwijderd uit de
Workspace:


Wordt geactiveerd nadat een kind is verwijderd uit deze `Class.Instance`.

Verwijderd verwijst naar wanneer de ouder van een object wordt gewijzigd van deze
`Class.Instance` naar iets anders dan deze `Class.Instance`. Let op, dit
evenement wordt ook geactiveerd wanneer een kind wordt vernietigd (met
`Class.Instance:Destroy()`) omdat de vernietigingsfunctie de ouder van een object
op `nil` instelt.

Dit evenement werkt alleen voor directe kinderen van de `Class.Instance`.
Voor een evenement dat alle afstammelingen vastlegt, gebruik
`Class.Instance.DescendantRemoving`.

Zie ook `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Wordt geactiveerd nadat een kind is verwijderd uit deze `Class.Instance`.


Dit volgende voorbeeld zal de naam van elk object afdrukken dat wordt toegevoegd aan de
Workspace:


Dit evenement wordt geactiveerd nadat een afstammeling is toegevoegd aan de `Class.Instance`.

Aangezien het wordt geactiveerd voor elke afstammeling, zal het aanroepen van een object naar de
`Class.Instance` het evenement activeren voor dit object en al zijn
afstammelingen afzonderlijk.

Als je alleen geïnteresseerd bent in de **directe kinderen** van de
`Class.Instance`, gebruik dan in plaats daarvan `Class.Instance.ChildAdded`.

Zie ook `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wordt geactiveerd nadat een afstammeling is toegevoegd aan de `Class.Instance`.


Het volgende voorbeeld drukt de naam van elke afstammeling af terwijl deze wordt verwijderd
uit de Workspace:


Dit evenement wordt geactiveerd **onmiddellijk voordat** de ouder `Class.Instance`
verandert zodat een **afstammeling** instantie niet langer een
afstammeling zal zijn. `Class.Instance:Destroy()|Destroy()` verandert de ouder van een instantie naar
`nil`, dus het aanroepen van die methode op een afstammeling van de ouder zal dit evenement activeren.

Aangezien dit evenement wordt geactiveerd **voordat** de verwijdering van de afstammeling plaatsvindt, zal de ouder van
de afstammeling ongewijzigd blijven op het moment van het activeren van dit evenement. Als de
afstammeling ook een **direct kind** van de ouder is, zal dit evenement worden geactiveerd
voordat `Class.Instance.ChildRemoved`.

Als een afstammeling kinderen heeft, wordt dit evenement geactiveerd met de afstammeling eerst,
gevolgd door zijn afstammelingen.

#### Waarschuwing

Dit evenement wordt geactiveerd met het afstammelingobject dat wordt verwijderd.
Proberen de `Class.Instance.Parent|Parent` van de afstammeling naar iets anders in te stellen zal mislukken. Hieronder staat een voorbeeld dat dit aantoont:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipuleer de ouder van de afstammeling niet in deze functie!
	-- Dit evenement wordt geactiveerd OMDAT de ouder is gemanipuleerd, en de wijziging is nog niet gebeurd
	-- Daarom is het problematisch om de ouder op deze manier te veranderen:
	descendant.Parent = game
end)

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


Instance.DescendantRemoving

De `Class.Instance` die wordt verwijderd.


Wordt geactiveerd onmiddellijk voordat een afstammeling van de `Class.Instance` wordt verwijderd.


Dit voorbeeld demonstreert hoe, bij het gebruik van onmiddellijke signaalgedrag, een
Instance die wordt vernietigd op zijn plaats blijft totdat de verbonden functie yieldt.


Dit voorbeeld demonstreert hoe, bij het gebruik van uitgesteld signaalgedrag, een Instance
wordt vernietigd voordat het signaal wordt verzonden.


De `Class.Instance` zal nooit uit het geheugen worden verwijderd terwijl een verbonden
functie deze nog gebruikt. Echter, als de functie op enig moment onderbreekt,
zullen de `Class.Instance` en zijn afstammelingen naar `nil` worden gepaard.

Als de `Class.Workspace.SignalBehavior` eigenschap is ingesteld op
`Enum.SignalBehavior.Immediate`, wordt dit evenement onmiddellijk geactiveerd voordat de
`Class.Instance` of een van zijn voorouders wordt vernietigd met
`Class.Instance:Destroy()`.

Als de `Class.Workspace.SignalBehavior` eigenschap is ingesteld op
`Enum.SignalBehavior.Deferred`, wordt dit evenement geactiveerd op het volgende hervattingspunt,
wat zal zijn na de `Class.Instance` of een van zijn voorouders is vernietigd met `Class.Instance:Destroy()`.

Met `Enum.SignalBehavior.Deferred|Deferred` gedrag, is het problematisch om een script
te verbinden met zijn eigen `Class.Instance.Destroying` evenement, aangezien het script
zal worden vernietigd voordat de callback kan worden aangeroepen (wat betekent dat het niet
zal worden uitgevoerd).

Bij het verwijderen van een `Class.Instance` in Studio, zoals handmatig verwijderen
via de [Explorer](/studio/explorer) of via een plugin,
wordt de `Class.Instance` niet vernietigd. In plaats daarvan wordt de ouder ingesteld op `nil`
wat je kunt bijhouden met `Class.Instance.AncestryChanged`.


Instance.Destroying

Wordt geactiveerd onmiddellijk voordat (of wordt uitgesteld tot na) de instantie wordt
vernietigd via `Class.Instance:Destroy()`.


Toont `Class.Instance.StyledPropertiesChanged`.


Dit evenement wordt geactiveerd wanneer een stijl-eigenschap wordt gewijzigd op de instantie,
waaronder wanneer een eigenschap wordt ingesteld op `nil`.


Instance.StyledPropertiesChanged

Wordt geactiveerd wanneer een stijl-eigenschap wordt gewijzigd op de instantie, inclusief
wanneer een eigenschap wordt ingesteld op `nil`.


Deze methode past een tag toe op de instantie, zonder effect als de tag
al is toegepast. Het succesvol toevoegen van een tag zal een signaal activeren dat is
gemaakt door `Class.CollectionService:GetInstanceAddedSignal()` met de gegeven tag.

#### Waarschuwingen

- De tags van een instantie die client-side zijn toegevoegd, zullen worden verwijderd als de
  server later een tag aan die instantie toevoegt of verwijdert omdat de server
  alle tags samen repliceert en eerdere tags overschrijft.

- Bij het taggen van een instantie is het gebruikelijk dat er enkele middelen worden gebruikt om
  de tag zijn functionaliteit te geven, bijvoorbeeld gebeurteniskoppelingen of tabellen.
  Om geheugenlekken te voorkomen, is het een goed idee om deze op te ruimen (ontkoppelen,
  instellen op `nil`, enz.) wanneer ze niet langer nodig zijn voor een tag. Doe dit bij
  het aanroepen van `Class.Instance:RemoveTag()`, het aanroepen van
  `Class.Instance:Destroy()`, of in een functie die is verbonden met een signaal
  dat is geretourneerd door `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

De tag die op de instantie moet worden toegepast.


De kinderen functie retourneert een array van de kinderen van het object.


Instance:children

Retourneert een array van de kinderen van het object.


Deze methode vernietigt alle kinderen en afstammelingen van een instantie.

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

-- Voeg wat vonkels toe
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Kinderen:", #part:GetChildren())  --> Kinderen: 0
```
Als je niet alle kinderen en afstammelingen wilt vernietigen, gebruik dan ofwel
`Class.Instance:GetChildren()` of `Class.Instance:GetDescendants()` om
door die kinderen/afstammelingen te lopen en te selecteren wat te vernietigen. Voor
voorbeeld, de volgende codevoorbeeld zal alle
`Class.BasePart|BaseParts` vernietigen die afstammen van een `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

Deze methode vernietigt alle kinderen van een instantie.


Toont het klonen van een model met `Class.Instance:Clone()`.


`Clone()` maakt een kopie van een instantie en al zijn afstammelingen,
negerend alle instanties die niet
`Class.Instance.Archivable|Archivable` zijn. De kopie van de root instantie wordt
teruggegeven door deze methode en zijn `Class.Instance.Parent|Parent` wordt ingesteld op
`nil`. Let op dat als de instantie zelf
`Class.Instance.Archivable|Archivable` is ingesteld op `false`, deze methode
`nil` zal retourneren.

Als een referentie-eigenschap zoals `Class.ObjectValue.Value` is ingesteld in een
gekloneerde instantie, hangt de waarde van de eigenschap van de kopie af van de
waarde van het origineel:

- Als een referentie-eigenschap verwijst naar een instantie die **ook** is gekloond,
  zal de kopie naar de kopie verwijzen.
- Als een referentie-eigenschap verwijst naar een instantie die **niet** is gekloond,
  wordt dezelfde waarde behouden in de kopie.


Instance:Clone

Een kopie van de instantie, of `nil` als de instantie niet
`Class.Instance.Archivable|Archivable` is.


Maak een kopie van een instantie en al zijn afstammelingen, negerend instanties
die niet `Class.Instance.Archivable|Archivable` zijn.


Instance:clone

Toont het vernietigen van een Deel met de `Class.Instance:Destroy()` functie.

Deze functie is de juiste manier om objecten weg te gooien die niet langer
vereist zijn.


Stelt de `Class.Instance.Parent` eigenschap in op `nil`, vergrendelt de
`Class.Instance.Parent` eigenschap, ontkoppelt alle verbindingen, en roept
`Destroy()` aan op alle kinderen. Deze methode is de juiste manier om objecten die
niet langer nodig zijn te verwijderen.

Het verwijderen van onnodige objecten is belangrijk, aangezien onnodige objecten en
verbindingen in een plaats geheugen gebruiken wat kan leiden tot ernstige prestatieproblemen
in de loop van de tijd.

Als beste praktijk na het aanroepen van `Destroy()` op een object, stel je alle
variabelen die naar het object (of zijn afstammelingen) verwijzen in op `nil`. Dit
voorkomt dat je code toegang heeft tot iets dat met het object te maken heeft.

```lua
local part = Instance.new("Part")
part.Name = "Hallo, wereld"
part:Destroy()
-- Doe dit niet:
print(part.Name)  --> "Hallo, wereld"
-- Doe dit om te voorkomen dat de bovenstaande regel werkt:
part = nil
```
Zodra een `Class.Instance` door deze methode is vernietigd, kan deze niet meer
worden hergebruikt omdat de `Class.Instance.Parent` eigenschap is vergrendeld. Om
**tijdelijk** een object te verwijderen in plaats van het te vernietigen, stel je
`Class.Instance.Parent|Parent` in op `nil`. Bijvoorbeeld:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Om een object na een bepaalde tijd te vernietigen, gebruik
`Class.Debris:AddItem()`.


Instance:Destroy

Stelt de `Class.Instance.Parent` eigenschap in op `nil`, vergrendelt de
`Class.Instance.Parent` eigenschap, ontkoppelt alle verbindingen, en roept
`Destroy()` aan op alle kinderen.


Instance:destroy

Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Instance.Name` gelijk is aan de gegeven naam.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

De volgende codefragment zou de eerste voorouder van het object
met de naam `Car` vinden.

```
local car = object:FindFirstAncestor("Car")
```
Voor varianten van deze methode die voorouders van een specifieke klasse vinden,
zie `Class.Instance:FindFirstAncestorOfClass()` en
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

De `Class.Instance.Name` die moet worden gezocht.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Instance.Name` gelijk is aan de gegeven naam.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Object.ClassName` gelijk is aan de gegeven className.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

Een veelgebruikte toepassing van deze methode is het vinden van de `Class.Model` waartoe
een `Class.BasePart` behoort. Bijvoorbeeld:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Deze methode is een variant van `Class.Instance:FindFirstAncestor()` die
de `Class.Object.ClassName` eigenschap controleert in plaats van
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` bestaat ook,
met gebruik van de `Class.Object:IsA()` methode in plaats daarvan om de klasse
overerving te respecteren.


Instance:FindFirstAncestorOfClass

className

De `Class.Object.ClassName` die moet worden gezocht.


Retourneert de eerste voorouder van de `Class.Instance` wiens
`Class.Object.ClassName` gelijk is aan de gegeven className.


Retourneert de eerste voorouder van de `Class.Instance` voor wie
`Class.Object:IsA()` waar retourneert voor de gegeven className.

Deze methode werkt omhoog, wat betekent dat het begint bij de directe
`Class.Instance.Parent` van de instantie en omhoog werkt naar de `Class.DataModel`. Als er geen
overeenkomende voorouder wordt gevonden, retourneert het `nil`.

In tegenstelling tot `Class.Instance:FindFirstAncestorOfClass()`, gebruikt deze methode
`Class.Object:IsA()` die de klasse overerving respecteert. Bijvoorbeeld:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Daarom zal de volgende codevoorbeeld de eerste
`Class.BasePart` voorouder retourneren, ongeacht of het een `Class.WedgePart`,
`Class.MeshPart` of `Class.Part` is.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Zie ook `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Retourneert de eerste voorouder van de `Class.Instance` voor wie
`Class.Object:IsA()` waar retourneert voor de gegeven className.


Het onderstaande zou in Workspace zoeken naar een object met de naam "Brick". Als het gevonden wordt, 
zult het de naam van het object veranderen in "Foo".


Retourneert het eerste kind van de `Class.Instance` met de gegeven naam, of
`nil` als er geen dergelijk kind bestaat. Als de optionele `recursief` argument is
`true`, zoekt deze methode door alle afstammelingen in plaats van alleen de
directe kinderen van de `Class.Instance`.

#### Controleren of een Object Bestaat

`FindFirstChild()` is noodzakelijk als je moet verifiëren of een object bestaat
voordat je verder gaat. Proberen om een kind op naam te indexeren met de punt
operator genereert een fout als het kind niet bestaat.

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

-- De volgende regel genereert een fout als het onderdeel niet bestaat in de workspace
Workspace.Part.Transparency = 0.5
```
Een betere aanpak is om `FindFirstChild()` te gebruiken om eerst te controleren op `Part`,
vervolgens een `if`-verklaring te gebruiken om code uit te voeren die het nodig heeft.

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

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

#### Een Kind Vinden Wiens Naam Een Eigenschap Overeenkomt

Soms is de `Class.Instance.Name|Name` van een object hetzelfde als dat van een
eigenschap van zijn `Class.Instance.Parent|Parent`. Bij gebruik van de punt
operator hebben eigenschappen voorrang boven kinderen als ze dezelfde naam delen.

In het volgende voorbeeld wordt een `Class.Folder` genaamd `Color` toegevoegd aan een
`Class.Part`, die ook de `Class.Part.Color` eigenschap heeft. Merk op dat
`part.Color` verwijst naar de `Datatype.Color3` eigenschapswaarde, niet de kind
`Class.Folder` instantie. Een voordeel van het gebruik van
`Class.Instance:FindFirstChild()|FindFirstChild()` is dat de introductie van nieuwe
 eigenschappen geen risico voor je code met zich meebrengt.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- De eigenschap
local c2 = part:FindFirstChild("Color")  -- De kindmap
```

#### Prestatie Opmerkingen

`Class.Instance:FindFirstChild()|FindFirstChild()` duurt ongeveer 20% langer
 dan het gebruik van de punt operator en bijna 8 keer langer dan simpelweg het opslaan
 van een referentie naar een object. Daarom moet je het vermijden om het aan te roepen in
 prestatie-afhankelijke code zoals in strakke lussen of functies die zijn verbonden
 met `Class.RunService.Heartbeat` en `Class.RunService.PreRender`. In plaats daarvan,
 sla het resultaat op in een variabele, of overweeg om
 `Class.Instance.ChildAdded|ChildAdded` of
 `Class.Instance:WaitForChild()|WaitForChild()` te gebruiken om te detecteren wanneer een kind van een
gegeven naam beschikbaar wordt.


Instance:FindFirstChild

De `Class.Instance.Name` die moet worden doorzocht.


recursive

Of de zoekopdracht recursief moet worden uitgevoerd.


Retourneert het eerste kind van de `Class.Instance` gevonden met de gegeven naam.


Instance:findFirstChild

Retourneert het eerste kind van de `Class.Instance` wiens
`Class.Object.ClassName|ClassName` gelijk is aan de gegeven `className`.
In tegenstelling tot `Class.Instance:FindFirstChildWhichIsA()`, retourneert deze methode alleen
objecten wiens klasse overeenkomt met `className`, waarbij klasse overerving wordt genegeerd. Als er geen
overeenkomend kind wordt gevonden, retourneert deze methode `nil`.


Instance:FindFirstChildOfClass

Retourneert het eerste kind van de `Class.Instance` wiens
`Class.Object.ClassName|ClassName` gelijk is aan de gegeven class naam.


Instance

`Instance` is de basis klasse voor alle klassen in de Roblox klasse hiërarchie
waarvan de onderdelen deel kunnen uitmaken van de `Class.DataModel` boom.


/reference/engine/classes/BillboardGui.yaml

Samenvatting