Biedt programmatic toegang tot de
[Scene Analysis](/performance-optimization/scene-analysis) tool's
onderliggende prestatiegegevens.


Geeft de geladen animatieclipgeheugen terug. Hetzelfde asset dat door meerdere
Animators wordt gedeeld, verschijnt slechts één keer, met alle eigenaren vermeld.

#### Root woordenboek

| Sleutel     | Type   | Beschrijving                                                      |
| ----------- | ------ | ---------------------------------------------------------------- |
| `Name`      | string | Altijd `"AnimationMemory"`.                                      |
| `Size`      | number | Totaal geladen clipgeheugen in bytes.                               |
| `Children`  | array  | Array van clipvermeldingen en optioneel een out-of-data modelgroep. |

#### Clipvermelding

Elke child in `Children` is ofwel een clipvermelding of de "niet in datamodel"
groep (zie hieronder).

| Sleutel     | Type   | Beschrijving                                                 |
| ----------- | ------ | ----------------------------------------------------------- |
| `Name`      | string | De asset ID (bijv. `"rbxassetid://111"`).                   |
| `Size`      | number | Clipgeheugen in bytes.                                       |
| `AssetId`   | string | De asset ID-string (zelfde waarde als `Name`).                 |
| `Owners`    | array  | Array van eigenaarvermeldingen voor alle Animators die deze clip afspelen. |

#### Eigenaarvermelding

| Sleutel         | Type   | Beschrijving                                                                  |
| --------------- | ------ | ---------------------------------------------------------------------------- |
| `Name`          | string | Volledige pad naar de eigenaar Animator (bijv. `"Workspace.NPC.Humanoid.Animator"`). |
| `ClassName`     | string | Klassennaam van de eigenaar (bijv. `"Animator"`).                                 |

#### "Niet in datamodel" groep

Clips van Animators die alleen door Lua worden vastgehouden (niet in het datamodel) worden
verzameld in een enkele groepsvermelding.

| Sleutel     | Type   | Beschrijving                                   |
| ----------- | ------ | --------------------------------------------- |
| `Name`      | string | Altijd `"Not In DataModel"`.                  |
| `Size`      | number | Som van clipbytes in deze groep.              |
| `Children`  | array  | Array van clipvermeldingen (zelfde schema als hierboven). |

#### Voorbeeld

```lua
{
  Name = "AnimationMemory",
  Size = 1048576,
  Children = {
    { Name = "rbxassetid://111", Size = 32768, AssetId = "rbxassetid://111",
      Owners = {
        { Name = "Workspace.Player.Humanoid.Animator", ClassName = "Animator" },
    }},
    { Name = "rbxassetid://444", Size = 65536, AssetId = "rbxassetid://444",
      Owners = {
        { Name = "Workspace.NPC1.Humanoid.Animator", ClassName = "Animator" },
        { Name = "Workspace.NPC2.Humanoid.Animator", ClassName = "Animator" },
    }},
    { Name = "Not In DataModel", Size = 32768, Children = {
        { Name = "rbxassetid://555", Size = 32768, AssetId = "rbxassetid://555",
          Owners = {
            { Name = "Animator", ClassName = "Animator" },
        }},
    }},
  }
}
```


SceneAnalysisService:GetAnimationMemoryAsync

Een woordenboekboom van geladen animatieclipgeheugen, gededupliceerd per
clip.


Geeft het geladen audio assetgeheugen terug, gededupliceerd per asset ID. Assets waarvan
de eigenaren dezelfde ouder delen, zijn georganiseerd onder dat ouderpad —
afgevlakt wanneer er één kind is, genest wanneer er meerdere zijn. Assets
waarvan de eigenaren verschillende ouders beslaan, verschijnen als gedeelde vermeldingen met een
`Owners` array.

#### Root woordenboek

| Sleutel     | Type   | Beschrijving                                             |
| ----------- | ------ | ------------------------------------------------------- |
| `Name`      | string | Altijd `"AudioMemory"`.                                 |
| `Size`      | number | Totaal geladen audiogeheugen in bytes.                     |
| `Children`  | array  | Mix van platte vermeldingen, oudergroepen en gedeelde vermeldingen. |

#### Platte assetvermelding

Wordt uitgegeven wanneer een ouder precies één audio-kind heeft.

| Sleutel     | Type   | Beschrijving                                          |
| ----------- | ------ | ---------------------------------------------------- |
| `Name`      | string | Volledige instantiepad (bijv. `"Workspace.Map.BGMusic"`). |
| `Size`      | number | Assetgeheugen in bytes.                               |
| `AssetId`   | string | De audio asset ID.                                  |

#### Ouder groep

Wordt uitgegeven wanneer een ouder meerdere audio-kinderen heeft.

| Sleutel     | Type   | Beschrijving                                                        |
| ----------- | ------ | ------------------------------------------------------------------ |
| `Name`      | string | Ouderpad (bijv. `"Workspace.Map.SFX"`).                          |
| `Size`      | number | Som van kindassetbytes.                                          |
| `Children`  | array  | Array van platte assetvermeldingen (elk met `Name`, `Size`, `AssetId`). |

#### Gedeelde assetvermelding

Wordt uitgegeven wanneer de eigenaren van een asset onder verschillende ouders staan.

| Sleutel     | Type   | Beschrijving                                 |
| ----------- | ------ | ------------------------------------------- |
| `Name`      | string | De asset ID.                               |
| `Size`      | number | Assetgeheugen in bytes.                      |
| `AssetId`   | string | De asset ID-string (zelfde waarde als `Name`). |
| `Owners`    | array  | Array van eigenaarvermeldingen.                     |

#### Eigenaarvermelding

| Sleutel         | Type   | Beschrijving                                            |
| --------------- | ------ | ------------------------------------------------------ |
| `Name`          | string | Volledige instantiepad (bijv. `"Workspace.Zone1.Ambient"`). |
| `ClassName`     | string | `"Sound"` of `"AudioPlayer"`.                          |

#### Voorbeeld

```lua
{
  Name = "AudioMemory",
  Size = 5242880,
  Children = {
    -- Enkele audio onder unieke ouder (plat)
    { Name = "Workspace.Map.BGMusic", Size = 2097152,
      AssetId = "rbxassetid://111" },

    -- Meerdere audio onder dezelfde ouder (groeperen)
    { Name = "Workspace.Map.SFX", Size = 1048576, Children = {
        { Name = "Workspace.Map.SFX.Explosion", Size = 524288, AssetId = "rbxassetid://222" },
        { Name = "Workspace.Map.SFX.Gunshot",   Size = 524288, AssetId = "rbxassetid://333" },
    }},

    -- Gedeeld asset (eigenaren in verschillende locaties)
    { Name = "rbxassetid://444", Size = 2097152, AssetId = "rbxassetid://444",
      Owners = {
        { Name = "Workspace.Zone1.Ambient", ClassName = "Sound" },
        { Name = "Workspace.Zone2.Ambient", ClassName = "Sound" },
    }},
  }
}
```


SceneAnalysisService:GetAudioMemoryAsync

Een woordenboekboom van geladen audio assetgeheugen, gededupliceerd per asset
ID.


Geeft instantieaantallen per categorie en klasse terug vanuit de datamodelboom.
Scant afstammelingen van Workspace, Players, Lighting, MaterialService,
ReplicatedFirst, ReplicatedStorage, ServerScriptService, ServerStorage,
StarterGui, StarterPack, StarterPlayer, Teams, SoundService, en
TextChatService. Elke instantie wordt geclassificeerd in een van de categorieën
hieronder op basis van zijn klassehiërarchie.

#### Root woordenboek

| Sleutel     | Type   | Beschrijving                                       |
| ----------- | ------ | ------------------------------------------------- |
| `Name`      | string | Altijd `"InstanceComposition"`.                   |
| `Size`      | number | Totaal aantal instanties over alle gescande services. |
| `Children`  | array  | Array van categorievermeldingen.                        |

#### Categorievermelding

| Sleutel     | Type   | Beschrijving                       |
| ----------- | ------ | --------------------------------- |
| `Name`      | string | Categorie naam (zie tabel hieronder).  |
| `Size`      | number | Totaal aantal instanties in deze categorie. |
| `Children`  | array  | Array van klassevermeldingen.           |

#### Klassevermelding (blad)

| Sleutel    | Type   | Beschrijving                                            |
| ---------- | ------ | ------------------------------------------------------ |
| `Name`     | string | De klassenaam (bijv. `"Part"`, `"Script"`, `"Frame"`). |
| `Size`     | number | Aantal instanties van deze klasse.                     |

#### Categorieën

| Categorie           | Vertegenwoordigende Typen                                                                 |
| ------------------- | -------------------------------------------------------------------------------------- |
| 3D Objecten         | BasePart, Model, Camera                                                              |
| Fysica              | Attachment, Constraint, JointInstance, WeldConstraint, ControllerManager, SensorBase |
| UI                  | GuiBase, BasePlayerGui, UIBase, ProximityPrompt, ClickDetector, TextChannel          |
| Lichten             | Light                                                                                |
| PostProcessing      | PostEffect, Highlight, Atmosphere, Sky, Clouds                                       |
| Scripts             | LuaSourceContainer, BindableEvent, RemoteEvent, RemoteFunction                       |
| Audio               | Sound, SoundEffect, AudioPlayer, Wire, SoundGroup, AudioEmitter                      |
| Animatie           | Animator, AnimationController, Animation, KeyframeSequence, IKControl                |
| Waarden             | ValueBase                                                                            |
| Karakter            | CharacterAppearance, Humanoid, HumanoidDescription, BaseWrap, FaceControls           |
| Texturen            | FaceInstance, SurfaceAppearance, MaterialVariant                                     |
| Meshes              | DataModelMesh                                                                        |
| Deeltjes            | ParticleEmitter, Fire, Trail, Beam, Explosion                                        |
| Services & Opslag   | Player, Folder, Configuration                                                        |
| Diversen            | Tool, Backpack, Team, ForceField, PathfindingModifier, PackageLink, HapticEffect     |
| Ongesorteerd        | Alles wat niet overeenkomt met het bovenstaande                                          |

#### Voorbeeld

```lua
{
  Name = "InstanceComposition",
  Size = 12450,
  Children = {
    { Name = "3D Objects", Size = 5200, Children = {
        { Name = "Part", Size = 3100 },
        { Name = "MeshPart", Size = 1800 },
        { Name = "Model", Size = 300 },
    }},
    { Name = "UI", Size = 2100, Children = {
        { Name = "Frame", Size = 900 },
        { Name = "TextLabel", Size = 700 },
        { Name = "UIListLayout", Size = 500 },
    }},
  }
}
```


SceneAnalysisService:GetInstanceCompositionAsync

Een woordenboekboom van instantieaantallen gegroepeerd per categorie en klassenaam.


Geeft per-script Luau VM heapgeheugenverbruik in bytes terug. Scripts worden eerst gegroepeerd
op basis van hun beherende service (afgeleid van het eerste segment van het
dotted pad), en vervolgens gesplitst in `"ModuleScripts"` en `"Scripts"` subgroepen
op basis van de klasse van de instantie.

#### Root woordenboek

| Sleutel     | Type   | Beschrijving                        |
| ----------- | ------ | ---------------------------------- |
| `Name`      | string | Altijd `"ScriptMemory"`.           |
| `Size`      | number | Totaal Luau VM-geheugen in bytes.     |
| `Children`  | array  | Array van servicecategorievermeldingen. |

#### Servicecategorievermelding

| Sleutel     | Type   | Beschrijving                                                                  |
| ----------- | ------ | ---------------------------------------------------------------------------- |
| `Name`      | string | Servicenaam (bijv. `"ServerScriptService"`, `"ReplicatedStorage"`).          |
| `Size`      | number | Som van al het scriptgeheugen in deze service, in bytes.                          |
| `Children`  | array  | Een of twee script-type groepvermeldingen (`"ModuleScripts"` en/of `"Scripts"`). |

#### Script-type groepvermelding

| Sleutel     | Type   | Beschrijving                                        |
| ----------- | ------ | -------------------------------------------------- |
| `Name`      | string | Ofwel `"ModuleScripts"` of `"Scripts"`.           |
| `Size`      | number | Som van het geheugen voor scripts in deze groep, in bytes. |
| `Children`  | array  | Array van individuele scriptvermeldingen.                |

#### Scriptvermelding (blad)

| Sleutel    | Type   | Beschrijving                                                            |
| ---------- | ------ | ---------------------------------------------------------------------- |
| `Name`     | string | Dotted pad naar het script (bijv. `"ServerScriptService.Shared.Utils"`). |
| `Size`     | number | Heapgeheugen gebruikt door dit script, in bytes.                             |

#### Voorbeeld

```lua
{
  Name = "ScriptMemory",
  Size = 8388608,
  Children = {
    { Name = "ServerScriptService", Size = 524288, Children = {
        { Name = "ModuleScripts", Size = 409600, Children = {
            { Name = "ServerScriptService.Shared.Utils", Size = 204800 },
            { Name = "ServerScriptService.Shared.Config", Size = 204800 },
        }},
        { Name = "Scripts", Size = 114688, Children = {
            { Name = "ServerScriptService.MainScript", Size = 114688 },
        }},
    }},
    { Name = "ReplicatedStorage", Size = 262144, Children = {
        { Name = "ModuleScripts", Size = 262144, Children = {
            { Name = "ReplicatedStorage.SharedModule", Size = 262144 },
        }},
    }},
  }
}
```


SceneAnalysisService:GetScriptMemoryAsync

Een woordenboekboom van per-script Luau VM heapgeheugen gegroepeerd per service
en scripttype.


Geeft het aantal driehoeken en tekenoproepen per renderpass terug, afkomstig van
`StatsService` prestatiegegevens. In tegenstelling tot andere queries, gebruikt dit een `Sizes`
woordenboek (met `Triangles` en `Drawcalls` sleutels) in plaats van een enkele
`Size` veld. Renderpassvermeldingen met nul driehoeken en nul tekenoproepen
worden weggelaten.

#### Root woordenboek

| Sleutel     | Type       | Beschrijving                                                            |
| ----------- | ---------- | ---------------------------------------------------------------------- |
| `Name`      | string     | Altijd `"TriangleComposition"`.                                        |
| `Sizes`     | dictionary | `{ Triangles: number, Drawcalls: number }` — totalen over alle passes. |
| `Children`  | array      | Array van renderpassvermeldingen.                                          |

#### Renderpassvermelding (blad)

| Sleutel     | Type       | Beschrijving                                               |
| ----------- | ---------- | --------------------------------------------------------- |
| `Name`      | string     | Renderpasstype (zie tabel hieronder).                       |
| `Sizes`     | dictionary | `{ Triangles: number, Drawcalls: number }` voor deze pass. |

#### Renderpasstypes

| Naam               | Beschrijving                    |
| ------------------ | ------------------------------ |
| Opaque             | Opaque geometrie                |
| Transparent        | Transparante geometrie           |
| Terrain            | Voxel/smooth terrein           |
| Grass              | Terrain grasdecoratie       |
| UI                 | Schermruimte UI                |
| Decal              | Decal rendering                |
| Cloud              | Volumetrische wolken              |
| GenericPostProcess | Algemene post-processing        |
| SSAO               | Screen-space ambient occlusion |
| DOF                | Diepte van veld                 |
| Deeltjes           | Deeltjesystemen               |
| Sky                | Skybox                         |
| Schaduwen          | Schaduwkaart rendering           |
| Ongedefinieerd     | Ongesorteerd                  |

#### Voorbeeld

```lua
{
  Name = "TriangleComposition",
  Sizes = { Triangles = 245000, Drawcalls = 1200 },
  Children = {
    { Name = "Opaque",      Sizes = { Triangles = 180000, Drawcalls = 800 } },
    { Name = "Transparent", Sizes = { Triangles = 25000,  Drawcalls = 150 } },
    { Name = "Shadows",     Sizes = { Triangles = 30000,  Drawcalls = 200 } },
    { Name = "UI",          Sizes = { Triangles = 10000,  Drawcalls = 50  } },
  }
}
```


SceneAnalysisService:GetTriangleCompositionAsync

Een woordenboekboom van het aantal driehoeken en tekenoproepen uitgesplitst per
renderpasstype.


Geeft instanties terug die door Luau worden vastgehouden maar niet langer in het datamodel zijn, gegroepeerd per
hostscript. Elke niet-geparent instantie wordt teruggetraceerd naar het script dat
de referentie vasthoudt.

Niet-geparent instanties die zijn gemarkeerd voor garbage collection maar nog niet
verwijderd zijn, worden tijdelijk weergegeven met een ouder van `Unknown`. Dit is een bijeffect
van hoe garbage collection bedoeld is om te werken en niet indicatief voor
problemen.

#### Root woordenboek

| Sleutel     | Type   | Beschrijving                          |
| ----------- | ------ | ------------------------------------ |
| `Name`      | string | Altijd `"UnparentedInstances"`.      |
| `Size`      | number | Totaal aantal niet-geparent instanties. |
| `Children`  | array  | Array van hostscriptvermeldingen.        |

#### Hostscriptvermelding

| Sleutel         | Type   | Beschrijving                                                                                 |
| --------------- | ------ | ------------------------------------------------------------------------------------------- |
| `Name`          | string | Scriptpad (bijv. `"ServerScriptService.Gameplay.Combat"`) of `"(unknown)"` als niet-traceerbaar. |
| `Size`          | number | Aantal niet-geparent instanties die door dit script worden vastgehouden.                                          |
| `Children`      | array  | Array van klassevermeldingen.                                                                     |

#### Klassevermelding (blad)

| Sleutel    | Type   | Beschrijving                                                                  |
| ---------- | ------ | ---------------------------------------------------------------------------- |
| `Name`     | string | Klassennaam van de niet-geparent instantie (bijv. `"Part"`, `"Frame"`, `"Sound"`). |
| `Size`     | number | Aantal niet-geparent instanties van deze klasse vanuit dit hostscript.           |

#### Voorbeeld

```lua
{
  Name = "UnparentedInstances",
  Size = 47,
  Children = {
    { Name = "ServerScriptService.Gameplay.Combat", Size = 30, Children = {
        { Name = "Part", Size = 22 },
        { Name = "Attachment", Size = 8 },
    }},
    { Name = "(unknown)", Size = 17, Children = {
        { Name = "Frame", Size = 12 },
        { Name = "Sound", Size = 5 },
    }},
  }
}
```


SceneAnalysisService:GetUnparentedInstancesAsync

Een woordenboekboom van niet-geparent instanties gegroepeerd per hostscript
dat de referentie vasthoudt.


SceneAnalysisService

`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.


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

Als er geen overeenkomend kind wordt gevonden, retourneert deze methode `nil`. Als het optionele
recursieve argument waar is, zoekt deze methode door alle afstammelingen in plaats
van alleen de directe kinderen van de `Class.Instance`.

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

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

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Ontwikkelaars die naar een kind zoeken op naam, moeten
`Class.Instance:FindFirstChild()` in plaats daarvan gebruiken.


Instance:FindFirstChildWhichIsA

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


Retourneert de eerste afstammeling die is gevonden met de gegeven `Class.Instance.Name`.

Deze methode is uitgeschakeld en kan niet worden gebruikt. Om de eerste afstammeling
van een instantie te vinden, overweeg om de `recursieve` parameter op
`Class.Instance:FindFirstChild()` in plaats daarvan te gebruiken.


Instance:FindFirstDescendant

De `Class.Instance.Name` om naar te zoeken.


Retourneert de eerste afstammeling die is gevonden met de gegeven `Class.Instance.Name`.


Als de `Class.Instance` een `Class.Actor` is, wordt de `Class.Actor` zelf
teruggegeven. Anders wordt de dichtstbijzijnde voorouder `Class.Actor` teruggegeven. Als er geen
voorouder een `Class.Actor` is, is het resultaat `nil`.


Instance:GetActor

Retourneert de `Class.Actor` die aan de instantie is gekoppeld, indien aanwezig.


Deze methode retourneert de waarde die is toegewezen aan de gegeven
attribuutnaam. Als er geen attribuut is toegewezen, wordt `nil` geretourneerd.

Bijvoorbeeld, de volgende codefragment stelt de waarde in en haalt vervolgens de waarde van
de instantie's `InitialPosition` attribuut op:

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

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

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

#### Zie Ook

- `Class.Instance:SetAttribute()` die het attribuut met de gegeven
  naam instelt op de gegeven waarde.
- `Class.Instance:GetAttributes()` die een woordenboek van sleutel-waarde
  paren retourneert voor elk van de instanties attributen.


Instance:GetAttribute

De naam van het attribuut dat wordt opgehaald.


De waarde die is toegewezen aan de gegeven attribuutnaam. Als er geen
attribuut is toegewezen, wordt `nil` geretourneerd.


Retourneert de waarde die is toegewezen aan de gegeven attribuutnaam.


Deze methode retourneert een gebeurtenis die zich precies gedraagt als de
`Class.Object.Changed|Changed` gebeurtenis, behalve dat deze alleen wordt geactiveerd wanneer het
specifieke gegeven attribuut verandert; effectief is het vergelijkbaar met
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` maar
voor attributen.

Het is over het algemeen een goed idee om deze methode te gebruiken in plaats van een verbinding met
`Class.Object.Changed|Changed` met een functie die de attribuutnaam controleert. Volgende aanroepen van deze methode op hetzelfde object met dezelfde
attribuutnaam retourneren hetzelfde evenement.

Het volgende codevoorbeeld retourneert een signaal dat de functie
`attributeChanged()` activeert wanneer het attribuut `InitialPosition` van het onderdeel verandert:

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

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

local function attributeChanged()
	print("Attribuut veranderd")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Zie ook `Class.Instance.AttributeChanged` die wordt geactiveerd wanneer elk
attribuut op de instantie verandert.


Instance:GetAttributeChangedSignal

De naam van het gespecificeerde attribuut waarvoor het wijzigingssignaal
wordt geretourneerd.


Een gebeurtenis die wordt geactiveerd wanneer het gegeven attribuut verandert.


Retourneert een gebeurtenis die wordt geactiveerd wanneer het gegeven attribuut verandert.


Deze methode retourneert een woordenboek van sleutel-waarde paren voor elk attribuut
waarbij de sleutel de naam van het attribuut is en de waarde een niet-`nil` waarde.

Bijvoorbeeld, de volgende codefragment geeft de attributen en waarden van een instantie weer:

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

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

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Zie ook `Class.Instance:GetAttribute()` die de waarde retourneert die is
toegewezen aan de gegeven attribuutnaam.


Instance:GetAttributes

Een woordenboek van string → variant paren voor elk attribuut waarbij de
string de naam van het attribuut is en de variant een niet-nil
waarde.


Retourneert een woordenboek van de attributen van de instantie.


Het onderstaande zou de naam van alle objecten die momenteel in Workspace zijn afdrukken wanneer het wordt uitgevoerd.


Retourneert een array (een numeriek geïndexeerde tabel) met al de
directe kinderen van de instantie, of elke `Class.Instance` wiens
`Class.Instance.Parent|Parent` gelijk is aan het object. De array kan
worden doorlopen met behulp van een numerieke of generieke `for`-lus:

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

-- Voorbeeld van numerieke lus
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " is kind nummer " .. i)
end
```

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

-- Voorbeeld van generieke lus
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is kind nummer " .. i)
end
```
Merk op dat de geretourneerde array **niet** in een bepaalde volgorde is gesorteerd, dus
handmatige sortering (bijvoorbeeld met `Library.table.sort()`) wordt aanbevolen voor
het sorteren van de kinderen die door deze methode worden geretourneerd.

Zie ook de `Class.Instance:GetDescendants()|GetDescendants()` methode.


Instance:GetChildren

Een array met de kinderen van de instantie.


Retourneert een array met al de kinderen van de instantie.


Instance:getChildren

Retourneert een gecodeerde string van de debug ID die intern door Roblox wordt gebruikt. Let op:

- Dit item is beschermd. Proberen het te gebruiken in een `Class.Script` of
  `Class.LocalScript` zal een fout veroorzaken.
- Een debug ID is een ID die wordt gebruikt in debugprocessen. Het stelt een debugger in staat om
  elke instructie te lezen voordat een applicatie deze verwerkt. Alle objecten in
  Roblox fungeren als processen en elke run-instructies (of 'code') die indien nodig
  kan worden gedebugd.
- Dit kan nuttig zijn voor plugins die vergelijkbare objecten van elkaar moeten onderscheiden
  (zoals objecten die dezelfde naam delen).


Instance:GetDebugId

scopeLength

Retourneert een gecodeerde string van de debug ID die intern door Roblox wordt gebruikt.


GetDescendants wordt vaak gebruikt om iets te doen met alle afstammelingen die een
bepaalde type object zijn. De code in dit voorbeeld gebruikt GetDescendants en
`Class.Instance:IsA()` om alle onderdelen in de workspace te vinden en maakt
hun kleur groen.


Deze objectmethode retourneert een array die alle afstammelingen van dat object bevat. In tegenstelling tot `Class.Instance:GetChildren()`, die alleen de directe kinderen van een object retourneert, vindt deze methode elk kind van het object, elk kind van die kinderen, enzovoort.

Merk op dat de geretourneerde array **niet** in een bepaalde volgorde is gesorteerd, dus
handmatige sortering (bijvoorbeeld met `Library.table.sort()`) wordt aanbevolen voor
het sorteren van de afstammelingen die door deze methode worden geretourneerd. Overweeg ook de
`Class.Instance:QueryDescendants()|QueryDescendants()` methode om afstammelingen te queryen op basis van een combinatie van selectors en combinatoren.


Instance:GetDescendants

Een array met de afstammelingen van de instantie.


Retourneert een array met al de afstammelingen van de instantie.


Dit codevoorbeeld demonstreert het gedrag van `Class.Instance:GetFullName()`.
Het laat zien hoe de functie zich gedraagt wanneer deze wordt aangeroepen op een object dat niet in de
`DataModel` hiërarchie staat, en het toont ook aan hoe de retourwaarde geen
speciale tekens ontsnapt.


Dit codevoorbeeld herimplementeert de `Class.Instance:GetFullName()` functie in
Lua.


Retourneert een string die de afstamming van de instantie beschrijft. De string is een
concatenatie van de `Class.Instance.Name|Name` van het object en zijn
voorouders, gescheiden door punten. De `Class.DataModel` (`game`) wordt niet
beschouwd. Bijvoorbeeld, een `Class.Part` in de `Class.Workspace` kan
`Class.Workspace.Part` retourneren.

Wanneer deze methode wordt aangeroepen op een `Class.Instance` die geen afstammeling is van de
`Class.DataModel`, beschouwt deze methode alle voorouders tot en met de bovenste zonder een
`Class.Instance.Parent|Parent`.

Deze methode is nuttig voor logging en debugging. Je moet niet proberen de geretourneerde string te parseren voor enige nuttige operatie; deze methode ontsnapt geen punten (of enig ander symbool) in objectnamen. Met andere woorden,
hoewel de uitvoer vaak lijkt op een geldige Luau-identificator, is het niet
gegarandeerd.


Instance:GetFullName

De volledige naam van de `Class.Instance`.


Retourneert een string die de afstamming van de instantie beschrijft.


Deze methode retourneert de gestyleerde of expliciet gewijzigde waarde van de
opgegeven eigenschap, of anders de standaard eigenschapswaarde als deze niet is
gestyled/wijzigd. Dit verschilt iets van het direct benaderen van de eigenschapswaarde,
zoals `[GuiObject].Rotation`, die de standaard of gewijzigde waarde van de eigenschap retourneert.


Instance:GetStyled

selector

Optionele selector voor de pseudo-instantie waarop je richt op de
instantie.


De gestyleerde of expliciet gewijzigde waarde van de opgegeven eigenschap, of
anders de standaard eigenschapswaarde als deze niet is gestyled/wijzigd.


Retourneert de gestyleerde of expliciet gewijzigde waarde van de opgegeven eigenschap,
of anders de standaard eigenschapswaarde als deze niet is gestyled/wijzigd.


Toont `Class.Instance:GetStyledPropertyChangedSignal()`.


Deze methode retourneert een gebeurtenis die zich precies gedraagt als de
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` gebeurtenis,
behalve dat deze alleen wordt geactiveerd wanneer de gegeven stijl eigenschap verandert. Het is
generaal een goed idee om deze methode te gebruiken in plaats van een verbinding met
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` met een
functie die de eigenschapsnaam controleert. Volgende aanroepen van deze methode op
dezelfde object met dezelfde eigenschapsnaam retourneren hetzelfde evenement.

Merk op dat deze gebeurtenis geen argumenten doorgeeft aan een verbonden functie,
waardoor de waarde van de gewijzigde eigenschap direct binnen een
script moet worden gelezen.


Instance:GetStyledPropertyChangedSignal

property

Naam van de stijl eigenschap waarvoor naar wijzigingen moet worden geluisterd.


Gebeurtenis die wordt geactiveerd wanneer de gegeven stijl eigenschap verandert.


Retourneert een gebeurtenis die wordt geactiveerd wanneer de gegeven stijl eigenschap verandert op de
instantie.


Deze methode retourneert een array van de tags die op de gegeven instantie zijn toegepast, als
strings. Je kunt tags toevoegen in Studio in het
[Eigenschappen](/studio/properties) venster of tijdens runtime met
`Class.Instance:AddTag()|AddTag()`.

Deze methode is nuttig wanneer je iets met meerdere tags op
een instantie tegelijk wilt doen. Het is echter inefficiënt om deze methode te gebruiken om
te controleren op het bestaan van een enkele tag; gebruik in plaats daarvan
`Class.Instance:HasTag()|HasTag()` om te controleren op een specifieke tag.


Instance:GetTags

Een array van strings, elk die een tag vertegenwoordigt die op de instantie is toegepast.


Krijgt een array van alle tags die op de instantie zijn toegepast.


Deze methode retourneert `true` als de opgegeven tag aan het
object is toegevoegd. Je kunt tags toevoegen in Studio in het
[Eigenschappen](/studio/properties) venster of tijdens runtime met
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

De tag om te controleren op de instantie.


`true` als de instantie de gegeven tag heeft, `false` anders.


Controleert of de instantie een gegeven tag heeft.


Toont aan hoe te bepalen of de ene instantie de voorouder van een andere is met behulp van
`Class.Instance:IsAncestorOf()`

Workspace en SpawnLocation zijn voorouders van de decal van SpawnLocation.
Workspace is een voorouder van SpawnLocation.

SpawnLocation en zijn decal zijn afstammelingen van Workspace, geen voorouders.
Decal is een afstammeling van SpawnLocation, geen voorouder.


Retourneert true als een `Class.Instance` een voorouder is van de gegeven
afstammeling.

Een `Class.Instance` wordt als de voorouder van een object beschouwd als de
`Class.Instance.Parent` van het object of een van zijn ouders
`Class.Instance.Parent` is ingesteld op de `Class.Instance`.

Zie ook, `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

Waar als de `Class.Instance` een voorouder is van de gegeven afstammeling.


Retourneert true als een `Class.Instance` een voorouder is van de gegeven
afstammeling.


Retourneert `true` als een `Class.Instance` een afstammeling is van de gegeven
voorouder.

Merk op dat `IsDescendantOf()` niet kan worden gebruikt met een parameter van `nil` om
te controleren of een object is verwijderd.

Zie ook `Class.Instance:IsAncestorOf()`.


Instance:IsDescendantOf

ancestor

Waar als de `Class.Instance` een afstammeling is van de gegeven voorouder.


Retourneert `true` als een `Class.Instance` een afstammeling is van de gegeven
voorouder.


Instance:isDescendantOf

Deze methode geeft aan of een specifieke eigenschap is gewijzigd ten opzichte van
de code-geïnstantieerde standaard. Als deze wordt aangeroepen op een instantie die nieuw is gemaakt via
code (`Datatype.Instance.new()`), retourneert deze methode `false`. Als
het wordt aangeroepen op een object dat nieuw is gemaakt door Studio-workflows zoals
[Explorer](/studio/explorer) vensterinvoeging, kan het resultaat verschillen.

Bijvoorbeeld, het opvragen van de
`Class.TextLabel.BackgroundColor3|BackgroundColor3` eigenschap van een
`Class.TextLabel` die is ingevoegd via het [Explorer](/studio/explorer)
zal `true` retourneren, maar het opvragen van dezelfde eigenschap van een `Class.TextLabel`
gecreëerd via `Datatype.Instance.new()` zal `false` retourneren, ervan uitgaande dat er geen
andere wijzigingen zijn aangebracht in zijn
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Merk op dat deze methode alleen nuttige resultaten retourneert voor services en
gebruikers-creëerbare instanties. Retourneerwaarden voor systeem-gepopulate eigenschappen van
instanties zoals `Class.PackageLink` is ongedefinieerd gedrag.

Merk ook op dat als deze methode `true` retourneert, styling **geen** invloed zal hebben op
de eigenschap omdat het expliciet wijzigen van een eigenschap voorrang heeft boven
het stylen ervan. Om een eigenschap terug te zetten naar de code-geïnstantieerde standaard en
styling ervan toe te staan, gebruik
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Boolean die aangeeft of de eigenschap is gewijzigd ten opzichte van zijn
code-geïnstantieerde standaard.


Retourneert `true` als de waarde die is opgeslagen in de opgegeven eigenschap niet gelijk is
tot de code-geïnstantieerde standaard.


Deze objectmethode retourneert een array die alle afstammelingen van het
object bevat die overeenkomen met de opgegeven `selector` string. `selector` kan meerdere
selectors en combinatoren bevatten om kenmerken zoals de
klassenaam, instantienaam en hiërarchische relaties te matchen, evenals
specifieke waarden van instantie-eigenschappen en attributen. De `selector`
grammatica is vergelijkbaar met die gebruikt in `Class.StyleRule`, met slechts een paar
verschillen met betrekking tot welke delen van de grammatica worden ondersteund of niet.

#### Selectors

- `ClassName` — Matcht instanties van de opgegeven klasse in een
  `Class.Object:IsA()` relatie.
- `.Tag` — Matcht instanties die zijn getagd met een `Class.CollectionService` tag.
- `#Name` — Matcht instanties van een specifieke `Class.Instance.Name`.
- `[property = value]` — Matcht instanties die de opgegeven
  eigenschap hebben en die eigenschap heeft de opgegeven waarde. Boolean, nummer, en
  stringwaarden worden ondersteund. Letters, cijfers, `_`, en `-` kunnen worden gebruikt
  zonder de waarde tussen aanhalingstekens te plaatsen.
- `[$attribute]` — Matcht instanties die de opgegeven
  [attribuut](/studio/properties#instance-attributes) hebben ingesteld.
- `[$attribute = value]` — Matcht instanties die het opgegeven
  attribuut **en** dat attribuut heeft de opgegeven waarde. Dezelfde
  beperkingen zijn van toepassing als voor eigenschapselectors. Als je wilt controleren op
  de afwezigheid van een attribuut, query het dan niet als `nil`; gebruik in plaats daarvan de
  `:not` pseudo-klasse zoals in `:not([$attribute])`.

Selectors kunnen ook worden gecombineerd. Bijvoorbeeld,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` zal overeenkomen met instanties die een
`Class.Model` zijn getagd als `Apple` en die een `Variety` attribuut hebben
gelijk aan `Fuji` evenals een `Flavor` attribuut gelijk aan `4`.

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

-- Krijg alle MeshPart afstammelingen
print(Workspace:QueryDescendants("MeshPart"))

-- Krijg alle afstammelingen getagd als "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Krijg alle afstammelingen met de naam "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Krijg alle afstammelingen met de CanCollide eigenschap ingesteld op false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Krijg alle afstammelingen met een "FuelCapacity" attribuut toegewezen
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Krijg alle afstammelingen met een "FuelCapacity" attribuut ingesteld op 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Combinatoren

Combinatoren laten je basisselectors mixen om diepere hiërarchische
relaties te matchen.

- `>` — Matcht instanties die **directe kinderen** zijn van de vorige
  filterovereenkomsten.

- `>>` — Matcht instanties die **afstammelingen** zijn van de vorige filter
  overeenkomsten. Dit is de standaard eerste filter, wat betekent dat `SpotLight.Red`
  hetzelfde is als `>> SpotLight.Red`.

- `,` — Specificeert een lijst van meerdere onafhankelijke selectors voor de
  afstammelingquery. Alleen elementen die de filter matchen worden in de
  geretourneerde array geplaatst; `nil` zal niet worden opgenomen voor niet-overeenkomsten in een query
  lijst.

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

-- Krijg directe kinderen van elk Model die zijn getagd als "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Krijg directe kinderen die een Part zijn en zijn getagd als "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Krijg afstammelingen van elk Model met een attribuut "OnFire" ingesteld op true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Krijg MeshPart afstammelingen getagd als "SwordPart" OF met een attribuut "OnFire" ingesteld op true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Pseudo-klasse selectors

- `:not(complex-selector-list)` — Laat het selecteren van instanties die **niet**
  overeenkomen met een van de selectors binnenin, effectief een
  negatie van de selectors uitvoeren. Aangezien de expressie binnen een lijst van
  complexe selectors is, is het mogelijk om te filteren op basis van meerdere voorwaarden.

- `:has(relative-selector-list)` — Laat het selecteren van instanties op basis van
  welke instanties ze binnenin bevatten. De selectorlijst wordt geëvalueerd
  ten opzichte van elke instantie.

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

-- Krijg alle afstammelingen die NIET van klasse SpotLight zijn
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Krijg alle afstammelingen die NIET van klasse SpotLight OF PointLight zijn
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Krijg alle afstammelingen die GEEN attribuut "OnFire" hebben
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Krijg alle afstammelingen BEHALVE kinderen van een Model getagd als "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Krijg afstammelingen die een Tool-instantie als hun eigen afstammeling bevatten
print(Workspace:QueryDescendants(":has(Tool)"))
-- Krijg MeshPart afstammelingen die een direct kind bevatten dat is getagd als "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Krijg MeshPart afstammelingen met directe kinderen die NIET van SurfaceAppearance of Texture klasse zijn
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

Selector string die wordt gebruikt om elementen te filteren.


Een array van instanties (leeg als er niets overeenkomt met de selector).


Retourneert een array met al de afstammelingen van de instantie die overeenkomen met de
`selector` string.


De volgende code demonstreert hoe een onderdeel opnieuw kan worden toegevoegd aan het DataModel
after being removed:


Deze methode stelt de `Class.Instance.Parent` in op `nil`, en doet
t hetzelfde voor al zijn afstammelingen.

Als het object wordt verwezen voordat het wordt verwijderd, is het mogelijk om
het object op een later tijdstip op te halen.


Instance:Remove

Stelt de `Parent` van het object in op `nil`, en doet hetzelfde voor al zijn
afstammelingen.


Instance:remove

Deze methode verwijdert een tag van een instantie. Het genereert geen fout als
the object de tag niet heeft. Het succesvol verwijderen van een tag zal een
signaal activeren dat is gemaakt door `Class.CollectionService:GetInstanceRemovedSignal()`
met de gegeven tag.

Merk op dat bij het taggen van een instantie, het gebruikelijk is 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.


Instance:RemoveTag

De tag die van de instantie moet worden verwijderd.


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/SceneAnalysisService.yaml

Samenvatting