Wird von Roblox verwendet, um HTTP-Cookies zu analytischen Zwecken zu steuern.

Kann nur von den Backend-Servern von Roblox verwendet werden und ist daher in
jeglicher Form für Entwickler nicht verfügbar.

CookiesService

Ein Backend-Dienst, der von Roblox verwendet wird, um HTTP-Cookies zu steuern. Seine Funktionen sind
für Entwickler nicht verfügbar.

`Instance` ist die Basis-Klasse für alle Klassen in der Roblox-Klassenhierarchie
welche Teil des `Class.DataModel`-Baums sein können.

Es ist nicht möglich, direkt Root-`Instance`-Objekte zu erstellen, aber der spezielle
`Datatype.Instance.new()`-Konstruktor erstellt Objekte über Code, wobei der
Name der Klasse als Parameter übergeben wird und das erstellte Objekt zurückgegeben wird.


Demonstriert die Erkennung von Änderungen in der Abstammung einer Instanz, indem die `Class.Instance.AncestryChanged`-Ereignis verbunden wird.

Der Parent des ChangingPart wird im Laufe der Zeit auf verschiedene Werte gesetzt. Der Parent des Teils ist der Vorfahr des Teils, daher wird das `Class.Instance.AncestryChanged`-Ereignis ausgelöst, wann immer es sich ändert.

Wird ausgelöst, wenn die `Class.Instance.Parent`-Eigenschaft des Objekts oder eines
seiner Vorfahren geändert wird.

Dieses Ereignis umfasst zwei Parameter: `kind` bezieht sich auf die `Class.Instance`,
deren `Class.Instance.Parent` tatsächlich geändert wurde, während `parent` auf den neuen `Class.Instance.Parent`
dieser Instanz verweist.

Sie können dieses Ereignis verwenden, um die Löschung einer Instanz im Studio zu verfolgen,
wie beispielsweise eine manuelle Löschung im Explorer oder durch ein Plugin. Wenn Sie erkennen müssen,
wann eine Instanz zerstört wird, indem Sie `Class.Instance:Destroy()` verwenden,
verwenden Sie stattdessen das `Class.Instance.Destroying`-Ereignis.


Instance.AncestryChanged

child

Die `Class.Instance`, deren `Class.Instance.Parent` geändert wurde.


parent

Der neue `Class.Instance.Parent` der `Class.Instance`, deren
`Class.Instance.Parent` geändert wurde.


Wird ausgelöst, wenn die `Class.Instance.Parent`-Eigenschaft des Objekts oder eines
seiner Vorfahren geändert wird.


Dieses Ereignis wird ausgelöst, wann immer ein Attribut an der Instanz geändert wird,
auch wenn ein Attribut auf `nil` gesetzt wird. Der Name des geänderten
Attributs wird an die verbundene Funktion übergeben.

Zum Beispiel verbindet der folgende Codeausschnitt die Funktion `attributeChanged()`
mit dem Ereignis, das ausgelöst wird, wann immer eines der Attribute des Teils sich ändert:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "geändert")
end

part.AttributeChanged:Connect(attributeChanged)
```
Siehe auch `Class.Instance:GetAttributeChangedSignal()`, das ein Ereignis zurückgibt,
das ausgelöst wird, wenn ein bestimmtes Attribut sich ändert.


Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.


Wird ausgelöst, wann immer ein Attribut an der `Class.Instance` geändert wird.


Dieses Snippet druckt die Namen von Objekten aus, während sie zum Workspace hinzugefügt werden:

Wird ausgelöst, nachdem ein Objekt an diese `Class.Instance` angehängt wurde.

Beachten Sie, dass bei der Verwendung dieser Methode auf einem Client, um Objekte zu erkennen,
die vom Server erstellt wurden, es notwendig ist, `Class.Instance:WaitForChild()` zu verwenden,
wenn man auf die Nachkommen dieser Objekte zugreift. Dies liegt daran, dass weder das Objekt noch seine
Nachkommen garantiert sind, vom Server zeitgleich an den Client zu replizieren. Zum Beispiel:

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

Workspace.ChildAdded:Connect(function(child)
	-- Verwenden Sie WaitForChild(), da Nachkommen möglicherweise noch nicht repliziert wurden
	local head = child:WaitForChild("Head")
end)
```
Beachten Sie, dass dieses Ereignis nur für unmittelbare Kinder der `Class.Instance`
gültig ist. Für ein Ereignis, das alle Nachkommen erfasst, verwenden Sie
`Class.Instance.DescendantAdded`.

Siehe auch `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Die `Class.Instance`, die hinzugefügt wurde.


Wird ausgelöst, nachdem ein Objekt an diese `Class.Instance` angehängt wurde.


Instance.childAdded

Dieser Ausschnitt druckt die Namen von Objekten, während sie aus dem
Workspace entfernt werden:

Wird ausgelöst, nachdem ein Kind aus dieser `Class.Instance` entfernt wurde.

Entfernt bezieht sich darauf, wenn die Elternschaft eines Objekts von dieser
`Class.Instance` auf etwas anderes als diese `Class.Instance` geändert wird. Beachten Sie, dass dieses
Ereignis auch ausgelöst wird, wenn ein Kind zerstört wird (unter Verwendung von
`Class.Instance:Destroy()`), da die Zerstörungsfunktion die Elternschaft eines Objekts auf `nil` setzt.

Dieses Ereignis gilt nur für unmittelbare Kinder der `Class.Instance`. Für ein Ereignis, das
alle Nachkommen erfasst, verwenden Sie
`Class.Instance.DescendantRemoving`.

Siehe auch `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Die `Class.Instance`, die entfernt wurde.


Wird ausgelöst, nachdem ein Kind aus dieser `Class.Instance` entfernt wurde.


Das folgende Beispiel gibt den Namen jedes Objekts aus, das zum
Arbeitsbereich hinzugefügt wird:

Dieses Ereignis wird ausgelöst, nachdem ein Nachkomme zu der `Class.Instance` hinzugefügt wurde.

Da es für jeden Nachkommen ausgelöst wird, wird das Anfügen eines Objekts an die
`Class.Instance` das Ereignis für dieses Objekt und alle seine Nachkommen einzeln auslösen.

Wenn Sie nur an den **direkten Kindern** der
`Class.Instance` interessiert sind, verwenden Sie stattdessen `Class.Instance.ChildAdded`.

Siehe auch `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wird ausgelöst, nachdem ein Nachkomme zu der `Class.Instance` hinzugefügt wurde.


Das folgende Beispiel gibt den Namen eines Nachkommens aus, während er entfernt wird
aus dem Workspace:

Dieses Ereignis wird **sofort vor** der Änderung der Elternschaft der
`Class.Instance` ausgelöst, so dass eine **Nachkommen**-Instanz nicht mehr 
ein Nachkomme ist. `Class.Instance:Destroy()|Destroy()` ändert die `Class.Instance.Parent|Parent` eines Objekts auf `nil`, sodass der Aufruf dieser Methode auf einem Nachkommen des Elternteils dieses Ereignis auslösen würde.

Da dieses Ereignis **vor** der Entfernung des Nachkommens ausgelöst wird, bleibt die Elternschaft
des Nachkommens zum Zeitpunkt der Auslösung dieses Ereignisses unverändert. Wenn der Nachkomme auch ein **direktes Kind** des Elternteils ist, wird dieses Ereignis vor `Class.Instance.ChildRemoved` ausgelöst.

Wenn ein Nachkomme Kinder hat, wird dieses Ereignis zuerst mit dem Nachkommen und dann mit seinen Nachkommen ausgelöst.

##### Warnung

Dieses Ereignis wird mit dem Nachkommenobjekt ausgelöst, das entfernt wird.
Wenn Sie versuchen, die `Class.Instance.Parent|Parent` des Nachkommens auf
etwas anderes zu setzen, schlägt dies fehl. Unten ist ein Beispiel, das dies veranschaulicht:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipulieren Sie die Elternschaft des Nachkommen nicht in dieser Funktion!
	-- Dieses Ereignis wird AUSLÖST, WEIL die Elternschaft manipuliert wurde, und die Änderung wurde noch nicht vorgenommen
	-- Daher ist es problematisch, die Elternschaft so zu ändern:
	descendant.Parent = game
end)

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


Instance.DescendantRemoving

Die `Class.Instance`, die entfernt wird.


Wird sofort ausgelöst, bevor ein Nachkomme der `Class.Instance` entfernt wird.


Dieses Beispiel zeigt, wie ein Instanz, die zerstört wird, an ihrem Platz bleibt, bis die verbundene Funktion ausführt.

Dieses Beispiel zeigt, wie ein Instanz zerstört wird, bevor das Signal ausgelöst wird, wenn das Verhalten verschobener Signale verwendet wird.

Die `Class.Instance` wird niemals aus dem Speicher gelöscht, während eine verbundene
Funktion sie noch verwendet. Wenn jedoch die Funktion an irgendeinem Punkt wartet,
werden die `Class.Instance` und ihre Nachkommen auf `nil` gesetzt.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Immediate` gesetzt ist, wird dieses Ereignis sofort ausgelöst,
bevor die `Class.Instance` oder einer ihrer Vorfahren durch
`Class.Instance:Destroy()` zerstört wird.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis am nächsten
Fortsetzungspunkt ausgelöst, der nach der Zerstörung der `Class.Instance` oder
eines ihrer Vorfahren durch `Class.Instance:Destroy()` liegt.

Bei `Enum.SignalBehavior.Deferred|Deferred`-Verhalten ist es problematisch,
ein Skript mit seinem eigenen `Class.Instance.Destroying`-Ereignis zu verbinden, da das Skript
vor dem Auslösen des Rückrufs zerstört wird (was bedeutet, dass es nicht
ausgeführt wird).

Beim Löschen einer `Class.Instance` im Studio, wie z.B. manuelles Löschen
über den [Explorer](/studio/explorer) oder durch ein Plugin,
wird die `Class.Instance` nicht zerstört. Stattdessen wird die Elternschaft auf `nil`
gesetzt, was Sie mit `Class.Instance.AncestryChanged` verfolgen können.


Instance.Destroying

Wird sofort ausgelöst, bevor (oder aufgeschoben bis nach) die Instanz durch
`Class.Instance:Destroy()` zerstört wird.


Dieses Ereignis wird ausgelöst, wenn eine Stil-Eigenschaft an der Instanz geändert wird,
auch wenn eine Eigenschaft auf `nil` gesetzt wird.

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

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

local function stylePropertyChanged()
	print("Gestylte Eigenschaften geändert")
end

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


Instance.StyledPropertiesChanged

Wird ausgelöst, wenn eine Stil-Eigenschaft an der Instanz geändert wird, einschließlich
wenn eine Eigenschaft auf `nil` gesetzt wird.


Diese Methode wendet ein Tag auf die Instanz an, ohne Effekte, wenn das Tag bereits
angewendet wurde. Das erfolgreiche Hinzufügen eines Tags löst ein Signal aus,
das mit `Class.CollectionService:GetInstanceAddedSignal()` erstellt wurde, mit dem gegebenen Tag.

##### Warnungen

- Tags einer Instanz, die client-seitig hinzugefügt wurden, werden entfernt, wenn der
  Server später ein Tag auf dieser Instanz hinzufügt oder entfernt, weil der Server
  alle Tags zusammen repliziert und vorherige Tags überschreibt.

- Beim Taggen einer Instanz ist es üblich, dass einige Ressourcen verwendet werden,
  um das Tag seine Funktionalität zu geben, beispielsweise Ereignisverbindungen oder Tabellen.
  Um Speicherlecks zu vermeiden, ist es eine gute Idee, diese aufzuräumen (trennen,
  auf `nil` setzen usw.), wenn sie nicht mehr benötigt werden. Tun Sie dies beim
  Aufruf von `Class.Instance:RemoveTag()`, beim Aufruf von
  `Class.Instance:Destroy()`, oder in einer Funktion, die mit einem Signal verbunden ist,
das von `Class.CollectionService:GetInstanceRemovedSignal()` zurückgegeben wird.


Instance:AddTag

Die Kinder-Funktion gibt ein Array der Kinder des Objekts zurück.


Instance:children

Gibt ein Array der Kinder des Objekts zurück.


Diese Methode zerstört alle Kinder und Nachkommen einer Instanz.

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

-- Füge einige Funkel hinzu
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Wenn Sie nicht wünschen, **alle** Kinder und Nachfahren zu zerstören,
verwenden Sie entweder `Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um
über diese Kinder/Nachfahren zu iterieren und auszuwählen, was zu zerstören ist.
Beispielsweise wird der folgende Code alle
`Class.BasePart|BaseParts` löschen, die von einem `Class.Model` abstammen:

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

Diese Methode zerstört alle Kinder einer Instanz.


Demonstriert das Klonen eines Modells mit `Class.Instance:Clone()`.

`Clone()` erstellt eine Kopie einer Instanz und aller ihrer Nachkommen,
indem alle Instanzen ignoriert werden, die nicht
`Class.Instance.Archivable|Archivable` sind. Die Kopie der Root-Instanz wird
von dieser Methode zurückgegeben und `Class.Instance.Parent|Parent` wird auf
`nil` gesetzt. Beachten Sie, dass wenn die Instanz selbst
`Class.Instance.Archivable|Archivable` auf `false` gesetzt hat, diese Methode
`nil` zurückgeben wird.

Wenn eine Bezeichnereigenschaft wie `Class.ObjectValue.Value` in einer
kopierten Instanz gesetzt wird, hängt der Wert der kopierten Eigenschaft vom
Wert des Originals ab:

- Wenn eine Bezeichnereigenschaft auf eine Instanz verweist, die **ebenfalls** kopiert wurde,
  wird die Kopie auf die Kopie verweisen.
- Wenn eine Bezeichnereigenschaft auf eine Instanz verweist, die **nicht** kopiert wurde,
  bleibt derselbe Wert in der Kopie erhalten.


Instance:Clone

Erstellt eine Kopie einer Instanz und aller ihrer Nachkommen, wobei Instanzen
ignoriert werden, die nicht `Class.Instance.Archivable|Archivable` sind.


Instance:clone

Demonstriert das Zerstören eines Teils mit der `Class.Instance:Destroy()` Funktion.

Diese Funktion ist der richtige Weg, um Objekte zu entsorgen, die nicht mehr benötigt werden.

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die
`Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft
`Destroy()` für alle Kinder auf. Diese Methode ist der richtige Weg, um Objekte
zu entsorgen, die nicht mehr benötigt werden.

Das Entsorgen von nicht benötigten Objekten ist wichtig, da unnötige Objekte und
Verbindungen in einem Ort Speicher verbrauchen, was im Laufe der Zeit zu schwerwiegenden
Leistungsproblemen führen kann.

Als bewährte Praxis, nachdem `Destroy()` auf ein Objekt aufgerufen wurde,
setzen Sie alle Variablen, die auf das Objekt (oder seine Nachkommen) verweisen, auf `nil`.
Dies verhindert, dass Ihr Code auf irgendetwas mit dem Objekt zugreift.

```lua
local part = Instance.new("Part")
part.Name = "Hallo, Welt"
part:Destroy()
-- Machen Sie dies nicht:
print(part.Name)  --> "Hallo, Welt"
-- Machen Sie dies, um zu verhindern, dass die obige Zeile funktioniert:
part = nil
```
Sobald ein `Class.Instance` durch diese Methode zerstört wurde, kann es nicht
wiederverwendet werden, da die `Class.Instance.Parent`-Eigenschaft gesperrt ist. Um
ein Objekt **vorübergehend** zu entfernen, anstatt es zu zerstören, setzen Sie
`Class.Instance.Parent|Parent` auf `nil`. Zum Beispiel:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Um ein Objekt nach einem festgelegten Zeitraum zu zerstören, verwenden Sie
`Class.Debris:AddItem()`.


Instance:Destroy

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die
`Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft
`Destroy()` für alle Kinder auf.


Instance:destroy

Gibt den ersten Vorfahren des `Class.Instance` zurück, dessen
`Class.Instance.Name` dem gegebenen Namen entspricht.

Diese Methode arbeitet nach oben, das heißt, sie beginnt beim unmittelbaren
`Class.Instance.Parent` der Instanz und arbeitet sich bis zum
`Class.DataModel` vor. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil`\zurück. 

Der folgende Code-Schnipsel würde den ersten Vorfahren des Objekts
namens `Car` finden.

```
local car = object:FindFirstAncestor("Car")
```
Für Varianten dieser Methode, die Vorfahren einer bestimmten Klasse finden,
siehe `Class.Instance:FindFirstAncestorOfClass()` und `Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

Der `Class.Instance.Name`, nach dem gesucht wird.


Gibt den ersten Vorfahren des `Class.Instance` zurück, dessen
`Class.Instance.Name` dem gegebenen Namen entspricht.


Gibt den ersten Vorfahren des `Class.Instance` zurück, dessen
`Class.Object.ClassName` dem gegebenen className entspricht.

Diese Methode arbeitet nach oben, das heißt, sie beginnt beim unmittelbaren
`Class.Instance.Parent` der Instanz und arbeitet sich bis zum
`Class.DataModel` vor. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil`\zurück. 

Eine häufige Verwendung dieser Methode besteht darin, das `Class.Model` zu finden, zu dem ein `Class.BasePart` gehört. Zum Beispiel:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Diese Methode ist eine Variante von `Class.Instance:FindFirstAncestor()`,
die die `Class.Object.ClassName`-Eigenschaft anstelle von `Class.Instance.Name`
prüft. `Class.Instance:FindFirstAncestorWhichIsA()` existiert ebenfalls,
wahrscheinlich mit der Methode `Class.Object:IsA()` anstelle, um die Klassenvererbung zu respektieren.


Instance:FindFirstAncestorOfClass

className

Der `Class.Object.ClassName`, nach dem gesucht wird.


Gibt den ersten Vorfahren des `Class.Instance` zurück, dessen
`Class.Object.ClassName` dem gegebenen className entspricht.


Gibt den ersten Vorfahren des `Class.Instance` zurück, für den
`Class.Object:IsA()` für den gegebenen className den Wert wieder gibt 'true'.

Diese Methode arbeitet nach oben, das heißt, sie beginnt beim unmittelbaren
`Class.Instance.Parent` der Instanz und arbeitet sich bis zum
`Class.DataModel` vor. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil`\zurück. 

Im Gegensatz zu `Class.Instance:FindFirstAncestorOfClass()` verwendet diese Methode `Class.Object:IsA()`,
die die Vererbung der Klassen berücksichtigt. Zum Beispiel:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Daher wird der folgende Code-Schnipsel den ersten `Class.BasePart`
Vorfahren zurückgeben, unabhängig davon, ob es sich um ein `Class.WedgePart`,
`Class.MeshPart` oder `Class.Part` handelt.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Siehe auch `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren des `Class.Instance` zurück, für den
`Class.Object:IsA()` für den gegebenen className den Wert wieder gibt 'true'.


Die folgende Suche würde im Workspace nach einem Objekt mit dem Namen "Brick" suchen. Wenn es gefunden wird,
wird der Name des Objekts auf "Foo" geändert.

Gibt das erste Kind des `Class.Instance` mit dem gegebenen Namen zurück, oder
`nil`, wenn kein solches Kind existiert. Wenn das optionale `recursive`-Argument
`true` ist, sucht diese Methode nach allen Nachkommen und nicht nur nach den
unmittelbaren Kindern des `Class.Instance`.

##### Überprüfung der Existenz eines Objekts

`FindFirstChild()` ist notwendig, wenn Sie sicherstellen müssen, dass ein Objekt existiert,
vor dem Fortfahren. Ein Versuch, ein Kind über den Namen mit dem Punkt-Operator zu indexieren,
wird einen Fehler auslösen, wenn das Kind nicht existiert.

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

-- Die folgende Zeile gibt einen Fehler aus, wenn das Teil nicht im Workspace existiert
Workspace.Part.Transparency = 0.5
```
Ein besserer Ansatz ist, `FindFirstChild()` zu verwenden, um zuerst nach `Part`
zu suchen, und dann eine `if`-Anweisung zu verwenden, um den Code auszuführen, der es benötigt.

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

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

##### Finden eines Kindes, dessen Name mit einer Eigenschaft übereinstimmt

Gelegentlich ist der `Class.Instance.Name|Name` eines Objekts derselbe wie der
 einer Eigenschaft seines `Class.Instance.Parent|Parent`. Bei Verwendung des Punkt-Operators
eilen Eigenschaften über Kinder, wenn sie denselben Namen teilen, vor.

Im folgenden Beispiel wird ein `Class.Folder` mit dem Namen `Color` zu einem `Class.Part`
hinzugefügt, das auch die `Class.Part.Color`-Eigenschaft hat. Beachten Sie, dass
`part.Color` auf den Wert der `Datatype.Color3`-Eigenschaft verweist und nicht auf die
Kind-`Class.Folder`-Instanz. Ein Vorteil der Verwendung von
`Class.Instance:FindFirstChild()|FindFirstChild()` ist, dass die Einführung neuer Eigenschaften
kein Risiko für Ihren Code darstellt.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Die Eigenschaft
local c2 = part:FindFirstChild("Color")  -- Der Kinderordner
```

##### Leistungsnotizen

`Class.Instance:FindFirstChild()|FindFirstChild()` benötigt ungefähr 20 % länger
als die Verwendung des Punkt-Operators und fast 8-mal länger, als einfach einen
Verweis auf ein Objekt zu speichern. Daher sollten Sie vermeiden, es in leistungskritischem
Code wie in engen Schleifen oder Funktionen, die mit `Class.RunService.Heartbeat`
und `Class.RunService.PreRender` verbunden sind, aufzurufen. Stattdessen
speichern Sie das Ergebnis in einer Variablen oder nutzen Sie
`Class.Instance.ChildAdded|ChildAdded` oder
`Class.Instance:WaitForChild()|WaitForChild()`, um festzustellen, wann ein Kind mit einem
gegebenen Namen verfügbar wird.


Instance:FindFirstChild

recursive

Ob die Suche rekursiv durchgeführt werden soll oder nicht.


Gibt das erste Kind des `Class.Instance` zurück, das mit dem gegebenen Namen gefunden wurde.


Instance:findFirstChild

Gibt das erste Kind des `Class.Instance` zurück, dessen
`Class.Object.ClassName|ClassName` dem gegebenen `className` entspricht.
Im Gegensatz zu `Class.Instance:FindFirstChildWhichIsA()` gibt diese Methode nur
Objekte zurück, deren Klasse mit `className` übereinstimmt, und ignoriert die Klassenvererbung. Wenn kein
entsprechendes Kind gefunden wird, gibt diese Methode `nil` zurück.


Instance:FindFirstChildOfClass

Gibt das erste Kind des `Class.Instance` zurück, dessen
`Class.Object.ClassName|ClassName` dem angegebenen Klassennamen entspricht.


Gibt das erste Kind des `Class.Instance` zurück, für das
`Class.Object:IsA()` für den gegebenen className 'true' ergibt.

Wenn kein passendes Kind gefunden wird, gibt diese Methode `nil` zurück. Wenn das optionale
rekursive Argument auf `true` gesetzt ist, sucht diese Methode nach allen Nachkommen statt nur nach den
unmittelbaren Kindern des `Class.Instance`.

Im Gegensatz zu `Class.Instance:FindFirstChildOfClass()` verwendet diese Methode `Class.Object:IsA()`,
welches die Klassenvererbung respektiert. Zum Beispiel:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Daher wird der folgende Code-Schnipsel das erste
`Class.BasePart`-Kind zurückgeben, unabhängig davon, ob es sich um ein `Class.WedgePart`,
`Class.MeshPart` oder `Class.Part` handelt.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Entwickler, die nach einem Kind anhand des Namens suchen, sollten stattdessen
`Class.Instance:FindFirstChild()` verwenden.


Instance:FindFirstChildWhichIsA

Gibt das erste Kind des `Class.Instance` zurück, für das
`Class.Object:IsA()` für den gegebenen className 'true' ergibt.


Gibt das erste gefundene Nachkommen mit dem gegebenen `Class.Instance.Name` zurück.

Diese Methode ist deaktiviert und kann nicht verwendet werden. Um das erste Nachkommen
einer Instanz zu finden, erwägen Sie die Verwendung des rekursiven Parameters in
`Class.Instance:FindFirstChild()` stattdessen.


Instance:FindFirstDescendant

Gibt das erste gefundene Nachkommen mit dem gegebenen `Class.Instance.Name` zurück.


Wenn die `Class.Instance` ein `Class.Actor` ist, wird der `Class.Actor` selbst
zurückgegeben. Andernfalls wird der nächstgelegene Vorfahr `Class.Actor` zurückgegeben. Wenn kein
Vorfahre ein `Class.Actor` ist, ist das Ergebnis `nil`.


Instance:GetActor

Gibt den `Class.Actor` zurück, der mit der Instanz verbunden ist, falls vorhanden.


Diese Methode gibt den Wert zurück, der dem gegebenen
Attributnamen zugewiesen wurde. Wenn kein Attribut zugewiesen wurde, wird `nil` zurückgegeben.

Zum Beispiel setzt der folgende Code-Schnipsel den Wert des Attributs `InitialPosition` der Instanz:

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

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

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

##### Siehe auch

- `Class.Instance:SetAttribute()`, das das Attribut mit dem gegebenen
  Namen auf den gegebenen Wert setzt.
- `Class.Instance:GetAttributes()`, das ein Dictionary von Schlüssel-Wert
  Paaren für jedes Attribut der Instanz zurückgibt.


Instance:GetAttribute

Der Name des Attributs, das abgerufen wird.


Der Wert, der dem gegebenen Attributnamen zugewiesen wurde. Wenn kein
Attribut zugewiesen wurde, wird `nil` zurückgegeben.


Gibt den Wert zurück, der dem angegebenen Attributnamen zugewiesen wurde.


Diese Methode gibt ein Ereignis zurück, das sich genau wie das
`Class.Object.Changed|Changed`-Ereignis verhält, mit dem Unterschied, dass es nur ausgelöst wird,
wenn sich das spezifische gegebene Attribut ändert; effektiv ist es ähnlich wie
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, jedoch für Attribute.

Es ist im Allgemeinen eine gute Idee, diese Methode statt einer Verbindung zu
`Class.Object.Changed|Changed` mit einer Funktion, die den Attributnamen überprüft, zu verwenden. Nachfolgende Aufrufe dieser Methode für dasselbe Objekt mit demselben
Attributnamen geben dasselbe Ereignis zurück.

Der folgende Code gibt ein Signal zurück, das die Funktion
`attributeChanged()` auslöst, wenn sich das Attribut `InitialPosition` des Teils ändert:

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

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

local function attributeChanged()
	print("Attribut geändert")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Siehe auch `Class.Instance.AttributeChanged`, das ausgelöst wird, wann immer ein
Attribut auf der Instanz geändert wird.


Instance:GetAttributeChangedSignal

Der Name des bestimmten Attributs, für das das Änderungssignal
zurückgegeben wird.


Ein Ereignis, das ausgelöst wird, wenn sich das angegebene Attribut ändert.


Gibt ein Ereignis zurück, das ausgelöst wird, wenn sich das angegebene Attribut ändert.


Diese Methode gibt ein Dictionary von Schlüssel-Wert-Paaren für jedes Attribut
zurück, wobei der Schlüssel der Name des Attributs und der Wert ein nicht-`nil` Wert ist.

Zum Beispiel gibt der folgende Code-Schnipsel die Attribute und Werte einer Instanz aus:

```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
```
Siehe auch `Class.Instance:GetAttribute()`, das den Wert zurückgibt, der dem gegebenen
Attributnamen zugewiesen wurde.


Instance:GetAttributes

Ein Dictionary von String → Variant-Paaren für jedes Attribut, bei dem der
String der Name des Attributs ist und die Variant ein nicht-nil Wert ist.


Gibt ein Dictionary der Attribute der Instanz zurück.


Das Folgende würde die Namen aller Objekte, die sich derzeit im Workspace befinden, beim Ausführen ausgeben.

Gibt ein Array (eine numerisch indizierte Tabelle) zurück, das alle direkten Kinder der
Instanz enthält oder jede `Class.Instance`, deren
`Class.Instance.Parent|Parent` gleich dem Objekt ist. Das Array kann entweder mit
 einer numerischen oder generischen `for`-Schleife durchlaufen werden:

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

-- Beispiel für eine numerische Schleife
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " ist Kind Nummer " .. i)
end
```

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

-- Beispiel für eine generische Schleife
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " ist Kind Nummer " .. i)
end
```
Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge
sortiert ist, daher wird manuelle Sortierung (zum Beispiel unter Verwendung von `Library.table.sort()`)
ausdrücklich empfohlen, um die durch diese Methode zurückgegebenen Kinder zu sortieren.

Siehe auch die Methode `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Ein Array, das die Kinder der Instanz enthält.


Gibt ein Array zurück, das alle Kinder der Instanz enthält.


Instance:getChildren

Gibt eine codierte Zeichenfolge der Debug-ID zurück, die intern von Roblox verwendet wird. Beachten Sie,

- Dieses Element ist geschützt. Der Versuch, es in einem `Class.Script` oder
  `Class.LocalScript` zu verwenden, führt zu einem Fehler.
- Eine Debug-ID ist eine ID, die in Debugging-Prozessen verwendet wird. Sie
  ermöglicht es einem Debugger, jede Anweisung zu lesen, bevor eine Anwendung sie
  verarbeitet. Alle Objekte in Roblox verhalten sich wie Prozesse und führen
  Anweisungen (oder 'Code') aus, die bei Bedarf debuggt werden können.
- Dies kann hilfreich für Plugins sein, die ähnliche Objekte voneinander unterscheiden müssen
  (wie etwa Objekte, die denselben Namen teilen).


Instance:GetDebugId

scopeLength

Gibt eine codierte Zeichenfolge der Debug-ID zurück, die intern von Roblox verwendet wird.


GetDescendants wird häufig verwendet, um etwas mit allen Nachfahren zu tun, die ein
bestimmter Objekttyp sind. Der Code in diesem Beispiel verwendet GetDescendants und
`Class.Instance:IsA()`, um alle Teile im Workspace zu finden und sie grün zu
färben.

Diese Objektmethode gibt ein Array zurück, das alle Nachkommen dieses Objekts enthält. Im Gegensatz zu
`Class.Instance:GetChildren()`, das nur die unmittelbaren Kinder eines Objekts zurückgibt, entdeckt diese Methode jedes Kind des Objekts, jedes Kind dieser Kinder und so weiter.

Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge
sortiert ist, daher wird manuelle Sortierung (zum Beispiel unter Verwendung von `Library.table.sort()`)
ausdrücklich empfohlen, um die durch diese Methode zurückgegebenen Nachkommen zu sortieren. Erwägen Sie auch die Methode
`Class.Instance:QueryDescendants()|QueryDescendants()`, um Nachkommen durch eine Kombination von Selektoren und Kombinatoren abzufragen.


Instance:GetDescendants

Ein Array, das die Nachkommen der Instanz enthält.


Gibt ein Array zurück, das alle Nachkommen der Instanz enthält.


Diese Code-Beispiel zeigt das Verhalten von `Class.Instance:GetFullName()`.
Es zeigt, wie die Funktion sich verhält, wenn sie auf ein Objekt aufgerufen wird, das sich nicht in der
`DataModel`-Hierarchie befindet, und es zeigt auch, wie der Rückgabewert keine
Sonderzeichen entkommt.

Dieses Codebeispiel implementiert die `Class.Instance:GetFullName()`-Funktion in
Lua neu.

Gibt eine Zeichenfolge zurück, die die Abstammung der Instanz beschreibt. Die Zeichenfolge ist eine
Verkettung des `Class.Instance.Name|Name` des Objekts und seiner
Vorfahren, getrennt durch Punkte. Das `Class.DataModel` (`game`) wird nicht
berücksichtigt. Zum Beispiel könnte ein `Class.Part` im `Class.Workspace`
den Wert `Class.Workspace.Part` zurückgeben.

Wenn diese Methode auf einem `Class.Instance` aufgerufen wird, der kein Nachkomme des
`Class.DataModel` ist, betrachtet diese Methode alle Vorfahren bis hin zu und einschließlich
dem obersten, der keinen `Class.Instance.Parent|Parent` hat.

Diese Methode ist nützlich für Protokollierung und Debugging. Es sollte nicht versucht
werden, die zurückgegebene Zeichenfolge für eine nützliche Operation zu parsen;
diese Methode entkommt nicht vor Punkten (oder einer anderen Symbol) in Objektnamen. Mit anderen Worten,
obwohl ihre Ausgabe oft wie ein gültiger Luau-Identifikator aussieht, ist es nicht
garantiert.


Instance:GetFullName

Gibt eine Zeichenfolge zurück, die die Abstammung der Instanz beschreibt.


Diese Methode gibt den stilisierten oder explizit modifizierten Wert der
angegebenen Eigenschaft zurück, oder andernfalls den Standardwert der Eigenschaft, wenn er nicht gestylt/modifiziert wurde. Das unterscheidet sich geringfügig vom Zugriff auf den Eigenschaftswert
 direkt, wie `[GuiObject].Rotation`, was den Standard- oder
modifizierten Wert der Eigenschaft zurückgibt.

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

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

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

-- Referenz zu einem Button
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (Standardwert)
print(button.Rotation) --> 0 (Standardwert)

-- Anwendung von Rotation durch die Stilanpassung
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (gestylter Wert basierend auf Regel)
print(button.Rotation) --> 0 (Standardwert)

-- Stilisierte Eigenschaft explizit modifizieren/überschreiben
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (modifizierter Wert)
print(button.Rotation) --> 45 (modifizierter Wert)
```


Instance:GetStyled

Der stilisierte oder explizit modifizierte Wert der angegebenen Eigenschaft, oder
ansonsten der Standardwert der Eigenschaft, wenn sie nicht gestylt/modifiziert wurde.


Gibt den stilisierten oder explizit modifizierten Wert der angegebenen Eigenschaft zurück,
oder den Standardwert der Eigenschaft, wenn sie nicht gestylt/modifiziert wurde.


Diese Methode gibt ein Ereignis zurück, das sich genau wie das
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`-Ereignis verhält,
 mit dem Unterschied, dass es nur ausgelöst wird, wenn die gegebene Stileigenschaft
sich ändert. Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` mit einer Funktion, die
 den Eigenschaftsnamen überprüft, zu verwenden. Nachfolgende Aufrufe dieser Methode für
 dasselbe Objekt mit demselben Eigenschaftsnamen geben dasselbe Ereignis zurück.

Beachten Sie, dass dieses Ereignis keine Argumente an eine verbundene Funktion
überträgt, sodass der Wert der geänderten Eigenschaft direkt innerhalb eines
Skripts gelesen werden muss.

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

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

local function stylePropertyChanged()
	print("Stileigenschaft geändert!")
end

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


Instance:GetStyledPropertyChangedSignal

property

Name der Stileigenschaft, für die auf Änderungen gehört werden soll.


Ereignis, das ausgelöst wird, wenn sich die gegebene Stileigenschaft ändert.


Diese Methode gibt ein Array der Tags zurück, die der gegebenen Instanz zugewiesen wurden,
als Strings. Sie können Tags entweder im Studio im 
[Eigenschaften](/studio/properties)-Fenster oder zur Laufzeit mit
`Class.Instance:AddTag()|AddTag()` hinzufügen.

Diese Methode ist nützlich, wenn Sie etwas mit mehreren Tags auf
 einer Instanz auf einmal tun möchten. Es ist jedoch ineffizient, diese Methode zu verwenden, um
 die Existenz eines einzelnen Tags zu überprüfen; verwenden Sie stattdessen
`Class.Instance:HasTag()|HasTag()`, um ein bestimmtes Tag zu überprüfen.


Instance:GetTags

Erhält ein Array aller Tags, die der Instanz zugewiesen wurden.


Diese Methode gibt `true` zurück, wenn das bereitgestellte Tag zu dem
Objekt hinzugefügt wurde. Sie können Tags entweder im Studio im 
[Eigenschaften](/studio/properties)-Fenster oder zur Laufzeit mit
`Class.Instance:AddTag()|AddTag()` hinzufügen.


Instance:HasTag

Überprüft, ob die Instanz ein bestimmtes Tag hat.


Demonstriert, wie man feststellt, ob eine Instanz die Vorfahren einer anderen ist, mithilfe von `Class.Instance:IsAncestorOf()`

Arbeitsbereich und SpawnLocation sind Vorfahren des Decals von SpawnLocation.
Der Arbeitsbereich ist ein Vorfahr von SpawnLocation.

SpawnLocation und sein Decal sind Nachkommen des Arbeitsbereichs, keine Vorfahren.
Das Decal ist ein Nachkomme von SpawnLocation, kein Vorfahr.

Gibt `true` zurück, wenn ein `Class.Instance` ein Vorfahr des gegebenen
Nachkommens ist.

Ein `Class.Instance` wird als Vorfahr eines Objekts angesehen, wenn
das `Class.Instance.Parent` des Objekts oder eines seiner Elternteile
`Class.Instance.Parent` auf das `Class.Instance` gesetzt ist.

Siehe auch `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

Wahr, wenn das `Class.Instance` ein Vorfahr des gegebenen Nachkommens ist.


Gibt `true` zurück, wenn ein `Class.Instance` ein Vorfahr des gegebenen
Nachkommens ist.


Gibt `true` zurück, wenn ein `Class.Instance` ein Nachkomme des gegebenen
Vorfahren ist.

Beachten Sie, dass `IsDescendantOf()` nicht mit einem Parameter von `nil` verwendet werden kann,
um zu überprüfen, ob ein Objekt entfernt wurde.

Siehe auch `Class.Instance:IsAncestorOf()`.


Instance:IsDescendantOf

ancestor

Wahr, wenn das `Class.Instance` ein Nachkomme des gegebenen Vorfahren ist.


Gibt `true` zurück, wenn ein `Class.Instance` ein Nachkomme des gegebenen
Vorfahren ist.


Instance:isDescendantOf

Diese Methode zeigt an, ob eine bestimmte Eigenschaft von
dem standardmäßig instanzierten Code geändert wurde. Wenn sie auf einer Instanz
aufrufen wird, die über Code (`Datatype.Instance.new()`) neu erstellt wurde,
gibt diese Methode `false` zurück. Wenn sie auf einem Objekt aufgerufen wird,
das neu durch Studio-Workflows eingefügt wurde, wie über das
[Explorer](/studio/explorer)-Fenster, kann das Ergebnis abweichen.

Beispielsweise gibt die Abfrage der
`Class.TextLabel.BackgroundColor3|BackgroundColor3`-Eigenschaft einer
`Class.TextLabel`, die über das [Explorer](/studio/explorer)-Fenster hinzugefügt wurde,
`true` zurück, aber die Abfrage derselben Eigenschaft einer `Class.TextLabel`
, die durch `Datatype.Instance.new()` erstellt wurde, gibt `false` zurück, vorausgesetzt, dass
keine anderen Änderungen an ihrer `Class.TextLabel.BackgroundColor3|BackgroundColor3` vorgenommen wurden.

Beachten Sie, dass, wenn diese Methode `true` zurückgibt,
Styling **nicht** die Eigenschaft beeinflusst, da das explizite Ändern einer Eigenschaft Vorrang vor
dem Styling hat. Um eine Eigenschaft auf ihren standardmäßig instanzierten Wert zurückzusetzen und
styling zu ermöglichen, verwenden Sie `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Name der Eigenschaft, die abgerufen wird.


Boolean, der angibt, ob die Eigenschaft von ihrem standardmäßig instanzierten Wert geändert wurde.


Gibt `true` zurück, wenn der Wert, der in der angegebenen Eigenschaft gespeichert ist,
nicht gleich dem standardmäßig instanzierten Code ist.


Diese Objektmethode gibt ein Array zurück, das die Nachkommen dieses Objekts enthält, die dem angegebenen `selector`-String entsprechen. Der `selector`-String kann mehrere Selektoren und Kombinatoren enthalten, um Eigenschaften wie den Klassennamen, den Instanznamen, die hierarchischen Beziehungen sowie spezifische Werte von Instanzeigenschaften und Attributen abzugleichen. Die `selector`-Grammatik ist ähnlich zu der, die in `Class.StyleRule` verwendet wird, mit nur wenigen Unterschieden bezüglich der Teile der Grammatik, die unterstützt oder nicht unterstützt werden.

##### Selektoren

<table>
<thead>
  <tr>
    <th>Selektor</th>
    <th>Beschreibung</th>
    <th>Beispiele</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>ClassName</code></td>
    <td>Stimmt mit Instanzen der angegebenen Klasse in einer <code>Class.Object:IsA()</code>-Beziehung überein.</td>
    <td><code>SpotLight</code><br /><code>ImageButton</code><br /><code>Part</code></td>
  </tr>
  <tr>
    <td><code>.Tag</code></td>
    <td>Stimmt mit Instanzen überein, die mit einem <code>Class.CollectionService</code>-Tag versehen sind.</td>
    <td><code>.Fruit</code><br /><code>.IntenseLight</code></td>
  </tr>
  <tr>
    <td><code>#Name</code></td>
    <td>Stimmt mit Instanzen eines bestimmten <code>Class.Instance.Name</code> überein.</td>
    <td><code>#RedTree</code><br /><code>#CloseButton</code></td>
  </tr>
  <tr>
    <td><code>[property = value]</code></td>
    <td>Stimmt mit Instanzen, die die angegebene Eigenschaft haben und die angegebene Eigenschaft den angegebenen Wert hat. Es sind boolesche, numerische und Zeichenfolgenwerte erlaubt. Buchstaben, Zahlen, <code>_</code> und <code>-</code> können ohne Anführungszeichen verwendet werden.
    </td>
    <td><code>[CanCollide = false]</code><br />
    <code>[Brightness = "0.5"]</code><br />
    <code>[Name = Folder10]</code><br />
    <code>[Name = "Part.10"]</code></td>
  </tr>
  <tr>
    <td width="30%"><code>[$attribute = value]</code></td>
    <td>Stimmt mit Instanzen überein, die das angegebene Attribut haben und das Attribut den angegebenen Wert hat. Dieselben Einschränkungen wie bei den Eigenschaften-Selektoren gelten.</td>
    <td width="30%"><code>[$MyAttribute = 10]</code></td>
  </tr>
</tbody>
</table>

Beachten Sie, dass Selektoren kombiniert werden können. Zum Beispiel,
`Model.Apple[$Kind = "Red"][$State = 4]` stimmte mit Instanzen überein, die ein
`Class.Model` sind, das mit einem Tag `Apple` versehen ist, und das ein
`Kind`-Attribut hat, das dem String `"Red"` entspricht sowie ein `State`-Attribut, das gleich `4` ist.

##### Kombinatoren

<table>
<thead>
  <tr>
    <th>Kombinator</th>
    <th>Beschreibung</th>
    <th>Beispiele</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>&gt;</code></td>
    <td>Stimmt mit Instanzen überein, die <b>direkte Kinder</b> der vorherigen Filterübereinstimmungen sind.</td>
    <td><code>Part &gt; .SwordHandle</code></td>
  </tr>
  <tr>
    <td><code>&gt;&gt;</code></td>
    <td>Stimmt mit Instanzen überein, die <b>Nachkommen</b> der vorherigen Filterübereinstimmungen sind.</td>
    <td><code>Model &gt;&gt; .TreeOnFire</code></td>
  </tr>
  <tr>
    <td width="10%"><code>,</code></td>
    <td>Gibt eine Liste mehrerer unabhängiger Selektoren für die Nachkommenabfrage an.</td>
    <td width="50%"><code>Part.TagA, Part[$UseForce = true]</code></td>
  </tr>
</tbody>
</table>

Beachten Sie, dass der Standard erste Filter ein Nachkommenkombinator `>>` ist. Wenn der
Selektor mit `>` beginnt, werden nur Kinder besucht; beispielsweise
`>Part.Apple` wählt **direkte Kinder** aus, die ein `Class.Part` sind und ein Tag `Apple`
haben.

Der Standardkombinator kann auch ausdrücklich spezifiziert werden, wie in
`>>SpotLight.Red`, das dasselbe wie `SpotLight.Red` ist.

Nur die Elemente, die den Filter erfüllen, werden im Array hinzugefügt. Zum Beispiel,
`>#ExistingChild, >#MissingChild, >#AnotherExistingChild` wird ein
Array mit zwei Elementen zurückgeben, und es wird kein `nil` für das fehlende Kind geben.


Instance:QueryDescendants

selector

Der Selektorstring, der zum Filtern von Elementen verwendet wird.


Ein Array von Instanzen (leer, wenn nichts übereinstimmt).


Der folgende Code zeigt, wie ein Teil nach dem Entfernen wieder zum DataModel hinzugefügt werden kann:

Diese Methode setzt den `Class.Instance.Parent` des Objekts auf `nil` und macht
dasselbe für alle seine Nachkommen.

Wenn das Objekt vor der Entfernung referenziert wird, ist es möglich, das Objekt zu einem späteren Zeitpunkt abzurufen.


Instance:Remove

Setzt den `Parent` des Objekts auf `nil` und macht dasselbe für alle seine
Nachkommen.


Instance:remove

Diese Methode entfernt ein Tag von einer Instanz. Sie wird keinen Fehler
auslösen, wenn das Objekt das Tag nicht hat. Das erfolgreiche Entfernen eines Tags löst ein
Signal aus, das mit `Class.CollectionService:GetInstanceRemovedSignal()`
erstellt wurde, mit dem gegebenen Tag.

Beachten Sie, dass beim Taggen einer Instanz häufig einige Ressourcen verwendet werden,
um das Tag seine Funktionalität zu verleihen, wie beispielsweise das Trennen von Ereignissen oder Tabellen.
Um Speicherlecks zu vermeiden, ist es sinnvoll, diese aufzuräumen
(trennen, auf `nil` setzen usw.), wenn sie nicht mehr für ein Tag benötigt werden.


Instance:RemoveTag

Setzt eine Eigenschaft auf ihren Standardwert zurück. Wenn beispielsweise
`ResetPropertyToDefault("Rotation")` auf einem `Class.TextLabel` aufgerufen wird,
gilt dies als Setzen seiner `Class.TextLabel.Rotation|Rotation` auf `0` (den Standardwert
der Eigenschaft). Diese Methode kann verwendet werden, um sicherzustellen, dass Styling diesen
Standardwert der Eigenschaft überschreibt.


Instance:ResetPropertyToDefault

Setzt eine Eigenschaft auf ihren Standardwert zurück.


Diese Methode setzt das Attribut mit dem gegebenen Namen auf den gegebenen Wert. Wenn
der angegebene Wert `nil` ist, wird das Attribut entfernt, da `nil` standardmäßig zurückgegeben wird.

Beispielsweise setzt der folgende Code-Schnipsel das Attribut `InitialPosition` der Instanz auf
`Datatype.Vector3|Vector3.new(0, 10, 0)`:

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

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

##### Einschränkungen

Namensanforderungen und Einschränkungen:

- Namen dürfen nur alphanumerische Zeichen verwenden.
  - Sie können auch Punkte, Bindestriche, Schrägstriche und Unterstriche enthalten.
- Keine Leerzeichen oder unique Symbole (wie @, ~, !) sind erlaubt.
- Strings müssen 100 Zeichen oder weniger lang sein.
- Namen dürfen nicht mit **RBX** beginnen, es sei denn, der Aufrufer ist ein
  Roblox-Kern-Skript (reserviert für Roblox).

Wenn versucht wird, ein Attribut auf einen nicht unterstützten Typ zu setzen, wird ein Fehler	aufgetreten.

##### Siehe auch

- `Class.Instance:GetAttribute()`, das den Wert zurückgibt, der dem gegebenen
  Attributnamen zugewiesen wurde.
- `Class.Instance:GetAttributes()`, das ein Dictionary von Schlüssel-Wert
  Paaren für jedes Attribut der Instanz zurückgibt.


Instance:SetAttribute

Der Name des Attributs, das gesetzt wird.


value

Der Wert, der für die angegebene Eigenschaft gesetzt werden soll.


Setzt das Attribut mit dem gegebenen Namen auf den gegebenen Wert.


Der folgende Code wartet darauf, dass eine Instanz mit dem Namen "Part" zu
Workspace hinzugefügt wird.

Gibt das Kind der `Class.Instance` mit dem angegebenen Namen zurück. Wenn das
Kind nicht existiert, wird der aktuelle Thread warten, bis es vorhanden ist. Wenn
der Parameter `timeOut` angegeben ist, wird diese Methode nach der
genannten Anzahl von Sekunden Zeitüberschreitung haben und `nil` zurückgeben.

##### Primäre Nutzung

`Class.Instance:WaitForChild()|WaitForChild()` ist extrem wichtig, wenn
man an Code arbeitet, der im Client in einem `Class.LocalScript` ausgeführt wird. Die Roblox
Engine garantiert nicht die Zeit oder Reihenfolge, in der Objekte vom Server an den Client
gerepliziert werden. Darüber hinaus, wenn eine Erfahrung `Class.Workspace.StreamingEnabled`
auf true gesetzt hat,
`Class.BasePart|BaseParts`, die weit vom Charakter des Spielers entfernt sind,
werden möglicherweise nicht an den Client streamen, was dazu führen kann, dass Skripte kaputtgehen,
wenn sie auf Objekte zugreifen, die noch nicht im Client existieren.

##### Hinweise

- Diese Methode wartet nicht, wenn ein Kind mit dem angegebenen Namen existiert, wenn
  der Aufruf erfolgt.
- `Class.Instance:FindFirstChild()` ist eine effizientere Alternative zu
  `Class.Instance:WaitForChild()|WaitForChild()` für Objekte, von denen angenommen wird,
  dass sie existieren.
- Wenn ein Aufruf dieser Methode 5 Sekunden überschreitet, ohne zurückzugeben, und kein
  `timeOut`-Parameter angegeben wurde, wird eine Warnung in der
  Ausgabe ausgegeben, dass der Thread möglicherweise unbegrenzt wartet.


Instance:WaitForChild

childName

Der `Class.Instance.Name`, nach dem gesucht werden soll.


timeOut

Ein optionaler Zeitüberschreitungsparameter.


Gibt das Kind des `Class.Instance` mit dem gegebenen Namen zurück. Wenn das
Kind nicht existiert, wird der aktuelle Thread angehalten, bis es exists.


Instance

Diese Eigenschaft bestimmt, ob die Instanz eingeschlossen sein sollte,
wenn die Erfahrung veröffentlicht oder gespeichert wird, oder wenn `Class.Instance:Clone()|Clone()`
aus einer der Vorfahren der Instanz aufgerufen wird. Das direkte Aufrufen von
`Class.Instance:Clone()|Clone()` auf einer Instanz gibt `nil`
zurück, wenn diese Instanz **nicht** `Class.Instance.Archivable|Archivable` ist.

Das Kopieren eines Objekts in Studio mit den Optionen **Duplizieren** oder **Kopieren**/**Einfügen**
ignoriert die eigene `Class.Instance.Archivable|Archivable`
Eigenschaft und setzt `Class.Instance.Archivable|Archivable` auf `true` für die
Kopie.

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```


Instance.Archivable

Bestimmt, ob ein `Class.Instance` und seine Nachkommen mit
`Class.Instance:Clone()` geklont werden können und gespeichert/veröffentlicht werden können.


Instance.archivable

Der Satz von Berechtigungen, die für Skripte innerhalb dieser
Instanz verwendet werden dürfen. Damit die Berechtigungen wirksam werden, muss die
`Class.Instance.Sandboxed`
Eigenschaft aktiviert sein.

Diese Eigenschaft wird von einer experimentellen Funktion genutzt. Siehe
[Scriptfähigkeiten](/scripting/capabilities) für weitere
Details.


Instance.Capabilities

Der Satz von Berechtigungen, die für Skripte innerhalb dieses
Containers verwendet werden dürfen.


Ein nicht eindeutiger Bezeichner des `Class.Instance`. Namen werden verwendet, um
hierarchisch die Objekte zu organisieren, zudem können Skripte auf
spezifische Objekte zugreifen. Der Name einer Instanz darf 100 Zeichen nicht überschreiten.

Der Name eines Objekts wird oft verwendet, um auf das Objekt durch die Datenmodell-Hierarchie zuzugreifen,
unter Verwendung folgender Methoden:

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```
Um ein Objekt über den Punkt-Operator (`.`) zugänglich zu machen, muss
sein Name mit einem Unterstrich oder Buchstaben beginnen, und der Rest des Namens kann
nur Buchstaben, Zahlen oder Unterstriche enthalten (keine anderen speziellen
Charaktere). Wenn der Name eines Objekts nicht dieser Syntax folgt, ist es nicht
über den Punkt-Operator zugänglich und Luau interpretiert seinen Namen nicht
als Bezeichner.

Falls mehr als ein Objekt mit demselben Namen Geschwister sind, wird jeder Versuch,
ein Objekt über diesen Namen zu indexieren, nur eines der Objekte zurückgeben, ähnlich wie bei `Class.Instance:FindFirstChild()`, jedoch nicht immer das gewünschte Objekt.
Wenn ein spezifisches Objekt über Code zugänglich gemacht werden muss, wird empfohlen,
ihm einen einzigartigen Namen zu geben oder sicherzustellen, dass keine seiner Geschwister denselben
Namen teilen.

Siehe auch `Class.Instance:GetFullName()`, um einen vollständigen Namen zu erhalten, der die
Objekthierarchie umfasst.


Instance.Name

Ein nicht eindeutiger Bezeichner des `Class.Instance`.


`Instance` ist die Basis-Klasse für alle Klassen in der Roblox-Klassenhierarchie
welche Teil des `Class.DataModel`-Baums sein können.


/reference/engine/classes/CookiesService.yaml

CookiesService

Zusammenfassung

Eigenschaften

Methoden

Events

Eigenschaften

Methoden

Events

Auf dieser Seite