Een `Class.Texture` object past een herhalende afbeeldingsstructuur toe op de voorkant van een
ouder `Class.BasePart`. De aangetaste voorkant is afhankelijk van de
`Class.Texture.Face|Face` eigenschap. In tegenstelling tot `Class.Decal|Decals`, de structuur
toegepast door een `Class.Texture` zal herhalen wanneer de ouder `Class.BasePart` wordt
vergroten, waarbij de grootte van de herhalende structuren wordt bepaald door de
`Class.Texture.StudsPerTileU|StudsPerTileU` en
`Class.Texture.StudsPerTileV|StudsPerTileV` eigenschappen.

De toegepaste afbeeldingsstructuur wordt bepaald door de
`Class.Texture.ColorMapContent|ColorMapContent` eigenschap. Voor details over hoe
je afbeeldingen kunt uploaden, zie
[assetbeheer](/projects/assets#asset-management).

Voor meer informatie, bekijk
[texturen en decals](/parts/textures-decals). Zie ook:

- `Class.Decal` voor niet-herhalende oppervlakte-afbeeldingen.
- `Class.MeshPart.TextureContent` om een afbeeldingsstructuur toe te passen op een
  `Class.MeshPart`.
- `Class.SurfaceGui` om een `Class.ImageLabel` of `Class.ImageButton` toe te passen op
  een 3D-object in de ervaring.


Texture

Deze eigenschap bepaalt hoe ver de weergegeven structuur is verschoven op de
horizontale as, in studs, zoals gevisualiseerd
[hier](/parts/textures-decals#offset-textures).

Zie ook `Class.Texture.OffsetStudsV|OffsetStudsV`.


Texture.OffsetStudsU

Bepaalt de offset in studs van de horizontale coördinaat van de weergegeven structuur.


Deze eigenschap bepaalt hoe ver de weergegeven structuur is verschoven op de
verticale as, in studs, zoals gevisualiseerd
[hier](/parts/textures-decals#offset-textures).

Zie ook `Class.Texture.OffsetStudsU|OffsetStudsU`.


Texture.OffsetStudsV

Bepaalt de offset in studs van de verticale coördinaat van de weergegeven structuur.


Stelt de horizontale grootte, in studs, van de betegelde afbeelding in die door de
`Class.Texture` is toegepast.

Grotere waarden voor deze eigenschap zullen ervoor zorgen dat de `Class.Texture` groter lijkt,
en minder vaak herhaalt. In tegenstelling tot `Class.Decal|Decals`, is de grootte van de herhaalde afbeelding niet beïnvloed door de afmetingen van de
`Class.BasePart`. In plaats daarvan verhoogt het vergroten van de `Class.BasePart` alleen
het aantal keren dat de structuur herhaalt.

Let op dat deze eigenschap kan worden ingesteld op zeer lage waarden, maar niet op nul. Let ook op dat de horizontale/verticale onderscheiding relatief is ten opzichte van de ouder
`Class.BasePart` as; daarom zal de `Class.Texture` draaien samen met de `Class.BasePart`.

Zie ook `Class.Texture.StudsPerTileV|StudsPerTileV`.


Texture.StudsPerTileU

Stelt de horizontale grootte, in studs, van de betegelde afbeelding in die door de
`Class.Texture` is toegepast.


Stelt de verticale grootte, in studs, van de betegelde afbeelding in die door de
`Class.Texture` is toegepast.

Grotere waarden voor deze eigenschap zullen ervoor zorgen dat de `Class.Texture` groter lijkt,
en minder vaak herhaalt. In tegenstelling tot `Class.Decal|Decals`, is de grootte van de herhaalde afbeelding niet beïnvloed door de afmetingen van de
`Class.BasePart`. In plaats daarvan verhoogt het vergroten van de `Class.BasePart` alleen
het aantal keren dat de structuur herhaalt.

Let op dat deze eigenschap kan worden ingesteld op zeer lage waarden, maar niet op nul. Let ook op dat de horizontale/verticale onderscheiding relatief is ten opzichte van de ouder
`Class.BasePart` as; daarom zal de `Class.Texture` draaien samen met de `Class.BasePart`.

Zie ook `Class.Texture.StudsPerTileU|StudsPerTileU`.


Texture.StudsPerTileV

Stelt de verticale grootte, in studs, van de betegelde afbeelding in die door de
`Class.Texture` is toegepast.


Past een herhalende afbeeldingsstructuur toe op de voorkant van een ouder `Class.BasePart`.


De volgende code zal een `Part` op de grond creëren met een `Decal` toegepast
top zijn bovenste vlak. Wanneer iets de part raakt, zoals wanneer een speler eroverheen loopt,
zult de textuur die op de decal is toegepast veranderen en zal er een geluid worden afgespeeld.


De onderstaande code maakt een transparante `Part` met een decal die vervaagt
in en uit met behulp van `TweenService` en `Class.Decal.Transparency`.


Het `Class.Decal` object past een afbeeldingsstructuur toe op een vlak van een ouder
`Class.BasePart`. Het aangetaste vlak is afhankelijk van de
`Class.Decal.Face|Face` eigenschap, en de grootte van de decal is afhankelijk van
de grootte van het vlak.

De toegepaste afbeeldingsstructuur wordt bepaald door de
`Class.Decal.ColorMapContent|ColorMapContent` eigenschap. Voor details over hoe je
afbeeldingen kunt uploaden, zie
[assetbeheer](/projects/assets#asset-management).

Voor meer informatie, bekijk
[texturen en decals](/parts/textures-decals). Zie ook:

- `Class.Texture` voor herhalende oppervlakte-afbeeldingen.
- `Class.MeshPart.TextureContent` om een afbeeldingsstructuur toe te passen op een
  `Class.MeshPart`.
- `Class.SurfaceGui` om een `Class.ImageLabel` of `Class.ImageButton` toe te passen op
  een 3D-object in de ervaring.


Decal

Wanneer ingesteld op `true`, is de afbeeldingsasset van de decal in aanmerking
voor automatische lokalisatie via het Automatic Asset Capture-systeem. De
`Class.LocalizationService` gebruikt deze eigenschap om te bepalen of de
`Class.Decal.ColorMapContent|ColorMapContent` van de decal moet worden vastgelegd
en mogelijk vervangen door een gelokaliseerde versie.

Deze eigenschap is alleen van toepassing op niet-PBR decals. Als er PBR-mappen zijn
(`Class.Decal.NormalMapContent|NormalMapContent`,
`Class.Decal.RoughnessMapContent|RoughnessMapContent`,
`Class.Decal.MetalnessMapContent|MetalnessMapContent`, of
`Class.Decal.EmissiveMaskContent|EmissiveMaskContent`) zijn ingesteld, wordt automatische
lokalisatiecaptatie onderdrukt om inconsistente rendering te voorkomen.


Decal.AutoLocalize

Wanneer ingesteld op `true`, is de afbeeldingsasset van de decal in aanmerking
voor automatische lokalisatiecaptatie.


Dit codevoorbeeld maakt een `Decal` in de werkruimte en verandert zijn
`Class.Decal.Color3` eigenschap in een lus met behulp van `Class.TweenService`.


De `Datatype.Color3` tint van de `Class.Decal`. Let op dat deze eigenschap
alleen de **tint** van de decal instelt in plaats van de kleur; tenzij de
afbeelding die aan de `Class.Decal` is gekoppeld oorspronkelijk puur wit was, kan
de kleur niet vrijelijk worden veranderd met deze eigenschap.


Decal.Color3

De `Datatype.Color3` tint van de `Class.Decal`.


Deze eigenschap neemt een content-ID om de kleur en opaciteit van het
oppervlak te bepalen. Deze textuur wordt soms de **albedo** textuur genoemd.


Decal.ColorMap

Content-ID die de kleur en opaciteit van het oppervlak bepaalt.


Deze eigenschap neemt een `Datatype.Content` object om de kleur en
opaciteit van het oppervlak te bepalen. Deze textuur wordt soms de **albedo**
textuur genoemd.


Decal.ColorMapContent

`Datatype.Content` object dat de kleur en opaciteit van het
oppervlak bepaalt.


Deze eigenschap neemt een `Datatype.Content` object dat de
blijkbaar emissiviteit over het oppervlak bepaalt. Een emissief masker is een grijswaarden
afbeelding waarbij zwarte pixels overeenkomen met geen emissiviteit en witte pixels
overeenkomen met volledige emissiviteit. Het standaard is een lege inhoud, in welk
geval de decal niet gloeit.

De emissieve bijdrage wordt toegevoegd aan de totale lichtbijdrage
over het oppervlak, en de som wordt vermenigvuldigd met de albedo textuur van
`Class.Decal.ColorMapContent|ColorMapContent`, indien opgegeven. Gebruik
`Class.Decal.EmissiveStrength|EmissiveStrength` en
`Class.Decal.EmissiveTint|EmissiveTint` om te regelen hoe fel de gloed is
en welke kleur het heeft.

Het toewijzen van een emissief masker maakt de `Class.Decal` een fysiek gebaseerde
rendering (PBR) oppervlak.


Decal.EmissiveMaskContent

`Datatype.Content` object dat de emissiviteit over het
oppervlak bepaalt.


Deze waarde is een vermenigvuldiger die regelt hoe sterk de emissieve
bijdrage van `Class.Decal.EmissiveMaskContent|EmissiveMaskContent` is
over het oppervlak. Standaard is `1`. Negatieve waarden worden behandeld als `0`,
en een waarde van `0` schakelt de gloed uit.

Als de uiteindelijke emissieve bijdrage de ondersteunde dynamische
bereik overschrijdt, wordt deze beperkt, wat kan maken dat de emissieve gebieden
volledig wit lijken bij grote sterktewaarden. Aangezien deze waarde een vermenigvuldiger is,
hangt de maximale waarde die het beperken voorkomt af van de andere bijdragende waarden,
waaronder `Class.Decal.EmissiveTint|EmissiveTint`,
`Class.Decal.ColorMapContent|ColorMapContent`, en de gecombineerde lichtbijdrage.


Decal.EmissiveStrength

Bepaalt de sterkte van de emissieve bijdrage.


Deze waarde is een `Datatype.Color3` die de emissieve bijdrage
van `Class.Decal.EmissiveMaskContent|EmissiveMaskContent` tint. Standaard is
wit, wat de emissieve kleur onveranderd laat. Elke component is
beperkt tussen `0` en `1`, en zwart schakelt de gloed uit.


Decal.EmissiveTint

Bepaalt de tintkleur voor de emissieve bijdrage.


Functies als een vermenigvuldiger voor de decal's
`Class.Decal.Transparency|Transparency` eigenschap. Het effect is alleen
zichtbaar voor de `Class.Players.LocalPlayer|LocalPlayer` en zal niet
worden gerepliceerd naar de server.

Wanneer deze eigenschap is ingesteld op `1`, is de `Class.Decal` volledig
onzichtbaar, ongeacht de oorspronkelijke transparantie. Wanneer het is ingesteld op `0`,
zal de weergegeven transparantie van de decal overeenkomen met de
`Class.Decal.Transparency|Transparency` waarde.


Decal.LocalTransparencyModifier

Fungeert als een vermenigvuldiger voor de decal's
`Class.Decal.Transparency|Transparency` eigenschap. De effecten zijn alleen
zichtbaar voor de lokale speler.


Deze eigenschap neemt een content-ID die de metalness map bepaalt die op
toepassing is op het oppervlak. Een metalness map regelt hoe metallic het oppervlak lijkt
op elk punt, en mengt tussen een dielectrisch (niet-metaal) en een metallic
reactie op licht. Het standaard is een lege inhoud, in welk geval er geen
metalness map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak. Om deze
map toe te wijzen vanuit een `Datatype.Content` object, gebruik
`Class.Decal.MetalnessMapContent|MetalnessMapContent`.


Decal.MetalnessMap

Content-ID die de metalness map van het oppervlak bepaalt.


Deze eigenschap neemt een `Datatype.Content` object dat de
metalness map bepaalt die op het oppervlak is toegepast. Een metalness map regelt hoe
metallic het oppervlak lijkt op elk punt, en mengt tussen een dielectrisch
(niet-metaal) en een metallic reactie op licht. Het standaard is een lege
inhoud, in welk geval er geen metalness map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak.


Decal.MetalnessMapContent

`Datatype.Content` object dat de metalness map van het
oppervlak bepaalt.


Deze eigenschap neemt een content-ID die de normal map bepaalt die op
toepassing is op het oppervlak. Een normal map verstoort de oppervlaktemenigen die worden
gebruikt in lichtberekeningen, en voegt de uitstraling van fijne details zoals
bulten en groeven toe zonder de onderliggende geometrie te veranderen. Het standaard is een lege
inhoud, in welk geval er geen normal map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak. Om deze
map toe te wijzen vanuit een `Datatype.Content` object, gebruik
`Class.Decal.NormalMapContent|NormalMapContent`.


Decal.NormalMap

Content-ID die de normal map van het oppervlak bepaalt.


Deze eigenschap neemt een `Datatype.Content` object dat de normal
map bepaalt die op het oppervlak is toegepast. Een normal map verstoort de oppervlaktemenigen die worden
gebruikt in lichtberekeningen, en voegt de uitstraling van fijne details zoals
bulten en groeven toe zonder de onderliggende geometrie te veranderen. Het standaard is een lege
inhoud, in welk geval er geen normal map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak.


Decal.NormalMapContent

`Datatype.Content` object dat de normal map van het oppervlak bepaalt.


Deze eigenschap regelt de rotatiehoek van de decal textuur in graden.
Rotatie wordt toegepast op de UV-coördinaten in de klokwijzerzin.


Decal.Rotation

Deze eigenschap neemt een content-ID die de roughness map bepaalt die op
toepassing is op het oppervlak. Een roughness map regelt hoe ruw of glad het oppervlak
lijkt op elk punt, wat op zijn beurt bepaalt hoe scherp of vaag de reflecties zijn. Het standaard is een lege inhoud, in welk geval er geen
roughness map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak. Om deze
map toe te wijzen vanuit een `Datatype.Content` object, gebruik
`Class.Decal.RoughnessMapContent|RoughnessMapContent`.


Decal.RoughnessMap

Content-ID die de roughness map van het oppervlak bepaalt.


Deze eigenschap neemt een `Datatype.Content` object dat de
roughness map bepaalt die op het oppervlak is toegepast. Een roughness map regelt hoe ruw
of glad het oppervlak lijkt op elk punt, wat op zijn beurt bepaalt hoe
scherp of vaag de reflecties zijn. Het standaard is een lege inhoud, in
welk geval er geen roughness map wordt toegepast.

Het toewijzen van een normaal, ruwheid, metalness of emissief masker maakt de
`Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak.


Decal.RoughnessMapContent

`Datatype.Content` object dat de roughness map van het
oppervlak bepaalt.


Deze eigenschap bepaalt hoe glanzend de decal is. Het neemt een waarde tussen
`0` en `1`, waarbij `1` "volledig glanzend" is.


Decal.Shiny

Verouderde eigenschap die eerder de glans van de decal instelde.


Stelt de speculariteit in, wat is hoe het oppervlak reageert op licht dat
erop wordt geschenen.


Decal.Specular

Verouderde eigenschap die eerder de speculariteit van de decal instelde.


De content-ID van de afbeelding die door de `Class.Decal` moet worden toegepast.


Decal.Texture

De textuurinhoud die door de `Class.Decal` wordt weergegeven. Ondersteunt
[asset-URI's](/projects/assets#asset-uris) en
`Class.EditableImage` objecten.


Decal.TextureContent

De textuurinhoud die door de `Class.Decal` wordt weergegeven.


Beheerd door de engine en niet toegankelijk vanuit scripts. Een
`Datatype.Content` dat de gecomprimeerde runtime textuurgegevens van de decal bevat.
Wanneer de `Class.Decal` een fysiek gebaseerde rendering (PBR) oppervlak is, pakt de
engine zijn kleur-, normaal-, ruwheid-, metalness- en emissieve kaarten
in een enkele textuur-pakket asset en verwijst hiernaar. Standaard is een
lege inhoud.


Decal.TexturePackContent

Door de engine beheerde `Datatype.Content` die de gecomprimeerde runtime
textuur-pakketgegevens voor PBR decals opslaat.


Bepaalt de transparantie van de `Class.Decal` met `0` als volledig
opac en `1` volledig transparant.

Let op dat
`Class.Decal.LocalTransparencyModifier|LocalTransparencyModifier` fungeert als
een **vermenigvuldiger** voor dit transparantieniveau en moet worden gebruikt wanneer de
transparantie van de decal waarschijnlijk door een ander script zal worden gewijzigd.


Decal.Transparency

Bepaalt de transparantie van de `Class.Decal`.


Deze eigenschap regelt de UV-coördinaatvertaling. De
`Datatype.Vector2.X|X` waarde (**U**&nbsp;offset) en
`Datatype.Vector2.Y|Y` waarde (**V**&nbsp;offset) worden toegevoegd aan elke
bijbehorende UV-coördinaat tijdens textuurmapping.


Decal.UVOffset

Verschuift de UV-coördinaten door een offset toe te voegen vóór textuurmapping.


Deze eigenschap regelt de schaal die wordt toegepast op de horizontale en verticale
coördinaten. De `Datatype.Vector2.X|X` waarde (**U**&nbsp;schaal) en
`Datatype.Vector2.Y|Y` waarde (**V**&nbsp;schaal) worden vermenigvuldigd met elke
bijbehorende UV-coördinaat tijdens textuurmapping.


Decal.UVScale

Rekt of comprimeert de UV-coördinaten door een schaalfactor te vermenigvuldigen.


Deze eigenschap bepaalt de volgorde waarin decals op hetzelfde
`Class.Decal.Face|Face` van een `Class.BasePart` worden gerenderd. Lagere waarden
worden als eerste gerenderd, zodat een decal met een hogere `ZIndex` boven die met een lagere `ZIndex` wordt gerenderd.

Als je niet zeker weet of je in de toekomst een decal tussen twee
al bestaande decals moet stapelen, gebruik dan grotere scheidingen tussen
`ZIndex` waarden zoals `10` of `100` om ruimte voor toekomstige decals
tussen te waarborgen.


Decal.ZIndex

Bepaalt de rendervolgorde wanneer meerdere decals aan hetzelfde
vlak zijn toegewezen.


Past een afbeeldingsstructuur op een vlak van een ouder `Class.BasePart`.


`Class.FaceInstance` is een abstracte klasse waaruit de `Class.Decal` en
`Class.Texture` klassen afleiden.


FaceInstance

Stelt in op welke zijde van het bovenliggende `Class.BasePart` het object verschijnt.


FaceInstance.Face

Een abstracte klasse waaruit de `Class.Decal` en `Class.Texture` klassen
afleiden.


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


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.


Samenvatting