Eine spezielle Art von `Class.StatsItem`, die eine Gesamtanzahl über einen Zeitraum
misst. Zurzeit wird dieses StatsItem nicht verwendet.


TotalCountTimeIntervalItem

Misst die Gesamtanzahl über einen Zeitraum.


Ein StatsItem ist ein internes Messobjekt, das von der Engine erstellt wird, um
viele der Backend-Komponenten von Roblox zu benchmarken. Es kann nicht mit
`Datatype.Instance.new()` erstellt werden, aber sein Wert kann von Plugins gelesen werden. Sie sind
im `Class.Stats`-Dienst gespeichert.


StatsItem:GetValue

Gibt den Wert des StatsItem als formatierte Zeichenfolge zurück.


StatsItem:GetValueString

StatsItem

StatsItem.DisplayName

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie
und kann Teil des `Class.DataModel`-Baums sein.

Es ist nicht möglich, direkt Wurzel-`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 das Erkennen von Änderungen an der Abstammung einer Instanz, indem man sich mit dem
`Class.Instance.AncestryChanged` Ereignis verbindet.

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

Wird ausgelöst, wenn diese Instanz umgegliedert wird oder wenn einer ihrer Vorfahren
umgegliedert wird.

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


Instance.AncestryChanged

child

Die Instanz, deren `Class.Instance.Parent|Parent`-Eigenschaft geändert wurde,
was diese Instanz oder einen weiter entfernten Vorfahren sein kann, **nicht**
notwendigerweise die Instanz, mit der der Handler verbunden ist.


parent

Der neue Elternteil des `child`-Parameters.


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


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

Zum Beispiel verbindet der folgende Code-Schnipsel die Funktion `attributeChanged()`
, die ausgelöst wird, wenn eines der Attribute des Teils geändert wird:

```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 geändert wird.


Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.


Wird ausgelöst, wenn 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.

Hinweis: Wenn Sie diese Methode auf einem Client verwenden, um Objekte zu erkennen, die vom
Server erstellt wurden, ist es notwendig, `Class.Instance:WaitForChild()` zu verwenden, wenn
Sie die Nachkommen dieses Objekts indizieren. Dies liegt daran, dass das Objekt und seine
Nachkommen nicht garantiert gleichzeitig vom Server an den Client repliziert werden. 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)
```
Hinweis: Dieses Ereignis funktioniert nur für unmittelbare Kinder der
`Class.Instance`. 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 von dieser `Class.Instance` entfernt wurde.

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

Dieses Ereignis funktioniert 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 von 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 zur `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 sich nur um die **direkten Kinder** der
`Class.Instance` kümmern, verwenden Sie stattdessen `Class.Instance.ChildAdded`.

Siehe auch `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wird ausgelöst, nachdem ein Nachkomme zur `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 bevor** der Elternteil `Class.Instance`
geändert wird, sodass eine **Nachkomme**-Instanz nicht mehr ein
Nachkomme sein wird. `Class.Instance:Destroy()|Destroy()` ändert den Elternteil einer Instanz auf `nil`, sodass der Aufruf dieser Methode auf einem
Nachkommen des Elternteils dazu führt, dass dieses Ereignis ausgelöst wird.

Da dieses Ereignis **vor** der Entfernung des Nachkommens ausgelöst wird, bleibt der Elternteil
des Nachkommens zum Zeitpunkt des Auslösens 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 ausgelöst,
 gefolgt von seinen Nachkommen.

#### Warnung

Dieses Ereignis wird mit dem Nachkommenobjekt ausgelöst, das entfernt wird.
Der Versuch, den `Class.Instance.Parent|Parent` des Nachkommens auf
etwas anderes zu setzen, wird fehlschlagen. Unten ist ein Beispiel, das dies demonstriert:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipulieren Sie den Elternteil des Nachkommens in dieser Funktion nicht!
	-- Dieses Ereignis wird AUSGELÖST, WEIL der Elternteil manipuliert wurde, und die Änderung hat noch nicht stattgefunden
	-- Daher ist es problematisch, den Elternteil 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, wenn das Immediate-Signalverhalten verwendet wird,
bei der Zerstörung an Ort und Stelle bleibt, bis die verbundene Funktion anhalten muss.

In diesem Beispiel wird demonstriert, wie eine Instanz zerstört wird, bevor das Signal ausgelöst wird, wenn das Deferred-Signalverhalten verwendet wird.

Die `Class.Instance` wird niemals aus dem Speicher gelöscht, solange eine verbundene
Funktion sie noch verwendet. Wenn die Funktion jedoch zu irgendeinem Zeitpunkt anhält,
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 mit
`Class.Instance:Destroy()` zerstört wird.

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

Mit dem Verhalten `Enum.SignalBehavior.Deferred|Deferred` ist es problematisch, ein Skript
mit seinem eigenen `Class.Instance.Destroying`-Ereignis zu verbinden, da das Skript
vor dem Aufruf 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 über ein Plugin,
wird die `Class.Instance` nicht zerstört. Stattdessen wird der Elternteil auf `nil`
gesetzt, was Sie mit `Class.Instance.AncestryChanged` verfolgen können.


Instance.Destroying

Wird sofort ausgelöst, bevor (oder wird auf nachher verschoben) die Instanz über
`Class.Instance:Destroy()` zerstört wird.


Demonstriert `Class.Instance.StyledPropertiesChanged`.


Dieses Ereignis wird ausgelöst, wenn eine beliebige Stileigenschaft an der Instanz geändert wird,
 einschließlich wenn eine Eigenschaft auf `nil` gesetzt wird.


Instance.StyledPropertiesChanged

Wird ausgelöst, wenn eine beliebige Stileigenschaft 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 dass es Auswirkungen hat, wenn das Tag
bereits angewendet wurde. Das erfolgreiche Hinzufügen eines Tags löst ein Signal aus, das von
`Class.CollectionService:GetInstanceAddedSignal()` mit dem angegebenen Tag erstellt wurde.

#### Warnungen

- Die Tags einer Instanz, die clientseitig hinzugefügt wurden, werden verworfen, wenn der
  Server später ein Tag an dieser Instanz hinzufügt oder entfernt, da der Server
  alle Tags zusammen repliziert und vorherige Tags überschreibt.

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


Instance:AddTag

Das Tag, das auf die Instanz angewendet werden soll.


Die Kinderfunktion 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 Funkeln 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 **alle** Kinder und Nachkommen zerstören möchten, verwenden Sie entweder
`Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um
über diese Kinder/Nachkommen zu iterieren und auszuwählen, was zerstört werden soll. Zum
Beispiel wird der folgende Code alle
`Class.BasePart|BaseParts` zerstören, 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 Wurzelinstanz wird
von dieser Methode zurückgegeben und ihr `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ückgibt.

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

- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **auch** kopiert wurde,
  verweist die Kopie auf die Kopie.
- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **nicht** kopiert wurde,
  bleibt derselbe Wert in der Kopie erhalten.


Instance:Clone

Eine Kopie der Instanz oder `nil`, wenn die Instanz nicht
`Class.Instance.Archivable|Archivable` ist.


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

Die Entsorgung nicht benötigter Objekte ist wichtig, da unnötige Objekte und
Verbindungen in einem Ort Speicher verbrauchen, was im Laufe der Zeit zu ernsthaften
Leistungsproblemen führen kann.

Als bewährte Methode sollten Sie nach dem Aufrufen von `Destroy()` auf einem Objekt alle
Variablen, die auf das Objekt (oder seine Nachkommen) verweisen, auf `nil` setzen. Dies
verhindert, dass Ihr Code auf irgendetwas zugreift, das mit dem Objekt zu tun hat.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Machen Sie das nicht:
print(part.Name)  --> "Hello, world"
-- Machen Sie dies, um die obige Zeile zu verhindern:
part = nil
```
Sobald eine `Class.Instance` durch diese Methode zerstört wurde, kann sie 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 einer bestimmten Zeit 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 der `Class.Instance` zurück, dessen
`Class.Instance.Name` dem angegebenen Namen entspricht.

Diese Methode arbeitet nach oben, was bedeutet, dass sie beim unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben in Richtung des
`Class.DataModel` arbeitet. Wenn kein passender Vorfahr gefunden wird, gibt sie
`nil` zurück.

Der folgende Codeausschnitt würde den ersten Vorfahren des Objekts
mit dem Namen `Car` finden.

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


Instance:FindFirstAncestor

name

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


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


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

Diese Methode arbeitet nach oben, was bedeutet, dass sie beim unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben in Richtung des
`Class.DataModel` arbeitet. Wenn kein passender Vorfahr gefunden wird, gibt sie
`nil` zurück.

Ein häufiger Anwendungsfall dieser Methode ist das Finden des `Class.Model`, zu dem ein
`Class.BasePart` gehört. Zum Beispiel:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Diese Methode ist eine Variante von `Class.Instance:FindFirstAncestor()`, die
stattdessen die `Class.Object.ClassName`-Eigenschaft überprüft, anstatt
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` existiert ebenfalls,
und verwendet die `Class.Object:IsA()`-Methode, um die Klassenvererbung zu respektieren.


Instance:FindFirstAncestorOfClass

className

Der `Class.Object.ClassName`, nach dem gesucht werden soll.


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


Gibt den ersten Vorfahren der `Class.Instance` zurück, für den
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Diese Methode arbeitet nach oben, was bedeutet, dass sie beim unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben in Richtung des
`Class.DataModel` arbeitet. 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 Klassenvererbung respektiert. Zum Beispiel:

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

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


Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren der `Class.Instance` zurück, für den
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.


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 der `Class.Instance` mit dem angegebenen Namen zurück oder
`nil`, wenn kein solches Kind existiert. Wenn das optionale Argument `recursive`
`true` ist, sucht diese Methode alle Nachkommen und nicht nur die unmittelbaren Kinder der `Class.Instance`.

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

`FindFirstChild()` ist notwendig, wenn Sie überprüfen müssen, ob ein Objekt existiert,
bevor Sie fortfahren. Der Versuch, ein Kind nach Namen mit dem Punktoperator zu indizieren,
wirft einen Fehler, wenn das Kind nicht existiert.

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

-- Die folgende Zeile gibt einen Fehler aus, wenn das Teil nicht im Arbeitsbereich existiert
Workspace.Part.Transparency = 0.5
```
Ein besserer Ansatz ist es, `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

Manchmal ist der `Class.Instance.Name|Name` eines Objekts derselbe wie der einer
Eigenschaft seines `Class.Instance.Parent|Parent`. Wenn der Punktoperator verwendet wird,
haben Eigenschaften Vorrang vor Kindern, wenn sie denselben Namen teilen.

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, nicht auf die Kindinstanz `Class.Folder`. Ein Vorteil der Verwendung von
`Class.Instance:FindFirstChild()|FindFirstChild()` besteht darin, 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 Kindordner
```

#### Leistungsnotizen

`Class.Instance:FindFirstChild()|FindFirstChild()` dauert etwa 20 % länger
als die Verwendung des Punktoperators und fast 8 Mal länger als einfach das Speichern
eines Verweises auf ein Objekt. Daher sollten Sie vermeiden, es in leistungsabhängigem Code wie in engen Schleifen oder Funktionen zu verwenden, die mit
`Class.RunService.Heartbeat` und `Class.RunService.PreRender` verbunden sind. Stattdessen
speichern Sie das Ergebnis in einer Variablen oder ziehen Sie in Betracht, die
`Class.Instance.ChildAdded|ChildAdded` oder
`Class.Instance:WaitForChild()|WaitForChild()`-Methoden zu verwenden, um zu erkennen, wann ein Kind mit einem bestimmten Namen verfügbar wird.


Instance:FindFirstChild

recursive

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


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


Instance:findFirstChild

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


Instance:FindFirstChildOfClass

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


Gibt das erste Kind der `Class.Instance` zurück, für das
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Wenn kein passendes Kind gefunden wird, gibt diese Methode `nil` zurück. Wenn das optionale
rekursive Argument `true` ist, sucht diese Methode alle Nachkommen und nicht nur die unmittelbaren Kinder der `Class.Instance`.

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

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

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


Instance:FindFirstChildWhichIsA

Gibt das erste Kind der `Class.Instance` zurück, für das
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.


Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.

Diese Methode ist deaktiviert und kann nicht verwendet werden. Um den ersten Nachkommen
 einer Instanz zu finden, ziehen Sie in Betracht, das rekursive Argument bei
`Class.Instance:FindFirstChild()` zu verwenden.


Instance:FindFirstDescendant

Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.


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
Vorfahr 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 angegebenen
Attributnamen zugewiesen wurde. Wenn kein Attribut zugewiesen wurde, wird `nil` zurückgegeben.

Zum Beispiel setzt der folgende Codeausschnitt den Wert des Attributs `InitialPosition` der Instanz und ruft ihn dann ab:

```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()`, die das Attribut mit dem angegebenen
  Namen auf den angegebenen Wert setzt.
- `Class.Instance:GetAttributes()`, die ein Wörterbuch von Schlüssel-Wert-Paaren für jedes der Attribute der Instanz zurückgibt.


Instance:GetAttribute

Der Name des Attributs, das abgerufen werden soll.


Der Wert, der dem angegebenen 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 angegebene Attribut ändert; effektiv ist es ähnlich wie
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, jedoch für Attribute.

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

Das folgende Codebeispiel 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, wenn sich ein beliebiges
Attribut der Instanz ändert.


Instance:GetAttributeChangedSignal

Der Name des angegebenen 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 Wörterbuch von Schlüssel-Wert-Paaren für jedes Attribut zurück,
bei dem der Schlüssel der Name des Attributs und der Wert ein nicht `nil` Wert ist.

Zum Beispiel gibt der folgende Codeausschnitt 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()`, die den Wert zurückgibt, der dem angegebenen Attributnamen zugewiesen wurde.


Instance:GetAttributes

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


Gibt ein Wörterbuch 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 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, sodass eine manuelle Sortierung (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um die Kinder, die von dieser Methode zurückgegeben werden, zu sortieren.

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


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 für Plugins hilfreich sein, die ähnliche
  Objekte voneinander unterscheiden müssen (z. B. 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, findet 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, sodass eine manuelle Sortierung (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um die Nachkommen, die von dieser Methode zurückgegeben werden, zu sortieren. Ziehen Sie auch die
`Class.Instance:QueryDescendants()|QueryDescendants()`-Methode in Betracht, 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 Funktion `Class.Instance:GetFullName()` neu in
Lua.


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 kann ein `Class.Part` im `Class.Workspace`
`Class.Workspace.Part` zurückgeben.

Wenn diese Methode auf einer `Class.Instance` aufgerufen wird, die kein Nachkomme des
`Class.DataModel` ist, berücksichtigt diese Methode alle Vorfahren bis hin zu dem obersten,
 der kein `Class.Instance.Parent|Parent` hat.

Diese Methode ist nützlich für Protokollierung und Debugging. Sie sollten versuchen, die zurückgegebene Zeichenfolge nicht für nützliche Operationen zu parsen; diese Methode entkommt nicht den Punkten (oder einem anderen Symbol) in Objektnamen. Mit anderen Worten,
obwohl ihre Ausgabe oft wie ein gültiger Luau-Bezeichner aussieht, ist dies nicht garantiert.


Instance:GetFullName

Der vollständige Name der `Class.Instance`.


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


Demonstriert `Class.Instance:GetStyled()`.


Diese Methode gibt den stilisierten oder ausdrücklich modifizierten Wert der
angegebenen Eigenschaft zurück, oder den Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde. Dies unterscheidet sich leicht vom direkten Zugriff auf den Eigenschaftswert,
wie `[GuiObject].Rotation`, der den Standard- oder modifizierten Wert der Eigenschaft zurückgibt.


Instance:GetStyled

selector

Optionaler Selektor für die Pseudo-Instanz, die Sie auf der Instanz anvisieren.


Der stilisierte oder ausdrücklich modifizierte Wert der angegebenen Eigenschaft, oder
ansonsten der Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde.


Gibt den stilisierten oder ausdrücklich modifizierten Wert der angegebenen Eigenschaft zurück,
oder den Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde.


Demonstriert `Class.Instance:GetStyledPropertyChangedSignal()`.


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 sich die angegebene Stil-Eigenschaft ändert. Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` mit einer Funktion zu verwenden, die den Eigenschaftsnamen überprüft. Nachfolgende Aufrufe dieser Methode auf demselben Objekt mit demselben
Eigenschaftsnamen geben dasselbe Ereignis zurück.

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


Instance:GetStyledPropertyChangedSignal

property

Name der Stil-Eigenschaft, für die Änderungen überwacht werden sollen.


Ereignis, das ausgelöst wird, wenn sich die angegebene Stil-Eigenschaft ändert.


Gibt ein Ereignis zurück, das ausgelöst wird, wenn sich die angegebene Stil-Eigenschaft ändert.


Diese Methode gibt ein Array der Tags zurück, die auf die angegebene Instanz angewendet 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 gleichzeitig 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 nach einem bestimmten Tag zu suchen.


Instance:GetTags

Ein Array von Strings, die jeweils ein auf die Instanz angewendetes Tag darstellen.


Gibt ein Array aller Tags zurück, die auf die Instanz angewendet wurden.


Diese Methode gibt `true` zurück, wenn das angegebene 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

Das Tag, das auf der Instanz überprüft werden soll.


`true`, wenn die Instanz das angegebene Tag hat, andernfalls `false`.


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


Demonstriert, wie man bestimmt, ob eine Instanz der Vorfahr einer anderen ist, indem man
`Class.Instance:IsAncestorOf()` verwendet

Workspace und SpawnLocation sind Vorfahren des Dekors von SpawnLocation.
Workspace ist ein Vorfahr von SpawnLocation.

SpawnLocation und sein Dekor sind Nachkommen von Workspace, keine Vorfahren.
Dekor ist ein Nachkomme von SpawnLocation, kein Vorfahr.

Gibt `true` zurück, wenn eine `Class.Instance` ein Vorfahr des angegebenen
Nachkommen ist.

Eine `Class.Instance` wird als Vorfahr eines Objekts betrachtet, wenn der
`Class.Instance.Parent` des Objekts oder einer seiner Elternteile
`Class.Instance.Parent` auf die `Class.Instance` gesetzt ist.

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


Instance:IsAncestorOf

Wahr, wenn die `Class.Instance` ein Vorfahr des angegebenen Nachkommen ist.


Gibt `true` zurück, wenn eine `Class.Instance` ein Vorfahr des angegebenen
Nachkommen ist.


Gibt `true` zurück, wenn eine `Class.Instance` ein Nachkomme des angegebenen
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 die `Class.Instance` ein Nachkomme des angegebenen Vorfahren ist.


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


Instance:isDescendantOf

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

Zum Beispiel gibt die Abfrage der
`Class.TextLabel.BackgroundColor3|BackgroundColor3`-Eigenschaft eines
`Class.TextLabel`, das über das [Explorer](/studio/explorer)
fenster eingefügt wurde, `true` zurück, aber die Abfrage derselben Eigenschaft eines `Class.TextLabel`,
das durch `Datatype.Instance.new()` erstellt wurde, gibt `false` zurück, vorausgesetzt, es wurden keine
anderen Änderungen an seiner
`Class.TextLabel.BackgroundColor3|BackgroundColor3` vorgenommen.

Beachten Sie, dass diese Methode nur nützliche Ergebnisse für Dienste und
benutzererstellte Instanzen zurückgibt. Rückgabewerte für systembelegte Eigenschaften von
Instanzen wie `Class.PackageLink` sind undefiniertes Verhalten.

Beachten Sie auch, dass, wenn diese Methode `true` zurückgibt, das Styling **nicht** die
Eigenschaft beeinflusst, da das explizite Ändern einer Eigenschaft Vorrang vor dem Styling hat. Um eine Eigenschaft auf ihren code-instanzierten Standard zurückzusetzen und das Styling darauf zuzulassen, verwenden Sie
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Boolean, der angibt, ob die Eigenschaft von ihrem
code-instanzierten Standard geändert wurde.


Gibt `true` zurück, wenn der in der angegebenen Eigenschaft gespeicherte Wert nicht gleich dem
code-instanziierten Standard ist.


Diese Objektmethode gibt ein Array zurück, das alle Nachkommen des Objekts enthält, die mit dem angegebenen `selector`-String übereinstimmen. `selector` kann mehrere Selektoren und Kombinatoren enthalten, um Merkmale wie den
Klassennamen, den Instanznamen und Hierarchiebeziehungen sowie spezifische Werte von Instanzeigenschaften und Attributen abzugleichen. Die `selector`
Grammatik ähnelt der, die in `Class.StyleRule` verwendet wird, mit nur wenigen
Unterschieden hinsichtlich der unterstützten Teile der Grammatik.

#### Selektoren

- `ClassName` — Entspricht Instanzen der angegebenen Klasse in einer
  `Class.Object:IsA()`-Beziehung.
- `.Tag` — Entspricht Instanzen, die mit einem `Class.CollectionService`-Tag versehen sind.
- `#Name` — Entspricht Instanzen eines bestimmten `Class.Instance.Name`.
- `[property = value]` — Entspricht Instanzen, die die angegebene
  Eigenschaft haben und diese Eigenschaft den angegebenen Wert hat. Boolean-, Zahlen- und
  Zeichenfolgenwerte werden unterstützt. Buchstaben, Zahlen, `_` und `-` können ohne
  Anführungszeichen verwendet werden.
- `[$attribute]` — Entspricht Instanzen, die das angegebene
  [Attribut](/studio/properties#instance-attributes) gesetzt haben.
- `[$attribute = value]` — Entspricht Instanzen, die das angegebene
  Attribut **und** dieses Attribut den angegebenen Wert hat. Die gleichen
  Einschränkungen gelten wie für Eigenschaftsselektoren. Wenn Sie auf die Abwesenheit eines Attributs überprüfen möchten, fragen Sie es nicht als `nil` ab; verwenden Sie stattdessen die
  `:not`-Pseudo-Klasse wie in `:not([$attribute])`.

Selektoren können auch kombiniert werden. Zum Beispiel,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` entspricht Instanzen, die ein `Class.Model` sind, das als `Apple` gekennzeichnet ist und die ein `Variety`-Attribut haben, das gleich `Fuji` ist, sowie ein `Flavor`-Attribut, das gleich `4` ist.

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

-- Alle MeshPart-Nachkommen abrufen
print(Workspace:QueryDescendants("MeshPart"))

-- Alle Nachkommen abrufen, die als "Fruit" gekennzeichnet sind
print(Workspace:QueryDescendants(".Fruit"))

-- Alle Nachkommen abrufen, deren Name "RedTree" ist
print(Workspace:QueryDescendants("#RedTree"))

-- Alle Nachkommen abrufen, bei denen die CanCollide-Eigenschaft auf false gesetzt ist
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Alle Nachkommen abrufen, bei denen ein "FuelCapacity"-Attribut zugewiesen ist
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Alle Nachkommen abrufen, bei denen ein "FuelCapacity"-Attribut auf 75 gesetzt ist
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Kombinatoren

Kombinatoren ermöglichen es Ihnen, grundlegende Selektoren zu mischen, um tiefere Hierarchiebeziehungen abzugleichen.

- `>` — Entspricht Instanzen, die **direkte Kinder** der vorherigen
  Filterübereinstimmungen sind.

- `>>` — Entspricht Instanzen, die **Nachkommen** der vorherigen Filterübereinstimmungen sind. Dies ist der Standard erste Filter, was bedeutet, dass `SpotLight.Red`
  dasselbe ist wie `>> SpotLight.Red`.

- `,` — Gibt eine Liste mehrerer unabhängiger Selektoren für die
  Nachkommenabfrage an. Nur Elemente, die dem Filter entsprechen, werden im
  zurückgegebenen Array platziert; `nil` wird nicht für Nichtübereinstimmungen in einer Abfrageliste enthalten.

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

-- Direkte Kinder eines Modells abrufen, die als "SwordPart" gekennzeichnet sind
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Direkte Kinder abrufen, die ein Teil sind und als "Apple" gekennzeichnet sind
print(Workspace:QueryDescendants("> Part.Apple"))

-- Nachkommen eines Modells abrufen, bei dem ein Attribut "OnFire" auf true gesetzt ist
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- MeshPart-Nachkommen abrufen, die als "SwordPart" gekennzeichnet sind ODER mit einem Attribut "OnFire" auf true gesetzt
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Pseudo-Klassen-Selektoren

- `:not(complex-selector-list)` — Ermöglicht das Auswählen von Instanzen, die **nicht** mit
  einem der Selektoren innerhalb übereinstimmen, was effektiv eine
  Negation der Selektoren durchführt. Da der Ausdruck innerhalb eine Liste von
  komplexen Selektoren ist, ist es möglich, basierend auf mehreren Bedingungen zu filtern.

- `:has(relative-selector-list)` — Ermöglicht das Auswählen von Instanzen basierend darauf,
  welche Instanzen sie enthalten. Die Selektorliste wird relativ zu jeder Instanz ausgewertet.

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

-- Alle Nachkommen abrufen, die NICHT der Klasse SpotLight angehören
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Alle Nachkommen abrufen, die NICHT der Klasse SpotLight ODER PointLight angehören
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Alle Nachkommen abrufen, die kein Attribut "OnFire" haben
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Alle Nachkommen abrufen, die NICHT Kinder eines Modells sind, das als "SwordPart" gekennzeichnet ist
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Alle Nachkommen abrufen, die eine Tool-Instanz als eigenen Nachkommen enthalten
print(Workspace:QueryDescendants(":has(Tool)"))
-- MeshPart-Nachkommen abrufen, die ein direktes Kind haben, das als "SwordPart" gekennzeichnet ist
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- MeshPart-Nachkommen abrufen, deren direkte Kinder NICHT der Klasse SurfaceAppearance oder Texture angehören
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

Selektorzeichenfolge, die verwendet wird, um Elemente zu filtern.


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


Gibt ein Array zurück, das alle Nachkommen der Instanz enthält, die mit dem
`selector`-String übereinstimmen.


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. Es wird kein Fehler ausgelöst, wenn
das Objekt das Tag nicht hat. Das erfolgreiche Entfernen eines Tags löst ein
Signal aus, das von `Class.CollectionService:GetInstanceRemovedSignal()`
mit dem angegebenen Tag erstellt wurde.

Beachten Sie, dass beim Taggen einer Instanz häufig einige Ressourcen verwendet werden,
um dem Tag seine Funktionalität zu geben, z. B. Ereignisverbindungen oder Tabellen. Um Speicherlecks zu vermeiden, ist es eine gute Idee, diese aufzuräumen
(trennen, auf `nil` setzen usw.), wenn sie für ein Tag nicht mehr benötigt werden.


Instance:RemoveTag

Das Tag, das von der Instanz entfernt werden soll.


Setzt eine Eigenschaft auf ihren Standardwert zurück. Zum Beispiel ist das Aufrufen von
`ResetPropertyToDefault("Rotation")` auf einem `Class.TextLabel` gleichbedeutend
mit dem Setzen seiner `Class.TextLabel.Rotation|Rotation` auf `0` (den Standardwert der Eigenschaft). Diese Methode kann verwendet werden, um sicherzustellen, dass das Styling diesen Standardwert der Eigenschaft überschreibt.


Instance:ResetPropertyToDefault

Setzt eine Eigenschaft auf ihren Standardwert zurück.


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

Zum Beispiel 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

Benennungsanforderungen und -beschränkungen:

- Namen dürfen nur alphanumerische Zeichen verwenden.
  - Sie dürfen auch Punkte, Bindestriche, Schrägstriche und Unterstriche enthalten.
- Keine Leerzeichen oder einzigartigen 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-Kernskript (reserviert für Roblox).

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

#### Siehe auch

- `Class.Instance:GetAttribute()` gibt den Wert zurück, der dem angegebenen Attributnamen zugewiesen wurde.
- `Class.Instance:GetAttributes()` gibt ein Wörterbuch von Schlüssel-Wert-Paaren für jedes der Attribute der Instanz zurück.


Instance:SetAttribute

value

Der Wert, auf den das angegebene Attribut gesetzt werden soll.


Setzt das Attribut mit dem angegebenen Namen auf den angegebenen 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 angehalten, bis es existiert. Wenn
das `timeOut`-Parameter angegeben ist, wird diese Methode nach der
angegebenen Anzahl von Sekunden ablaufen und `nil` zurückgeben.

#### Hauptverwendung

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

#### Hinweise

- Diese Methode hält nicht an, 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ückzukehren, und kein
  `timeOut`-Parameter angegeben wurde, wird eine Warnung in der
  Ausgabe ausgegeben, dass der Thread möglicherweise unbegrenzt anhalten könnte.


Instance:WaitForChild

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


Instance

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie
und kann Teil des `Class.DataModel`-Baums sein.


/reference/engine/classes/TotalCountTimeIntervalItem.yaml