`UIGradient` wendet einen Farb- und Transparenzverlauf auf das übergeordnete
`Class.GuiObject` an. Das Erscheinungsbild des Verlaufs ist über seine
`Class.UIGradient.Color|Color`, `Class.UIGradient.Transparency|Transparency`,
`Class.UIGradient.Offset|Offset`, `Class.UIGradient.Rotation|Rotation`,
`Class.UIGradient.Scale|Scale`, `Class.UIGradient.TileMode|TileMode` und
`Class.UIGradient.Type|Type` konfigurierbar.

`UIGradient` wird nicht auf untergeordnete oder abgeleitete
`Class.GuiObject|GuiObjects` angewendet. Um denselben Verlauf auf mehrere
Objekte anzuwenden, benötigen Sie mehrere Verlauf-Instanzen.

Siehe auch [Erscheinungsmodifikatoren](/ui/appearance-modifiers#gradient)
für weitere Informationen zum `UIGradient`-Modifikator und wie er funktioniert.

#### Unterstützte Objekte

Sie können `UIGradient`-Modifikatoren auf `Class.Frame`, `Class.TextLabel`,
`Class.TextButton`, `Class.ImageLabel`, `Class.ImageButton`, `Class.Path2D`,
und `Class.ViewportFrame` anwenden. `Class.ScrollingFrame` und `Class.TextBox`
sind jedoch derzeit nicht unterstützt.

#### Leistungsüberlegungen

Um `UIGradient` effizient zu nutzen, befolgen Sie diese Grundsätze:

- Vermeiden Sie es, mehr als 6 Farbstopps in der `Class.UIGradient.Color|Color`
  Sequenz zu verwenden.

- Vermeiden Sie die Verwendung eines `UIGradient` auf einem Objekt, das einen Textschatten
  anwendet (`Class.TextLabel.TextStrokeColor3|TextStrokeColor3`), da der Verlauf
  versucht, mit Schatten und Rändern zu verschmelzen, was zu Leistungsproblemen führen kann.

- Vermeiden Sie es, `Class.UIGradient.Color|Color` und
  `Class.UIGradient.Transparency|Transparency` häufig zu setzen: Dies führt dazu, dass die
  Farbsequenz häufig neu aufgebaut wird, was teuer ist. Wenn möglich, setzen Sie
  diese Eigenschaften nur einmal und versuchen Sie, die
  `Class.UIGradient.Offset|Offset` oder `Class.UIGradient.Rotation|Rotation`
  Eigenschaften zu animieren, um einen ähnlichen Effekt zu erzielen. Alternativ können Sie die
  Farbe des übergeordneten `Class.GuiObject` mit Eigenschaften wie
  `Class.GuiObject.BackgroundColor3|BackgroundColor3`,
  `Class.ImageLabel.ImageColor3|ImageColor3` oder
  `Class.TextLabel.TextColor3|TextColor3` ändern.

- Wenn Sie einen unveränderlichen Verlauf auf einem UI-Element anwenden, dessen Zustand sich
  häufig ändert, gibt es einen Kompromiss zwischen der Verwendung eines `UIGradient` (Verarbeitungszeit)
  und einem statischen Verlauf-Bild (Speicher).


UIGradient

Diese Eigenschaft beschreibt die Farbe, die mit dem übergeordneten
`Class.GuiObject` entlang der bereitgestellten `Datatype.ColorSequence` gemischt wird. Diese
Eigenschaft funktioniert ähnlich wie `Class.Beam.Color` oder
`Class.Trail.Color`, mit dem Unterschied, dass sie über eine Entfernung angewendet wird,
die durch die `Class.UIGradient.Offset|Offset` und
`Class.UIGradient.Rotation|Rotation` bestimmt wird.


UIGradient.Color

Bestimmt die Farbe, die mit dem übergeordneten `Class.GuiObject` entlang der
Länge des Verlaufs gemischt wird.


UIGradient.Enabled

Diese Eigenschaft bestimmt die skalare Verschiebung des Verlaufs vom
Zentrum des übergeordneten `Class.GuiObject`. Es handelt sich um eine skalare Verschiebung,
was bedeutet, dass der tatsächliche Pixelversatz durch die
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` des übergeordneten
`Class.GuiObject` bestimmt wird. Zum Beispiel verschiebt ein Wert von `(1, 0)` den Verlauf
horizontal nach rechts um eine Entfernung, die der Größe des übergeordneten Objekts entspricht.
Je nach `Class.UIGradient.Rotation|Rotation` kann dies dazu führen, dass der Verlauf teilweise sichtbar oder gar nicht sichtbar ist.

Siehe auch `Class.UIGradient.Rotation|Rotation`, die ebenfalls die
Geometrie des angewendeten Verlaufs beeinflusst.


UIGradient.Offset

Bestimmt die skalare Verschiebung des Verlaufs vom Zentrum des
übergeordneten `Class.GuiObject`.


Diese Eigenschaft bestimmt die **im Uhrzeigersinn** Rotation in Grad des
`UIGradient`, beginnend von links nach rechts. Die Anfangs- und Endkontrollpunkte
schnappen an die Ränder des übergeordneten `Class.GuiObject`, behalten jedoch die
bereitgestellte Rotation bei.

Siehe auch `Class.UIGradient.Offset|Offset`, die ebenfalls die Geometrie
des angewendeten Verlaufs beeinflusst.


UIGradient.Rotation

Bestimmt die im Uhrzeigersinn gerichtete Drehung in Grad des Verlaufs, beginnend von
links nach rechts.

Diese Eigenschaft multipliziert das Ausmaß des Verlaufs und steuert, wie viel
von der Farb-/Transparenzsequenz innerhalb des übergeordneten
`Class.GuiObject` sichtbar ist.

- Ein Wert von `1` (Standard) bedeutet, dass die gesamte Sequenz das Element
  genau einmal umfasst.

- Werte **weniger** als `1` komprimieren den Verlauf, sodass die gesamte Sequenz
  in einem kleineren Bereich passt. Der verbleibende Bereich wird durch
  `Class.UIGradient.TileMode|TileMode` bestimmt. Beachten Sie, dass `Scale` auf ein
  Minimum von `0.001` begrenzt ist, um degenerierte Verläufe zu vermeiden.

- Werte **größer** als `1` dehnen den Verlauf über die Elementgrenzen hinaus,
  sodass nur ein Teil der Sequenz sichtbar ist.

Die Wirkung von `Scale` hängt auch vom
`Class.UIGradient.Type|Type` des Verlaufs ab:

- `Enum.GradientType.Linear` — `Scale` beeinflusst den Abstand zwischen den
  Start- und Endkontrollpunkten.

- `Enum.GradientType.Radial` — `Scale` beeinflusst den Radius des radialen
  Verlaufs.

- `Enum.GradientType.Conical` — `Scale` beeinflusst den Winkelbereich, der so
  begrenzt ist, dass der Bereich eine volle Umdrehung nicht überschreitet.

Siehe auch `Class.UIGradient.TileMode|TileMode`, das bestimmt, wie der
Verlauf wiederholt wird, wenn `Scale` dazu führt, dass er nicht das gesamte Element ausfüllt.


UIGradient.Scale

Multipliziert das Ausmaß des Verlaufs und steuert, wie viel von der
Farb-/Transparenzsequenz innerhalb des Elements sichtbar ist.


Diese Eigenschaft bestimmt, was passiert, wenn der Verlauf
`Class.UIGradient.Scale|Scale` weniger als `1` ist oder wenn
`Class.UIGradient.Offset|Offset` den Verlauf verschiebt, sodass er das Element nicht
vollständig abdeckt. Siehe `Enum.GradientTileMode` für mögliche Werte
und deren Auswirkungen.

Siehe auch `Class.UIGradient.Scale|Scale`, das steuert, wie viel von der
Farb-/Transparenzsequenz sichtbar ist.


UIGradient.TileMode

Bestimmt, wie der Verlauf wiederholt wird.


Diese Eigenschaft beschreibt, wie undurchsichtig das übergeordnete UI-Element entlang der
bereitgestellten `Datatype.NumberSequence` sein wird. Diese Eigenschaft funktioniert ähnlich
wie `Class.Beam.Transparency` oder `Class.Trail.Transparency`, mit dem Unterschied,
dass sie über eine Entfernung angewendet wird, die durch die
`Class.UIGradient.Offset|Offset` und `Class.UIGradient.Rotation|Rotation` bestimmt wird.

Beachten Sie, dass die Hüllwertwerte der
`Datatype.NumberSequenceKeypoint|NumberSequenceKeypoints` ignoriert werden.


UIGradient.Transparency

Bestimmt, wie viel vom übergeordneten `Class.GuiObject` entlang der
Länge des Verlaufs sichtbar sein kann.


Diese Eigenschaft bestimmt, wie der Verlauf über das übergeordnete
`Class.GuiObject` variiert. Siehe `Enum.GradientType` für mögliche Werte und deren
Auswirkungen.

Siehe auch `Class.UIGradient.Scale|Scale`, das steuert, wie viel von der
Farb-/Transparenzsequenz sichtbar ist, und
`Class.UIGradient.TileMode|TileMode`, das das Wiederholungsverhalten bestimmt.


UIGradient.Type

Bestimmt die Form des Verlaufs als linear, radial oder konisch.


Wendet einen Farb- und Transparenzverlauf auf das übergeordnete `Class.GuiObject` an.


Eine Basisklasse für UI-Constraints und Layout-Klassen; erbt von
`Class.UIBase`.


UIComponent

Eine Basisklasse für UI-Constraints und Layout-Klassen.


`Class.UIBase` ist die Basisklasse für UI-Layouts und Einschränkungs-Klassen.


UIBase

`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, 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 Code-Schnipsel die Funktion `attributeChanged()`
so dass sie 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.

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 auf die Nachkommen dieses Objekts zugreifen. 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, während 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, wann immer eine Stil-Eigenschaft an der Instanz geändert wird,
auch wenn eine Eigenschaft auf `nil` gesetzt wird.


Instance.StyledPropertiesChanged

Wird ausgelöst, wann immer 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 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 zu 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 zu zerstören ist. 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 diese Methode `nil` zurückgibt, wenn die Instanz selbst
`Class.Instance.Archivable|Archivable` auf `false` gesetzt hat.

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 funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. 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 funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. 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
die `Class.Object.ClassName`-Eigenschaft anstelle von
`Class.Instance.Name` überprüft. `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 funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. 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 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()` benötigt 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, die mit
`Class.RunService.Heartbeat` und `Class.RunService.PreRender` verbunden sind, aufzurufen. Stattdessen
speichern Sie das Ergebnis in einer Variablen oder ziehen Sie in Betracht, `Class.Instance.ChildAdded|ChildAdded`
oder `Class.Instance:WaitForChild()|WaitForChild()` zu verwenden, um zu erkennen, 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 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 nach einem 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()`, das das Attribut mit dem angegebenen
  Namen auf den angegebenen Wert setzt.
- `Class.Instance:GetAttributes()`, das 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.

Der folgende Codeausschnitt 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, wobei 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()`, das den Wert zurückgibt, der dem angegebenen Attributnamen zugewiesen wurde.


Instance:GetAttributes

Ein Wörterbuch von String → Variant-Paaren für jedes Attribut, wobei der
String der Name des Attributs und der Variant 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
manuelles Sortieren (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um
 die Kinder, die von dieser Methode zurückgegeben werden, 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 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
manuelles Sortieren (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um
 die Nachkommen, die von dieser Methode zurückgegeben werden, zu sortieren. Ziehen Sie auch die
Methode `Class.Instance:QueryDescendants()|QueryDescendants()` 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 sie 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 anderen Symbolen) 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
generell 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,
so dass der Wert der geänderten Eigenschaft direkt innerhalb eines
Skripts gelesen werden muss.


Instance:GetStyledPropertyChangedSignal

property

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


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)
 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 systembefüllte 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. Dieselben
  Einschränkungen gelten wie für Eigenschaften-Selektoren. 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, deren CanCollide-Eigenschaft auf false gesetzt ist
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Alle Nachkommen abrufen, denen ein "FuelCapacity"-Attribut zugewiesen ist
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Alle Nachkommen abrufen, deren "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 Standardfilter, 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, dessen Attribut "OnFire" auf true gesetzt ist
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Nachkommen von MeshPart, 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 ihren 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

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


Instance

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


/reference/engine/classes/UIGradient.yaml