Dieser Callback wird einmal für jeden Spieler aufgerufen, sobald sein
Gerätevertrauensniveau verfügbar ist. Verwenden Sie ihn, um zu entscheiden,
ob der Spieler im Server bleiben kann, basierend auf `Class.Player.DeviceTrustLevel`
und der `measures`-Tabelle.

Beachten Sie Folgendes, wenn Sie diesen Callback zuweisen:

- Sie können ihn nur von einem serverseitigen `Class.Script` zuweisen.
  Eine Zuweisung von einem Client führt zu einem Fehler.
- Jeder Ort hat einen Callback. Wenn Sie ihn mehr als einmal zuweisen,
  ersetzt die letzte Zuweisung die vorherigen.
- Er wird ausgeführt, nachdem `Class.Players.PlayerAdded` ausgelöst wurde,
  da die Überprüfung des Geräts Zeit in Anspruch nimmt. Wenn er ausgeführt wird,
  ist `Class.Player.DeviceTrustLevel` niemals `Enum.PlayerDeviceTrustLevel.Pending|Pending`.
- Er kann yielden. Der Spieler spielt weiter, während er läuft, sodass ein
  abgelehnter Spieler nach dem Start des Spiels getrennt werden kann.
- Wenn der Spieler verlässt oder Ihre Skripte ihn entfernen, bevor sein
  Vertrauensniveau verfügbar ist, wird er nicht für diesen Spieler aufgerufen.
- Roblox überprüft Geräte im Studio nicht, daher wird er während
  Spieltests nicht aufgerufen.

Roblox filtert eine benutzerdefinierte `Message` und verkürzt Nachrichten,
die zu lang sind. Wenn das Filtern die Nachricht ändern würde, zeigt Roblox
stattdessen die Standardnachricht an.

Roblox kickt den Spieler in keinem der folgenden Fälle:

- Kein Skript weist den Callback zu.
- Der Callback gibt `nil`, einen Wert, der kein Table ist, oder ein Table
  ohne gültige `Action` zurück.
- Der Callback wirft einen Fehler. Roblox meldet den Fehler wie jeden
  anderen Skripterror.
- Der Callback gibt nicht rechtzeitig zurück.

Für Codebeispiele siehe
[Gerätevertrauen](/scripting/security/device-trust).


IntegrityService.EvaluatePlayerDeviceTrust

player

Der `Class.Player`, der bewertet wird. Ihr Vertrauensniveau ist bereits
in `Class.Player.DeviceTrustLevel` gesetzt, wenn dieser Callback ausgeführt wird.


measures

Eine Tabelle von Schlüssel-Wert-Paaren, die das Vertrauensniveau des Geräts
des Spielers erklären. Ein Wert von `true` bedeutet, dass das Gerät diese
Messung bestanden hat:

- `IsPlatformVersionSecure` &mdash; Das Betriebssystem ist auf oder
  über der minimalen Version, die Roblox als sicher betrachtet.
- `IsPlatformBootSecure` &mdash; Das Betriebssystem wurde in einem
  sicheren Zustand gestartet.
- `IsAppSecure` &mdash; Die Roblox-App wurde nicht manipuliert.

Eine Messung, die auf dem Gerät nicht verfügbar ist, liest `true`, also
prüfen Sie immer auch `Class.Player.DeviceTrustLevel`.


Eine Tabelle, die Roblox sagt, was mit dem Spieler zu tun ist, oder `nil`, um
ihn zu behalten:

- `Action` &mdash; Erforderlich. `Enum.PlayerDeviceTrustDecision.Reject`
  trennt den Spieler. `Enum.PlayerDeviceTrustDecision.Accept`
  behält ihn.
- `Message` &mdash; Optional. Die Nachricht, die ein abgelehnter Spieler sieht.
  Wenn Sie sie weglassen, zeigt Roblox eine Standardnachricht an, die erklärt,
  wie der Spieler sein Gerät möglicherweise reparieren kann.


Entscheidet, ob ein Spieler im Server bleiben kann, sobald sein
Gerätevertrauensniveau verfügbar ist.


`IntegrityService` stellt die API zur Verfügung, um das
[Gerätevertrauensniveau](/scripting/security/device-trust) jedes
Spielers zu messen, der Ihrem Spiel beitritt. Roblox ergreift keine Maßnahmen
basierend auf dem Gerätevertrauensniveau; stattdessen entscheiden Sie, was es
für Ihre Erfahrung bedeutet, wie z. B. das Ablehnen von Spielern auf
untrusted Geräten, das Einschränken sensibler Funktionen oder das
Umleiten von Spielern an einen anderen Ort.

Um jeden Spieler zu akzeptieren oder abzulehnen, sobald ihr Vertrauensniveau
verfügbar ist, weisen Sie eine Funktion zu
`Class.IntegrityService.EvaluatePlayerDeviceTrust|EvaluatePlayerDeviceTrust`.
Um das Vertrauensniveau eines Spielers jederzeit zu lesen, verwenden Sie
`Class.Player.DeviceTrustLevel`.

Das Gerätevertrauensniveau beschreibt das Gerät des Spielers, nicht den
Spieler oder sein Konto. **Es sagt Ihnen nicht, ob ein Spieler betrügt.**
Für Codebeispiele und Hinweise zur Auswahl einer Richtlinie siehe
[Gerätevertrauen](/scripting/security/device-trust).


IntegrityService

Ein Dienst, der es Ihnen ermöglicht zu entscheiden, wie Ihre Erfahrung auf das Vertrauensniveau des Geräts jedes Spielers reagiert.


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

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


Demonstriert 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,
 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()`
, um ausgelöst zu werden, 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 gegebenes 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 zum 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 an irgendeinem Punkt 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,
 einschließlich 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 auf 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 Root-Instanz 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.

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

Als bewährte Methode sollten Sie nach dem Aufrufen von `Destroy()` für ein 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 bis zum `Class.DataModel` hocharbeitet. Wenn kein
passender Vorfahr gefunden wird, gibt sie `nil` zurück.

Der folgende Code-Schnipsel 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 bis zum `Class.DataModel` hocharbeitet. 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 bis zum `Class.DataModel` hocharbeitet. 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 wird der folgende Code-Schnipsel den ersten
`Class.BasePart`-Vorfahren zurückgeben, 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 Sie den Punktoperator verwenden,
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 wird der folgende Code-Schnipsel das erste
`Class.BasePart`-Kind zurückgeben, 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 Code-Schnipsel 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 Attribut 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()`, aber
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
irgendein 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 Code-Schnipsel die Attribute und Werte einer Instanz aus:

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

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

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Siehe auch `Class.Instance:GetAttribute()`, die 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 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
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 einen codierten String der Debug-ID zurück, die intern von Roblox verwendet wird. Beachten Sie,

- Dieser Artikel ist geschützt. Der Versuch, ihn 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 einen codierten String 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 einen String zurück, der die Abstammung der Instanz beschreibt. Der String 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, den zurückgegebenen String 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 einen String zurück, der 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,
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 Ä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 auf der
Instanz ä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
nach der 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 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
Nachkommens 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 Nachkommens ist.


Gibt `true` zurück, wenn eine `Class.Instance` ein Vorfahr des angegebenen
Nachkommens 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)
hinzugefü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
  Stringwerte 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, die den Namen "RedTree" haben
print(Workspace:QueryDescendants("#RedTree"))

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

-- Alle Nachkommen abrufen, die ein "FuelCapacity"-Attribut zugewiesen haben
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]"))

-- 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 komplexer 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 KEINE 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

Selektor-String, der verwendet wird, um Elemente zu filtern.


Ein Array von Instanzen (leer, wenn nichts dem Selektor entsprach).


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 das `Class.Instance.Parent` des Objekts auf `nil` und macht
dasselbe für alle seine Nachkommen.

Wenn das Objekt referenziert wird, bevor es entfernt wird, ist es möglich, das Objekt zu einem späteren Zeitpunkt abzurufen.


Instance:Remove

Setzt das `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
das 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 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 Attribut 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.


Instance

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


/reference/engine/classes/IntegrityService.yaml

Zusammenfassung