`Class.BillboardGui` ist ein Container für UI-Objekte, die im 3D-Raum angezeigt werden,
aber immer auf die Kamera ausgerichtet sind. Die Position des Containers ist relativ zum Eltern-
`Class.BasePart` oder `Class.Attachment` (oder dem
`Class.BillboardGui.Adornee|Adornee`). Für `Class.BasePart|BaseParts` wird die
`Class.BasePart.Position|Position`-Eigenschaft verwendet, während für
`Class.Attachment|Attachments` die
`Class.Attachment.WorldPosition|WorldPosition`-Eigenschaft verwendet wird.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui mit einem TextLabel, das die Bildschirmkonsole beschreibt, über der es schwebt." />

Die `Class.BillboardGui.Size|Size`-Eigenschaft eines Billboards funktioniert leicht
anders als `Class.GuiObject.Size`. Während die **Offset**-Komponenten gleich funktionieren,
werden die **Skalierungs**-Komponenten als Stud-Größen im 3D-Raum verwendet.

Beim Erstellen eines größen-scalierenden `Class.BillboardGui`, das ein
`Class.TextLabel` enthält, ist es nützlich, die `Class.TextLabel.TextScaled|TextScaled`
Eigenschaft des Labels zu aktivieren, damit der Text zusammen mit der
Billboard-Leinwand skaliert, wenn sich der Abstand zur Kamera ändert.

Beachten Sie, dass interaktive UI-Elemente wie `Class.ImageButton|ImageButtons`
und `Class.TextButton|TextButtons` innerhalb eines `Class.BillboardGui` nur Eingaben von
Benutzern empfangen, wenn sie dem `Class.PlayerGui` zugeordnet sind, typischerweise durch das
Platzieren des `Class.BillboardGui` innerhalb von `Class.StarterGui`. Die
`Class.BillboardGui.Adornee|Adornee`-Eigenschaft kann verwendet werden, um ein Teil oder
eine Anhängung in der 3D-Welt anzusprechen, während das `Class.BillboardGui`
selbst im `Class.PlayerGui` bleibt.

Siehe [In-Experience UI](/ui/in-experience-containers#billboard-ui)
für einen Leitfaden zur Arbeit mit `Class.BillboardGui` Containern.

##### Caching-Verhalten

Um die Leistung zu verbessern, wird das Aussehen eines `Class.BillboardGui`
zwischengespeichert, bis eines der folgenden Ereignisse eintritt, nach dem das
Aussehen im nächsten Rendering-Rahmen neu berechnet wird.

- Ein Nachfahre wird zum `Class.BillboardGui` hinzugefügt oder entfernt.
- Eine Eigenschaft eines Nachfahren des `Class.BillboardGui` ändert sich.
- Eine Eigenschaft des `Class.BillboardGui` selbst ändert sich.


BillboardGui

Steuert, ob die Nachfahren Eingaben erhalten. Wenn das
`Class.BillboardGui` einen `Class.GuiButton` enthält, wird dieser Button nur dann klickbar,
wenn `Class.BillboardGui.Active|Active` auf `true` sowohl für das
`Class.BillboardGui` als auch für den Button gesetzt ist.

Beachten Sie, dass interaktive UI-Elemente wie `Class.ImageButton|ImageButtons`
und `Class.TextButton|TextButtons` innerhalb eines `Class.BillboardGui` nur
Benutzereingaben empfangen, wenn sie dem `Class.PlayerGui` zugeordnet sind,
typischerweise durch das Platzieren des `Class.BillboardGui` innerhalb von
`Class.StarterGui`. Die `Class.BillboardGui.Adornee|Adornee`-Eigenschaft kann verwendet werden,
um ein Teil oder eine Anhängung in der 3D-Welt anzusprechen, während das
`Class.BillboardGui` selbst im `Class.PlayerGui` bleibt.


BillboardGui.Active

Steuert, ob die Nachfahren Eingaben erhalten.


Legt den Ziel-`Class.BasePart` oder `Class.Attachment` fest, auf die das
`Class.BillboardGui` relativ positioniert ist, und überschreibt den Elternteil
oder die Anhängung.


BillboardGui.Adornee

Legt den Zielteil oder die Anhängung fest, auf die das
`Class.BillboardGui` relativ positioniert ist.


Diese Eigenschaft bestimmt, ob das `Class.BillboardGui` immer
über anderen 3D-Objekten gerendert wird.

Wenn sie auf `false` (Standard) gesetzt ist, rendert das `Class.BillboardGui` wie andere
3D-Inhalte und wird von anderen 3D-Objekten verdeckt. Wenn sie auf `true` gesetzt ist, rendert das
`Class.BillboardGui` immer über 3D-Inhalten und das Aussehen ändert sich erheblich:

- Farben entsprechen dem, wie sie innerhalb eines `Class.ScreenGui` erscheinen.
- Text kann auf hochauflösenden Geräten schärfer erscheinen.
- `Class.BillboardGui.LightInfluence|LightInfluence` wird behandelt, als wäre es `0`.
- `Class.BillboardGui.Brightness|Brightness` hat keinen Effekt.


BillboardGui.AlwaysOnTop

Bestimmt, ob das `Class.BillboardGui` immer über anderen 3D-Objekten gerendert wird.


Diese Eigenschaft bestimmt den Faktor, um den das Licht des `Class.BillboardGui`
Containers skaliert wird, wenn
`Class.BillboardGui.LightInfluence|LightInfluence` `0` ist. Standardmäßig ist diese
Eigenschaft `1` und kann auf jede Zahl zwischen `0` und `1000` gesetzt werden.
Durch Ändern dieser Eigenschaft kann die scheinbare Helligkeit eines
`Class.BillboardGui` besser an seine Umgebung angepasst werden. Zum
Beispiel kann ein Videobillboard in einem dunklen Raum aufgehellt werden,
indem `Class.BillboardGui.Brightness|Brightness` auf `10` erhöht wird.

Beachten Sie, dass `Class.BillboardGui.Brightness|Brightness` in
Studio nicht zugänglich ist und keinen Effekt hat, wenn entweder
`Class.BillboardGui.LightInfluence|LightInfluence` `1` ist oder
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` `true` ist.


BillboardGui.Brightness

Bestimmt den Faktor, um den das Licht des `Class.BillboardGui`-Containers skaliert wird,
wenn `Class.BillboardGui.LightInfluence|LightInfluence` `0` ist.


Wenn auf `true` (Standard) gesetzt, werden Teile von `Class.GuiObject|GuiObjects`,
die außerhalb der `Class.BillboardGui`-Leinwandgrenzen liegen, nicht gezeichnet.

Selbst wenn diese Eigenschaft `false` ist, werden `Class.GuiObject|GuiObjects`, die **vollständig**
aus der Leinwand liegen, nicht gerendert.


BillboardGui.ClipsDescendants

Ob Teile von `Class.GuiObject|GuiObjects`, die außerhalb der
`Class.BillboardGui`-Leinwandgrenzen liegen, gezeichnet werden.


Der aktuelle Abstand in Studs, den das `Class.BillboardGui` von der
Spielerkamera hat. Ein Änderungsereignis wird für diese Eigenschaft nicht
ausgelöst, es sei denn, `Class.BillboardGui.DistanceStep|DistanceStep` ist mehr als `0`.


BillboardGui.CurrentDistance

Der aktuelle Abstand in Studs, den das `Class.BillboardGui` von der
Spielerkamera hat.


Bestimmt den Abstand in Studs, bei dem das `Class.BillboardGui`
aufhört, größer zu werden, relativ zur aktuellen Kamera des Spielers,
mit einem Standard von `0`. Wenn die
`Class.BillboardGui.CurrentDistance|CurrentDistance` des
`Class.BillboardGui` unter diesem Wert liegt, wird es nicht größer skaliert,
als es bei diesem Abstand wäre.


BillboardGui.DistanceLowerLimit

Bestimmt den Abstand in Studs, bei dem das `Class.BillboardGui`
aufhört, größer zu werden.


Bestimmt die Größen-`Class.BillboardGui.CurrentDistance|CurrentDistance`
Inkremente und -Dekremente in Studs, während sich die Kamera des Spielers näher
und weiter vom `Class.BillboardGui` bewegt. Die Eigenschaft hat standardmäßig den Wert `0`.


BillboardGui.DistanceStep

Bestimmt die Größen-`Class.BillboardGui.CurrentDistance|CurrentDistance`
Inkremente und -Dekremente in Studs, während sich die Kamera des Spielers näher
und weiter vom `Class.BillboardGui` bewegt.


Bestimmt den Abstand in Studs, bei dem das `Class.BillboardGui`
aufhört, kleiner zu werden, relativ zur aktuellen Kamera des Spielers. Wenn die
`Class.BillboardGui.CurrentDistance|CurrentDistance` des
`Class.BillboardGui` über diesem Wert liegt, wird es nicht kleiner skaliert,
als es bei diesem Abstand wäre.

Diese Eigenschaft wird ignoriert, wenn der Wert kleiner als `0` ist. Der Standardwert
ist `-1`, was bedeutet, dass die Eigenschaft standardmäßig ignoriert wird.


BillboardGui.DistanceUpperLimit

Bestimmt den Abstand in Studs, bei dem das `Class.BillboardGui`
aufhört, kleiner zu werden.


Diese Eigenschaft bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` offset ist, relativ zur
`Class.Camera`-Orientierung, in Einheiten, die die Hälfte der Dimensionen
von der achsenausgerichteten Bounding-Box des Modells darstellen.

Siehe auch `Class.BillboardGui.StudsOffset|StudsOffset`, das ähnlich funktioniert,
aber Stud-Einheiten verwendet, oder
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, das ähnlich funktioniert,
außer dass die Offset-Orientierung relativ zu den globalen Achsen ist.


BillboardGui.ExtentsOffset

Bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` offset ist, relativ zur
`Class.Camera`-Orientierung, in Einheiten, die die Hälfte der Dimensionen
von der achsenausgerichteten Bounding-Box des Modells darstellen.


Diese Eigenschaft bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` offset ist, relativ zu den globalen Achsen,
 in Einheiten, die die Hälfte der Dimensionen der achsenausgerichteten Bounding-Box
des Modells darstellen.

Siehe auch `Class.BillboardGui.StudsOffset|StudsOffset`, das ähnlich funktioniert,
aber Stud-Einheiten verwendet, oder
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, das ähnlich funktioniert,
außer dass die Offset-Orientierung relativ zur `Class.Camera` ist.


BillboardGui.ExtentsOffsetWorldSpace

Bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` offset ist, relativ zu den globalen Achsen,
 in Einheiten, die die Hälfte der Dimensionen der achsenausgerichteten Bounding-Box
des Modells darstellen.


Steuert, wie sehr das `Class.BillboardGui` von der Umgebungsbeleuchtung beeinflusst wird,
 in einem Bereich von `0` bis `1`. Wenn dies auf `1` gesetzt ist, bedeutet das,
dass die umgebende Beleuchtung vollständige Kontrolle über das Aussehen hat,
während das Setzen auf `0` bedeutet, dass die Beleuchtung keinen Einfluss hat.


BillboardGui.LightInfluence

Steuert, wie sehr das `Class.BillboardGui` von der Umgebungsbeleuchtung beeinflusst wird.


Diese Eigenschaft steuert, wie weit vom Kamera das `Class.BillboardGui`
gezeigt wird, bevor es aufhört zu rendern. Ein Wert von `0` oder `inf`
(Standard) bedeutet, dass es keine Grenze gibt und es unendlich weit gerendert wird.

Für `Class.BillboardGui|BillboardGuis`, die im Freien erscheinen, wird empfohlen,
dass `Class.BillboardGui.MaxDistance|MaxDistance` hoch genug ist,
um sicherzustellen, dass die UI des Containers auf dem Bildschirm ausreichend klein ist,
wenn sie erscheint oder verschwindet, wodurch der plötzliche Pop-in/Pop-out-Effekt minimiert wird.


BillboardGui.MaxDistance

Steuert, wie weit das `Class.BillboardGui` angezeigt werden kann, bevor es
aufhört zu rendern.


Wird von Skripten verwendet, um das `Class.BillboardGui` für einen bestimmten Spieler zu verstecken.

Um ein `Class.BillboardGui` für mehr als einen Spieler zu verstecken, setzen Sie es in
`Class.StarterGui` und verwenden Sie ein Skript, um die
`Class.BillboardGui.Enabled|Enabled`-Eigenschaft entsprechend zu setzen, ob der
`Class.Players.LocalPlayer|LocalPlayer` es sehen können sollte. Die
`Class.BillboardGui.Adornee|Adornee`-Eigenschaft kann verwendet werden, um das
`Class.BillboardGui` an einen `Class.BasePart` oder `Class.Attachment` im
`Class.Workspace` zu befestigen, anstatt es zu verankern.


BillboardGui.PlayerToHideFrom

Wird von Skripten verwendet, um das `Class.BillboardGui` für einen bestimmten Spieler zu verstecken.


Steuert die Größe, die das `Class.BillboardGui` auf dem Bildschirm haben wird.
Im Gegensatz zu `Class.GuiObject.Size`, setzen die
[Skalierungs](/ui/position-and-size#size)-Komponenten dieser Eigenschaft
die Größe des Billboards in 3D-Raum.


BillboardGui.Size

Steuert die Größe, die das `Class.BillboardGui` auf dem Bildschirm haben wird.


Ein 2D-Offset in größenrelativen Einheiten, das wie ein Ankerpunkt funktioniert. Dies
kann ähnlich wie die `Class.GuiObject.AnchorPoint` Eigenschaften verwendet werden, aber
die Werte sind unterschiedlich.

<table size="small">
<thead>
<th>Größen-Offset</th>
<th>Erklärung</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>Der Standard, bei dem die UI in der Mitte verankert ist.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>Die UI wird in der unteren linken Ecke verankert.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>Die UI wird in der oberen linken Ecke verankert.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>Die UI wird in der oberen rechten Ecke verankert.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>Die UI wird in der unteren rechten Ecke verankert.</td>
</tr>
</tbody>
</table>

Siehe auch `Class.BillboardGui.StudsOffset|StudsOffset`,
`Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, und
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, die
Offset-Eigenschaften sind, die stattdessen im 3D-Raum funktionieren.


BillboardGui.SizeOffset

Ein 2D-Offset in größenrelativen Einheiten, das wie ein Ankerpunkt funktioniert.


Diese Eigenschaft bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` in Studs offset ist,
relativ zur `Class.Camera`-Orientierung.

Siehe auch `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
das ähnlich funktioniert, außer dass die Offset-Orientierung relativ zu den
globalen Achsen ist.


BillboardGui.StudsOffset

Bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` in Studs offset ist,
relativ zur `Class.Camera`-Orientierung.


Diese Eigenschaft bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` in Studs offset ist,
relativ zu den globalen Achsen.

Siehe auch `Class.BillboardGui.StudsOffset|StudsOffset`, das ähnlich funktioniert,
außer dass die Offset-Orientierung relativ zur `Class.Camera` ist.


BillboardGui.StudsOffsetWorldSpace

Bestimmt, wie das `Class.BillboardGui` von seinem
`Class.BillboardGui.Adornee|Adornee` in Studs offset ist,
relativ zu den globalen Achsen.


Ein Container für `Class.GuiObject|GuiObjects`, der im 3D-Raum gerendert wird
ausgerichtet auf die Kamera.


**LayerCollector** ist die Basisklasse von 2D-UI-Containern, die Nachkommen von
`Class.GuiObject`, wie `Class.ScreenGui`, rendern.

Für Verbesserungen der Leistung wird das Erscheinungsbild eines `Class.LayerCollector`
gespeichert, bis eines der folgenden Ereignisse eintritt:

- Ein Nachkomme wird hinzugefügt oder entfernt.
- Eine Eigenschaft eines Nachkommens ändert sich.
- Eine Eigenschaft des `Class.LayerCollector` selbst ändert sich.

LayerCollector:GetLayoutNodeTree

LayerCollector

Wechselt die Sichtbarkeit dieses `Class.LayerCollector`. Wenn `false`, werden die
UI-Inhalte nicht gerendert, verarbeiten keine Benutzereingaben und aktualisieren sich nicht als Reaktion auf
Änderungen.

LayerCollector.Enabled

Wechselt die Sichtbarkeit dieses `Class.LayerCollector`.

Wenn auf `false` gesetzt und dieser `Class.LayerCollector` ein direktes Kind von
`Class.StarterGui` ist, wird er nur einmal in das `Class.PlayerGui` jedes Spielers
kopiert und nicht gelöscht, wenn der Charakter des Spielers neu erscheint.

Wenn auf `true` (Standard) gesetzt oder wenn dieser `Class.LayerCollector` ein
**indirekter** Nachkomme von `Class.StarterGui` ist, wird er in das `Class.PlayerGui`
jedes Spielers kopiert, wenn deren Charakter neu erscheint, und er löscht sich selbst,
wenn der Charakter des Spielers erneut neu erscheint.

LayerCollector.ResetOnSpawn

Bestimmt, ob der `Class.LayerCollector` zurückgesetzt wird (sich selbst löscht und
wieder in das `Class.PlayerGui` des Spielers klont), jedes Mal, wenn der Charakter des Spielers neu erscheint.

Steuert, wie `Class.GuiObject.ZIndex` sich auf alle Nachkommen dieses
`Class.LayerCollector` verhält.

Mit `Enum.ZIndexBehavior.Sibling` (Standard) werden Kinder immer über
ihren Eltern gerendert, und der `Class.GuiObject.ZIndex|ZIndex` wird verwendet, um
die Reihenfolge zu bestimmen, in der die Kinder eines einzelnen UI-Objekts
einander überlagert werden.

`Enum.ZIndexBehavior.Global` sortiert alle Nachkommen gemäß dem
`Class.GuiObject.ZIndex|ZIndex` und bricht dann Gleichstände mithilfe der Hierarchieordnung.
Daher müssen Nachkommen eines `Class.GuiObject` einen
`Class.GuiObject.ZIndex|ZIndex`-Wert haben, der mindestens so hoch ist wie der
Elternteil, andernfalls werden sie unter ihrem Elternteil gerendert.


LayerCollector.ZIndexBehavior

Steuert, wie `Class.GuiObject.ZIndex` sich auf alle Nachkommen dieses
`Class.LayerCollector` verhält.


Die Basisklasse von 2D-UI-Containern, die `Class.GuiObject|GuiObjects` in Schichten rendert.

`Class.GuiBase2d` ist eine abstrakte Klasse, die von 2D
`Class.GuiObject|GuiObjects` abgeleitet ist.


Dieses Ereignis wird ausgelöst, wenn die Gamepad-Auswahl zu, von oder innerhalb des verbundenen
`Class.GuiBase2d` oder eines beliebigen Nachfahren
`Class.GuiObject|GuiObjects` wechselt. Wenn das Auswahl-Highlight zu einem
`Class.GuiObject` wechselt, blitzt das Ereignis von diesem `Class.GuiObject` bis zu allen
seinen Vorfahren, um sie zu informieren, dass die Auswahl sich
geändert/hat/ausgetreten ist zu einem `Class.GuiObject` in ihrem Nachfahrenbaum.


GuiBase2d.SelectionChanged

amISelected

Wahr, wenn die neue Auswahl mit dem angehängten GuiBase2d übereinstimmt.


previousSelection

newSelection

Tritt auf, wenn die Gamepad-Auswahl zu, von oder innerhalb des verbundenen
`Class.GuiBase2d` oder eines beliebigen Nachfahren
`Class.GuiObject|GuiObjects` wechselt.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` ist eine schreibgeschützte
Eigenschaft, die die Bildschirmposition eines `Class.GuiBase2d`-Elements
in Pixeln bereitstellt. Dies stellt die tatsächliche Pixelposition dar, an der ein Element
als Ergebnis der Größen und Positionen seiner Vorfahren gerendert wird. Beachten Sie, dass
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` immer die
oben linke Ecke des `Class.GuiBase2d`-Elements darstellt.

Wenn sich das `Class.GuiBase2d` in einem `Class.ScreenGui` befindet, verwendet die
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition`-Eigenschaft das
`Enum.ScreenInsets|CoreUISafeInsets`-Koordinatensystem des Viewports. Der
Ursprung dieses Koordinatensystems befindet sich in der unteren linken Ecke der
Roblox-Top-Leiste. Beachten Sie, dass dies dasselbe Koordinatensystem ist, das von
der `Class.InputObject.Position`-Eigenschaft verwendet wird.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagramm, das den Ursprung des AbsolutePosition-Koordinatensystems zeigt." />

Siehe auch `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` und
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

Beschreibt die tatsächliche Bildschirmposition eines `Class.GuiBase2d`-Elements in
Pixeln.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` ist eine schreibgeschützte
Eigenschaft, die die tatsächliche Bildschirmrotation eines `Class.GuiBase2d`
Elements in Grad beschreibt. Sie führt **keine** Bereichsprüfung durch, sodass ihr Wert
außerhalb des Bereichs `0` bis `360` liegen kann.

Siehe auch `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` und
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

Beschreibt die tatsächliche Bildschirmrotation eines `Class.GuiBase2d`-Elements in
Grad.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` ist eine schreibgeschützte Eigenschaft, die
die tatsächliche Bildschirmgröße eines `Class.GuiBase2d`-Elements in
Pixeln beschreibt.

Siehe auch `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` und
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

Beschreibt die tatsächliche Bildschirmgröße eines `Class.GuiBase2d`-Elements in
Pixeln.


Wenn auf `true` gesetzt, wird die Lokalisierung auf dieses `Class.GuiBase2d`
und seine Nachfahren angewendet. Die für die Lokalisierung verwendeten Einträge sind dieselbe Menge von
Einträgen, die von `Class.LocalizationService:GetTableEntries()` zurückgegeben werden. Einträge,
bei denen `Class.GuiBase2d.AutoLocalize|AutoLocalize` aktiviert ist, werden automatisch
neu übersetzt, nachdem die Cloud-Tabelle geladen wurde, falls erforderlich.

Siehe auch `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

Wenn auf `true` gesetzt, wird die Lokalisierung auf dieses `Class.GuiBase2d`
und seine Nachfahren angewendet.


Diese Eigenschaft wird automatisch auf true gesetzt, wenn das Wurzelobjekt einer Lokalisierungstabelle
`Class.LocalizationTable.Root` dieses Objekt oder einen Vorgänger dieses
Objekts anvisiert. `Class.LocalizationTable|LocalizationTables`, deren
`Class.LocalizationTable.Root`-Eigenschaft auf eine Instanz zeigt, lokalisiert alle
`Class.TextLabel.TextButton`, die Nachfahren der Wurzelinstanz sind.


GuiBase2d.Localize

Automatisch auf true gesetzt, wenn das Wurzelobjekt einer Lokalisierungstabelle
`Class.LocalizationTable.Root` dieses Objekt oder einen Vorgänger dieses
Objekts anvisiert.


Ein Verweis auf eine `Class.LocalizationTable`, die verwendet werden soll, um
automatisierte Lokalisierung auf dieses `Class.GuiBase2d` und seine Nachfahren anzuwenden.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` muss auf `true` gesetzt werden auf der
`Class.GuiBase2d` und seinen Vorfahren, damit automatisierte Lokalisierung angewendet werden kann.

Sie können dies auf eine `Class.LocalizationTable` irgendwo im
`Class.DataModel` festlegen. Das `Class.GuiBase2d`-Objekt und alle seine Kinder
werden versuchen, diese spezifische `Class.LocalizationTable` und deren Vorfahren
für den automatischen Textersatz zu verwenden, bevor sie die Tabellen unter
`Class.LocalizationService` in undefinierter Reihenfolge und die Cloud-Tabelle verwenden.

Wenn in der referenzierten Tabelle keine Übersetzung verfügbar ist, wird nach einer
Übersetzung im übergeordneten Objekt dieser Tabelle gesucht, falls es sich ebenfalls um eine
`Class.LocalizationTable` handelt, und so weiter.

Siehe auch `Class.LocalizationService:GetTableEntries()`, das erklärt, wie die
`Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` für die automatisierte Lokalisierung verwendet wird.


GuiBase2d.RootLocalizationTable

Ein Verweis auf eine `Class.LocalizationTable`, die verwendet werden soll, um
automatisierte Lokalisierung auf dieses `Class.GuiBase2d` und seine Nachfahren anzuwenden.


Passt das Auswahlverhalten des Gamepads in der Abwärtsrichtung an.


GuiBase2d.SelectionBehaviorDown

Passt das Auswahlverhalten des Gamepads in der Linkenrichtung an.


GuiBase2d.SelectionBehaviorLeft

Passt das Auswahlverhalten des Gamepads in der Rechtenrichtung an.


GuiBase2d.SelectionBehaviorRight

Passt das Auswahlverhalten des Gamepads in der Aufwärtsrichtung an.


GuiBase2d.SelectionBehaviorUp

Erlaubt die Anpassung der Art und Weise, wie die Gamepad-Auswahl zwischen
Schaltflächen, die Nachfahren der Auswahlgruppe sind, bewegt werden kann, die Gruppe verlassen,
und andere Schaltflächen auswählen.

Die Einstellung von `Class.GuiBase2d.SelectionGroup|SelectionGroup` auf `true` macht die
`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, und
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`
Eigenschaften zugänglich. Bei diesen Auswahlverhalten bedeutet eine Einstellung von
`Enum.SelectionBehavior.Escape` (Standard), dass die Gamepad-Auswahl zuerst versucht,
eine Auswahl innerhalb der Auswahlgruppe zu finden und nur nach außen wechselt, wenn
ein geeignetes Element nicht gefunden wird. Alternativ bedeutet eine Einstellung von
`Enum.SelectionBehavior.Stop`, dass die Gamepad-Auswahl nur innerhalb der Auswahlgruppe
sucht und nicht außerhalb der Gruppe von der Auswahlverhaltensrichtung bewegt.


GuiBase2d.SelectionGroup

Erlaubt die Anpassung der Bewegung der Gamepad-Auswahl.


Eine abstrakte Klasse, die von 2D `Class.GuiObject|GuiObjects` abgeleitet ist.


GuiBase ist eine abstrakte Klasse, von der die meisten grafischen Benutzeroberflächen-Objekte
abbilden.


GuiBase

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie, die Teil des `Class.DataModel`-Baumes 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, indem er den Namen der Klasse als Parameter entgegennimmt und das erstellte Objekt zurückgibt.

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 das Löschen einer Instanz im Studio zu verfolgen,
wie z.B. das manuelle Löschen im Explorer oder über ein Plugin. Wenn Sie erkennen müssen,
wann eine Instanz mit `Class.Instance:Destroy()` gelöscht wird, verwenden Sie stattdessen das
event `Class.Instance.Destroying`.

Instance.AncestryChanged

child

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

parent

Der neue Elternteil des `child`-Parameters.

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

Dieses Ereignis wird ausgelöst, wenn ein beliebiges Attribut auf 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()`
musikalisch, um zu feuern, wenn sich eines der Attribute des Parts ä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 angegebenes Attribut geändert wird.

Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.

Wird ausgelöst, wenn ein Attribut auf 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 zu dieser `Class.Instance` hinzugefügt wurde.

Hinweis, beim Verwenden dieser Methode auf einem Client, um Objekte zu erkennen, die vom
Server erstellt wurden, ist es notwendig, `Class.Instance:WaitForChild()` zu verwenden, wenn
man auf die Nachkommen dieses Objekts zugreift. 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 zu dieser `Class.Instance` hinzugefügt wurde.

Instance.childAdded

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

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

Entfernt bezieht sich darauf, wenn der Elternteil eines Objekts von dieser
`Class.Instance` auf etwas anderes als diese `Class.Instance` geändert wird. Hinweis, diese
Ereignis wird auch ausgelöst, wenn ein Kind gelöscht wird (unter Verwendung von
`Class.Instance:Destroy()`), da die Löschfunktion 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 aus dieser `Class.Instance` entfernt wurde.

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

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

Da es für jeden Nachkommen ausgelöst wird, wird durch das Hinzufügen eines Objekts zur
`Class.Instance` das Ereignis für dieses Objekt und alle seine Nachkommen individuell ausgelöst.

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`
so geändert wird, dass eine **Nachkomme**-Instanz nicht mehr eine
Nachkomme ist. `Class.Instance:Destroy()|Destroy()` ändert den `Class.Instance.Parent|Parent`
 in `nil`, sodass der Aufruf dieser Methode auf einen Nachkommen des Elternteils dazu
führt, dass dieses Ereignis ausgelöst wird.

Da dieses Ereignis **vor** der Entfernung des Nachkommens ausgelöst wird, wird
zu diesem Zeitpunkt der Elternteil des Nachkommens unverändert bleiben. 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
irgendetwas anderes zu setzen, wird fehlschlagen. Unten finden Sie 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

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 ausgibt,
werden die `Class.Instance` und ihre Nachkommen auf `nil` umgegliedert.

Wenn die Eigenschaft `Class.Workspace.SignalBehavior` 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 Eigenschaft `Class.Workspace.SignalBehavior` auf
`Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis am nächsten Wiederaufnahme-
Punkt ausgelöst, was nach der Zerstörung von `Class.Instance` oder einem 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 zerstört wird, bevor der Callback aufgerufen werden kann (was bedeutet, dass es nicht ausgeführt wird).

Beim Löschen einer `Class.Instance` im Studio, wie z.B. beim manuellen Löschen über den
[Explorer](/studio/explorer) oder über ein Plugin, wird die `Class.Instance`
nicht gelöscht. Stattdessen wird der Elternteil auf `nil` gesetzt,
wobei Sie dies 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.

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

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

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

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

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

Instance.StyledPropertiesChanged

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

Diese Methode wendet ein Tag auf die Instanz an, ohne Wirkung, 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.

- Wenn Sie eine Instanz taggen, ist es üblich, dass einige Ressourcen verwendet werden, um dem Tag seine Funktionalität zu verleihen, zum Beispiel Ereignisverbindungen oder Tabellen. Um Speicherverluste 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 Aufruf von `Class.Instance:RemoveTag()`, beim Aufruf von `Class.Instance:Destroy()` oder in einer Funktion, die mit einem Signal verbunden ist, das von `Class.CollectionService:GetInstanceRemovedSignal()` zurückgegeben wurde.

Instance:AddTag

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 ein paar 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 **alle** Kinder und Nachkommen nicht zerstören möchten, verwenden Sie entweder `Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um durch diese Kinder/Nachkommen zu iterieren und auszuwählen, was zerstört werden soll. Zum Beispiel wird das folgende Codesample alle `Class.BasePart|BaseParts`, die von einem `Class.Model` abgeleitet sind, zerstören:

```
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 und ignoriert alle Instanzen, die **nicht** `Class.Instance.Archivable|Archivable` sind. Die Kopie der Root-Instanz wird durch diese Methode zurückgegeben, und ihr `Class.Instance.Parent|Parent` wird auf `nil` gesetzt. Beachten Sie, dass, wenn die Instanz selbst auf `Class.Instance.Archivable|Archivable` auf `false` gesetzt ist, diese Methode `nil` zurückgibt.

Wenn eine Referenzeigenschaft wie `Class.ObjectValue.Value` in einer kopierten Instanz gesetzt wird, hängt der Wert der Eigenschaftn der Kopie vom 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

Erstellt eine Kopie einer Instanz und aller ihrer Nachkommen und ignoriert Instanzen, 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 loszuwerden, die nicht mehr benötigt werden.

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

Als Best Practice sollte nach dem Aufruf von `Destroy()` für ein Objekt jede Variable, die auf das Objekt (oder seine Nachkommen) verweist, auf `nil` gesetzt werden. Dies verhindert, dass Ihr Code auf etwas zugreift, das mit dem Objekt zu tun hat.

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

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Um ein Objekt nach 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` gleich dem angegebenen Namen ist.

Diese Methode funktioniert aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

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, siehe `Class.Instance:FindFirstAncestorOfClass()` und `Class.Instance:FindFirstAncestorWhichIsA()`.

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` gleich dem angegebenen Namen ist.

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

Diese Methode funktioniert aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

Ein häufiges Anwendungsbeispiel 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 Klassenerbschaft zu berücksichtigen.

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` gleich dem angegebenen className ist.

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 aufwärts, was bedeutet, dass sie bei dem unmittelbaren `Class.Instance.Parent` der Instanz beginnt und in Richtung des `Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahre gefunden wird, wird `nil` zurückgegeben.

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

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

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

Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren 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, durchsucht diese Methode alle Nachkommen und nicht nur die unmittelbaren Kinder der `Class.Instance`.

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

`FindFirstChild()` ist erforderlich, wenn Sie überprüfen müssen, ob ein Objekt existiert, bevor Sie fortfahren. Versuchen Sie, ein Kind mit dem Namen zu indexieren, indem Sie den Punktoperator verwenden, gibt einen Fehler zurück, wenn das Kind nicht existiert.

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

-- Die folgende Zeile gibt einen Fehler zurück, wenn das Teil nicht im Arbeitsbereich existiert
Workspace.Part.Transparency = 0.5
```
Ein besserer Ansatz besteht darin, `FindFirstChild()` zu verwenden, um zunächst 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 die Eigenschaften Vorrang vor den Kindern, wenn sie denselben Namen haben.

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` sich auf den Wert der `Datatype.Color3`-Eigenschaft bezieht, nicht auf die untere `Class.Folder`-Instanz. Ein Vorteil der Verwendung von `Class.Instance:FindFirstChild()|FindFirstChild()` ist, dass die Einführung neuer Eigenschaften Ihr Code nicht gefährdet.

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

#### Leistungsnotizen

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

Instance:FindFirstChild

recursive

Ob die Suche rekursiv durchgeführt werden soll.

Gibt das erste Kind der `Class.Instance` zurück, das den angegebenen Namen hat.

Instance:findFirstChild

Gibt das erste Kind der `Class.Instance` zurück, dessen `Class.Object.ClassName|ClassName` gleich dem angegebenen `className` ist. Im Gegensatz zu `Class.Instance:FindFirstChildWhichIsA()` gibt diese Methode nur Objekte zurück, deren Klasse mit `className` übereinstimmt, wobei die Klassenerbschaft ignoriert wird. Wenn kein übereinstimmendes 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` gleich dem angegebenen Klassennamen ist.

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 übereinstimmendes Kind gefunden wird, gibt diese Methode `nil` zurück. Wenn das optionale rekursive Argument `true` ist, durchsucht 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 Klassenerbschaft berücksichtigt. Zum Beispiel:

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

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Entwickler, die nach einem Kind mit 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 mit dem gegebenen `Class.Instance.Name` zurück.

Diese Methode ist deaktiviert und kann nicht verwendet werden. Um den ersten Nachkommen einer Instanz zu finden, sollten Sie stattdessen die rekursive Option von `Class.Instance:FindFirstChild()` verwenden.

Instance:FindFirstDescendant

Gibt den ersten Nachkommen mit dem gegebenen `Class.Instance.Name` zurück.

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

Instance:GetActor

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

Instance

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

/reference/engine/classes/BillboardGui.yaml