`Class.StarterGui` ist ein Container-Objekt, das dazu dient,
`Class.LayerCollector` Objekte wie `Class.ScreenGui|ScreenGuis` zu speichern.

Wenn ein `Class.Player.Character` spawnt, werden die Inhalte ihres
`Class.PlayerGui` (falls vorhanden) geleert. Kinder von `Class.StarterGui` werden
anschließend zusammen mit ihren Nachkommen in das `Class.PlayerGui` kopiert. Beachten Sie,
dass `Class.LayerCollector` Objekte wie
`Class.ScreenGui|ScreenGuis`, mit ihrer
`Class.LayerCollector.ResetOnSpawn|ResetOnSpawn`-Eigenschaft auf `false` gesetzt, nur
einmal in das `Class.PlayerGui` jedes Spielers eingefügt werden und nicht gelöscht werden,
wenn der `Class.Player` respawnt.

`Class.StarterGui` enthält auch eine Reihe von Funktionen, die es Ihnen ermöglichen,
mit dem `Class.CoreGui` zu interagieren. Beispielsweise kann `Class.StarterGui:SetCoreGuiEnabled()`
verwendet werden, um Elemente des `Class.CoreGui` zu deaktivieren, und
`Class.StarterGui:SetCore()` kann eine Reihe von Funktionen ausführen, darunter
Benachrichtigungen und Systemnachrichten erstellen.

Diese Methode gibt Daten zurück, die von Robloxs Kern-Skripten gesetzt oder
erreichbar gemacht wurden. Der erste und einzige Parameter ist ein String,
das die Informationen auswählt, die abgerufen werden sollen. Die folgenden
Abschnitte beschreiben die Strings und die Daten, die diese Funktion
zurückgibt.

Das Aufrufen dieser Methode kann yielden. Viele von diesen registrieren auch eine
entsprechende `Class.StarterGui:SetCore()|SetCore()`-Funktion (diese sind mit einem
Sternchen gekennzeichnet).

##### PointsNotificationsActive \\*

Gibt `true` zurück, wenn Benachrichtigungen über Spieler-Punkte aktiviert sind.

##### BadgesNotificationsActive \\*

Gibt `true` zurück, wenn Benachrichtigungen für Abzeichen aktiviert sind.

##### AvatarContextMenuEnabled \\*

Gibt `true` zurück, wenn das
[Avatar-Kontextmenü](/players/avatar-context-menu) aktiviert ist.

##### ChatActive \\*

Gibt zurück, ob der Chat aktiv ist oder nicht. Dies wird durch den
Auswahlzustand des Chat-Icons in der oberen Leiste angezeigt.

##### ChatWindowSize \\*

Gibt die Größe des Chatfensters als `Datatype.UDim2` zurück.

##### ChatWindowPosition \\*

Gibt die Größe des Chatfensters als `Datatype.UDim2` zurück.

##### ChatBarDisabled \\*

Gibt `true` zurück, wenn die Chatleiste deaktiviert ist.

##### GetBlockedUserIds

Gibt eine Liste von `Class.Player.UserId|UserIds` zurück, die mit Benutzern verknüpft sind,
die vom lokalen Spieler blockiert wurden.

##### PlayerBlockedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler vom
lokalen Spieler blockiert wird.

##### PlayerUnblockedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler
vom lokalen Spieler entsperrt wird.

##### PlayerMutedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler vom
lokalen Spieler stummgeschaltet wird.

##### PlayerUnmutedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler
vom lokalen Spieler wieder laut geschaltet wird.

##### PlayerFriendedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler vom
lokalen Spieler hinzugefügt wird.

##### PlayerUnfriendedEvent

Gibt ein `Class.BindableEvent` zurück, das ausgelöst wird, wann immer ein Spieler vom
lokalen Spieler entfernt wird.

##### DevConsoleVisible \\*

Gibt `true` zurück, wenn die
[Entwickler-Konsole](/studio/developer-console) sichtbar ist.

##### VRRotationIntensity

Gibt einen String zurück, der die Kamera-Rotationssensitivität in VR beschreibt: `Low`,
`High` und `Smooth`. Dies wird nicht verfügbar sein, es sei denn,
`Class.VRService.VREnabled` ist `true`.

StarterGui:GetCore

parameterName

Gibt eine Variable zurück, die von einem Roblox-Kernscript angegeben wurde.

Das folgende Beispiel gibt aus, ob die Spielerliste für den
LocalPlayer sichtbar ist.

Diese Funktion gibt zurück, ob der angegebene `Enum.CoreGuiType` aktiviert ist oder
ob er mit `Class.StarterGui:SetCoreGuiEnabled()` deaktiviert wurde. Diese
Funktion sollte auf dem Client aufgerufen werden.

Beachten Sie, dass das Setzen von `"TopbarEnabled"` auf `false` mithilfe von
`Class.StarterGui:SetCore()|SetCore()` alle
`Enum.CoreGuiType|CoreGuiTypes` ausblendet, aber das Ergebnis dieser
Funktion nicht beeinflusst.

StarterGui:GetCoreGuiEnabled

coreGuiType

Ob der angegebene `Enum.CoreGuiType` aktiviert ist.

Gibt zurück, ob der angegebene `Enum.CoreGuiType` aktiviert ist oder ob er
mit `Class.StarterGui:SetCoreGuiEnabled()` deaktiviert wurde.

Diese Methode (nicht zu verwechseln mit
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled()`) bietet eine
Vielfalt an Funktionalitäten, die von den Kern-Skripten von Roblox definiert sind, wie z. B. das Versenden von
Benachrichtigungen, das Aktivieren von Benachrichtigungen für Abzeichen/Punkte, die Definition eines
Callbacks für die Zurücksetzen-Schaltfläche oder das Aktivieren der oberen Leiste.

Der erste Parameter ist ein String, der die Funktionalität auswählt, mit der der
Aufruf interagieren wird. Es kann nötig sein, diese Methode mehrmals aufzurufen,
unter Verwendung von `Global.LuaGlobals.pcall()`, falls das jeweilige Kern-Skript
noch nicht geladen wurde (oder wenn es vollständig deaktiviert wurde).

Die folgende Tabelle beschreibt die Strings, die als der erste Parameter akzeptiert werden können.
Die folgenden Parameter hängen von der Funktionalität ab, die verwendet wird, und werden in Unter-Tabellen beschrieben.

##### ChatActive

Steuert, ob der Chat aktiv ist.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob der Chat aktiv sein sollte.</td>
  </tr>
  </tbody>
</table>

##### PointsNotificationsActive

Steuert, ob Benachrichtigungen für verdiente Spielerpunkte angezeigt werden.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob Benachrichtigungen für verdiente Spielerpunkte angezeigt werden.</td>
  </tr>
  </tbody>
</table>

##### BadgesNotificationsActive

Steuert, ob Benachrichtigungen für verdiente Abzeichen angezeigt werden.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob Benachrichtigungen für verdiente Abzeichen angezeigt werden.
</td>
  </tr>
  </tbody>
</table>

##### ResetButtonCallback

Bestimmt das Verhalten, falls vorhanden, der Zurücksetzen-Schaltfläche, gegeben
als boolean oder ein `Class.BindableEvent`, das ausgelöst wird, wenn ein Spieler
verlangt, zurückzusetzen.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
		</thead>
    <tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob die Zurücksetzen-Schaltfläche ihr Standardverhalten beibehalten sollte.</td>
  </tr>
	<tr>
    <td colspan="4"><b>ODER</b></td>
  </tr>
	<tr>
    <td><code>callback</code></td>
    <td><code>Class.BindableEvent</code></td>
    <td>(erforderlich)</td>
    <td>Ein <code>Class.BindableEvent</code>, das ausgelöst wird, wenn der Spieler bestätigt, dass er zurücksetzen möchte.</td>
  </tr>
  </tbody>
</table>

##### ChatMakeSystemMessage

Zeigt eine formatierte Nachricht im Chat an. Die Verwendung dieser Methode erfordert, dass die
`Class.TextChatService.ChatVersion` des Erlebnisses auf
`Enum.ChatVersion|LegacyChatService` gesetzt ist, obwohl der alte Chat **abgelehnt** wird und die Verwendung
nicht empfohlen wird. Für Erlebnisse, die die aktuelle `Class.TextChatService` verwenden, siehe
`Class.TextChannel:DisplaySystemMessage()`.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(erforderlich)</td>
    <td>Ein Dictionary mit Informationen, die die Nachricht beschreiben (siehe unten).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(erforderlich)</td>
    <td>Die anzuzeigende Nachricht.</td>
  </tr>
	<tr>
    <td><code>Color</code></td>
    <td><code>Datatype.Color3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Textfarbe der Nachricht.</td>
  </tr>
	<tr>
    <td><code>Font</code></td>
    <td><code>Enum.Font</code></td>
    <td><code>SourceSansBold</code></td>
    <td>Schriftart der Nachricht.</td>
  </tr>
	<tr>
    <td><code>TextSize</code></td>
    <td>integer</td>
    <td><code>18</code></td>
    <td>Schriftgröße der Nachricht.</td>
  </tr>
  </tbody>
</table>

##### SendNotification

Lässt eine nicht-invasive Benachrichtigung unten rechts auf dem
Bildschirm erscheinen. Die Benachrichtigung kann bis zu zwei Schaltflächen haben.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(erforderlich)</td>
    <td>Ein Dictionary mit Informationen, die die Benachrichtigung beschreiben (siehe unten).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Title</code></td>
    <td>string</td>
    <td>(erforderlich)</td>
    <td>Der Titel der Benachrichtigung.</td>
  </tr>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(erforderlich)</td>
    <td>Der Haupttext der Benachrichtigung.</td>
  </tr>
	<tr>
    <td><code>Icon</code></td>
    <td>string</td>
    <td></td>
    <td>Das Bild, das mit der Benachrichtigung angezeigt wird.</td>
  </tr>
	<tr>
    <td><code>Duration</code></td>
    <td>number</td>
    <td><code>5</code></td>
    <td>Dauer (in Sekunden), wie lange die Benachrichtigung sichtbar sein sollte.</td>
  </tr>
	<tr>
    <td><code>Callback</code></td>
    <td><code>Class.BindableFunction</code></td>
    <td></td>
    <td>Eine <code>Class.BindableFunction</code>, die mit dem Text der von dem Spieler gedrückten Schaltfläche
ausgelöst werden sollte.</td>
  </tr>
	<tr>
    <td><code>Button1</code></td>
    <td>string</td>
    <td></td>
    <td>Der Text, der auf der ersten Schaltfläche angezeigt wird.</td>
  </tr>
	<tr>
    <td><code>Button2</code></td>
    <td>string</td>
    <td></td>
    <td>Der Text, der auf der zweiten Schaltfläche angezeigt wird.</td>
  </tr>
  </tbody>
</table>

##### TopbarEnabled

Bestimmt, ob die obere Leiste angezeigt wird. Das Deaktivieren der oberen Leiste wird auch
die gesamten `Class.CoreGui|CoreGuis` wie den Chat, das Inventar und die
Spielerliste deaktivieren (zum Beispiel die, die mit
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled` festgelegt wurden).

Wenn die obere Leiste deaktiviert ist, erfasst die Region, die sie einst eingenommen hat,
immer noch Mausereignisse; jedoch werden dort platzierte Schaltflächen nicht auf Klikks reagieren.
Der Ursprung des GUI-Raums wird weiterhin 36 Pixel von der oberen Bildschirmkante versetzt sein.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob die obere Leiste sichtbar sein sollte.</td>
  </tr>
</tbody>
</table>

##### DevConsoleVisible

Bestimmt, ob die
[Entwicklerkonsole](/studio/developer-console) sichtbar ist.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>visibility</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob die Konsole sichtbar ist.</td>
  </tr>
</tbody>
</table>

##### PromptSendFriendRequest

Fordert den aktuellen Spieler auf, einen Freundschaftsantrag an den gegebenen
`Class.Player` zu senden.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(erforderlich)</td>
    <td>Der Spieler, dem der Freundschaftsantrag gesendet werden soll.</td>
  </tr>
</tbody>
</table>

##### PromptUnfriend

Fordert den aktuellen Spieler auf, einen gegebenen `Class.Player` aus seiner
Freundesliste zu entfernen.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(erforderlich)</td>
    <td>Der Spieler, der entfernt werden soll.</td>
  </tr>
</tbody>
</table>

##### PromptBlockPlayer

Fordert den aktuellen Spieler auf, den gegebenen `Class.Player` zu blockieren.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(erforderlich)</td>
    <td>Der Spieler, der blockiert werden soll.</td>
  </tr>
  </tbody>
</table>

##### PromptUnblockPlayer

Fordert den aktuellen Spieler auf, den gegebenen `Class.Player` zu entsperren.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
 </thead>
 <tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(erforderlich)</td>
    <td>Der Spieler, der entsperrt werden soll.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuEnabled

Bestimmt, ob das
[Avatar-Kontextmenü](/players/avatar-context-menu) aktiviert ist.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(erforderlich)</td>
    <td>Bestimmt, ob das Kontextmenü aktiviert ist.</td>
  </tr>
</tbody>
</table>

##### AvatarContextMenuTarget

Öffnet gewaltsam das
[Avatar-Kontextmenü](/players/avatar-context-menu).

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(erforderlich)</td>
    <td>Der Spieler, auf dem das Kontextmenü geöffnet wird.</td>
  </tr>
</tbody>
</table>

##### AddAvatarContextMenuOption

Fügt eine Option zum
[Avatar-Kontextmenü](/players/avatar-context-menu) hinzu.

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td><code>Enum.AvatarContextMenuOption</code></td>
    <td>(erforderlich)</td>
    <td>Option, die hinzugefügt werden soll.</td>
  </tr>
	<tr>
    <td colspan="4"><b>ODER</b></td>
  </tr>
	<tr>
    <td><code>option</code></td>
    <td>table</td>
    <td>(erforderlich)</td>
    <td>Eine Tabelle mit zwei Elementen, wobei das erste der Name der benutzerdefinierten Aktion ist und das zweite ein <code>Class.BindableEvent</code>, das ausgelöst wird, wenn der Spieler ausgewählt wurde, als die Option aktiviert wurde.</td>
  </tr>
</tbody>
</table>

##### RemoveAvatarContextMenuOption

Entfernt eine Option aus dem
[Avatar-Kontextmenü](/players/avatar-context-menu). Das
`option`-Argument muss dasselbe sein wie das, was mit
`"AddAvatarContextMenuOption"` verwendet wurde (siehe oben).

<table size="small">
	<thead>
		<tr>
			<th>Name</th>
			<th>Typ</th>
			<th>Standard</th>
			<th>Beschreibung</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td>Variant</td>
    <td>(erforderlich)</td>
    <td>Der gleiche Wert wie bei <b>AddAvatarContextMenuOption</b> angegeben.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuTheme

Konfiguriert das anpassbare
[Avatar-Kontextmenü](/players/avatar-context-menu), das eine wahlweise Funktion ist, die eine einfache Spieler-zu-Spieler-Interaktion über
benutzerdefinierte Aktionen ermöglicht, wie z. B. Handelsinitiierungen, Kämpfe und mehr. Für mehr
Informationen zur Anpassung des Themas siehe den Artikel über das
[Avatar-Kontextmenü](/players/avatar-context-menu).

##### CoreGuiChatConnections

Stellt eine bindbare Verbindungsbrücke zwischen dem Chat-Button der `Class.CoreGui`-oberen Leiste und dem alten Chatsystem her. Der zweite Parameter
muss eine Tabelle von `Class.BindableEvent|BindableEvents` und
`Class.BindableFunction|BindableFunctions` sein.


StarterGui:SetCore

Wählt die Funktionalität aus, mit der der Aufruf interagiert.

value

Eine Tabelle von `Class.BindableEvent|BindableEvents` und
`Class.BindableFunction|BindableFunctions`.

Ermöglicht Ihnen, bestimmte Interaktionen mit Robloxs Kern-Skripten auszuführen.

Diese Funktion legt fest, ob das `Class.CoreGui`-Element, das mit dem
g angegebenen `Enum.CoreGuiType` verknüpft ist, aktiviert oder deaktiviert ist.

Die obere Leiste kann mit dieser Funktion nicht deaktiviert werden. Um dies zu tun, setzen Sie
`"TopbarEnabled"` auf `false` mithilfe von `Class.StarterGui:SetCore()`.

StarterGui:SetCoreGuiEnabled

enabled

Ob der angegebene `Enum.CoreGuiType` aktiviert oder deaktiviert werden soll.

Legt fest, ob das `Class.CoreGui`-Element, das mit dem angegebenen
`Enum.CoreGuiType` verknüpft ist, aktiviert oder deaktiviert ist.

StarterGui

Ermöglicht `Class.StarterGui`, Eingaben zu verarbeiten, wie es `Class.PlayerGui` und
`Class.CoreGui` tun. Der Standardwert ist `false`.

StarterGui.ProcessUserInput

Ermöglicht diesem Dienst, Eingaben zu verarbeiten, wie es `Class.PlayerGui` und
`Class.CoreGui` tun.

Wenn auf true gesetzt, wird jedes Kind, das dem `Class.StarterGui` zugeordnet ist,
in das `Class.PlayerGui` eines Spielers kopiert, wenn das Charakter des Spielers
neu gespawnt wird.

Wenn eines der Kinder ein PlayerGui ist und seine PlayerGui-Eigenschaft
auf false gesetzt ist, wird es nicht kopiert.

StarterGui.ResetPlayerGuiOnSpawn

Bestimmt, ob jedes Kind, das dem StarterGui zugeordnet ist, in das PlayerGui eines Spielers
kopiert wird, wenn das Charakter des Spielers neu gespawnt wird.

StarterGui.RtlTextSupport

Diese Eigenschaft legt den bevorzugten Bildschirmorientierungsmodus für Benutzer mit
mobiler Geräte fest. Für die verschiedenen verfügbaren Modi siehe
`Enum.ScreenOrientation`.

Standardmäßig ist diese Eigenschaft auf
`Enum.ScreenOrientation.Sensor|Sensor` gesetzt, was bedeutet, dass die Erfahrung
je nach bester Übereinstimmung mit der aktuellen Ausrichtung des Geräts
either im Querformat (links/rechts) oder im Hochformat angezeigt wird.

Wenn ein `Class.Player` der Erfahrung auf einem mobilen Gerät beitritt, bestimmt
diese Eigenschaft die Startausrichtung des Geräts und setzt das
`Class.PlayerGui.ScreenOrientation` dieses Spielers entsprechend. Sie können auch die
e aktuelle Bildschirmorientierung des Spielers über
`Class.PlayerGui.CurrentScreenOrientation` abrufen, was nützlich ist, wenn Sie eine der
"Sensor" `Enum.ScreenOrientation`-Einstellungen verwenden.

Beachten Sie, dass das Ändern dieser Eigenschaft die Bildschirmorientierung
für `Class.Player|Players`, die bereits in der Erfahrung sind, nicht ändert. Um die
Orientierung für einen bestehenden Spieler zu ändern, verwenden Sie die
`Class.PlayerGui.ScreenOrientation`-Eigenschaft.

StarterGui.ScreenOrientation

Legt den Standard-Bildschirmorientierungsmodus für Benutzer mit mobilen Geräten fest.

Diese Eigenschaft bestimmt, ob die Inhalte von `Class.StarterGui` im Studio sichtbar sind.

StarterGui.ShowDevelopmentGui

Bestimmt, ob die Inhalte von `Class.StarterGui` im Studio sichtbar sind.

StarterGui.VirtualCursorMode

Ein Container für `Class.LayerCollector` Objekte, die in das
`Class.PlayerGui` von `Class.Player|Players` kopiert werden. Bietet auch eine Reihe von
Funktionen zur Interaktion mit dem `Class.CoreGui`.

`BasePlayerGui` ist eine abstrakte Klasse, von der alle GUI-Zeichenspeicherklassen
ableiten.

Alle GUIs, die von `Class.BasePlayerGui:GetGuiObjectsAtPosition()` zurückgegeben werden,
werden von der lokalen Funktion `highlightAsFrame()` 'kopiert', die ein `Frame`
GUI erzeugt, das über dem angegebenen GUI positioniert ist, halbtransparent ist und die
selbe `Class.GuiBase2d.AbsoluteSize` und `Class.GuiBase2d.AbsolutePosition` hat.

Diese Hervorhebungen werden in die HighlightsContainer `ScreenGui` im
Highlight-Ordner des PlayerGui-Ordners des Spielers hinzugefügt. Beide werden durch den
Codeschnipsel erstellt. Alle hervorgehobenen GUIs werden mit `Class.Instance:Destroy()`
jedes Mal gelöscht, wenn `highlightGui()` ausgeführt wird.

Beachten Sie, dass die `Class.ScreenGui.DisplayOrder` von HighlightContainer 99999 beträgt,
eine große Zahl, sodass es unwahrscheinlich ist, dass andere GUIs über den
hervorgehobenen GUIs dargestellt werden.

Nimmt eine Bildschirmposition und gibt eine Liste aller `Class.GuiObject`
Instanzen zurück, die diese Bildschirmposition belegen, sortiert in der Reihenfolge,
wie sie von oben nach unten auf dem Bildschirm erscheinen, als ersten und letzten Index,
jeweils. Der Hauptverwendungszweck besteht darin, GUI-Objekte unter der Maus
oder den Touch-Eingaben des Spielers zu erhalten, um eine Auswahl oder Hervorhebung
ermöglichen.

Da die Kindklassen von `Class.BasePlayerGui` diese Funktion erben, kann sie
von Containerklassen wie `Class.PlayerGui` und `Class.StarterGui`
ausgeführt werden.

BasePlayerGui:GetGuiObjectsAtPosition

Die **X**-Position auf dem Bildschirm relativ zur oberen linken Ecke, nachdem
das GUI-Inset angewendet wurde (siehe `Class.GuiService:GetGuiInset()`).

Die **Y**-Position auf dem Bildschirm relativ zur oberen linken Ecke, nachdem
das GUI-Inset angewendet wurde (siehe `Class.GuiService:GetGuiInset()`).

Eine Tabelle der `Class.GuiObject` Instanzen, die den angegebenen
Bildschirmplatz einnehmen.

Gibt eine Liste aller `Class.GuiObject`-Instanzen zurück, die die gegebene


BasePlayerGui

`BasePlayerGui` ist eine abstrakte Klasse, von der die GUI-Zeichenspeicherklassen
ableiten.

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

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

Zum Beispiel setzt der folgende Codeausschnitt den Wert des Attributs `InitialPosition` der Instanz:

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

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

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

#### Siehe auch

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

Instance:GetAttribute

Der Name des Attributs, das abgerufen wird.

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

Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu `Class.Object.Changed|Changed` mit einer Funktion, die den Eigenschaftsnamen überprüft, zu verwenden. Subsequent calls to this method on the same object with the same attribute name return the same event.

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

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

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

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

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Siehe auch `Class.Instance.AttributeChanged`, das ausgelöst wird, wenn sich irgendein Attribut der Instanz ändert.

Instance:GetAttributeChangedSignal

Der Name des angegebenen Attributs, für das das Änderungs-Signal zurückgegeben wird.

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

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

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

Zum Beispiel gibt der folgende Codeausschnitt die Attribute und Werte einer Instanz aus:

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

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

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Siehe auch `Class.Instance:GetAttribute()`, das den Wert zurückgibt, der dem angegebenen Attributnamen zugewiesen wurde.

Instance:GetAttributes

Ein Wörterbuch von String-zu-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 jeden `Class.Instance`, dessen `Class.Instance.Parent|Parent` gleich dem Objekt ist. Das Array kann entweder mit einer numerischen oder generischen `for`-Schleife durchlaufen werden:

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

-- Beispiel einer numerischen 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 einer generischen Schleife
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " ist Kind Nummer " .. i)
end
```
Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge sortiert ist, daher wird empfohlen, es manuell zu sortieren (zum Beispiel mit `Library.table.sort()`), um die von dieser Methode zurückgegebenen Kinder zu sortieren.

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

Instance:GetChildren

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

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

Instance:getChildren

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

- Diese Methode ist geschützt. Ein Versuch, sie 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 (zum Beispiel Objekte, die denselben Namen teilen).

Instance:GetDebugId

scopeLength

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

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

Diese Objektemethode 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 usw.

Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge sortiert ist, daher wird empfohlen, es manuell zu sortieren (zum Beispiel mit `Library.table.sort()`), um die von dieser Methode zurückgegebenen Nachkommen 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 `Class.Instance:GetFullName()`-Funktion in
Lua neu.

Gibt eine Zeichenfolge zurück, die die Abstammung der Instanz beschreibt. Die Zeichenfolge ist eine Verkettung des `Class.Instance.Name|Name` des Objekts und seiner Vorfahren, die durch Punkte getrennt sind. 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 zum obersten ohne `Class.Instance.Parent|Parent`.

Diese Methode ist nützlich zum Protokollieren und Debuggen. Sie sollten versuchen, die zurückgegebene Zeichenfolge nicht für eine nützliche Operation zu parsen; diese Methode escaped keine Punkte (oder andere Symbole) in Objektnamen. Mit anderen Worten, obwohl die Ausgabe oft wie ein gültiger Luau-Bezeichner erscheint, ist dies nicht garantiert.

Instance:GetFullName

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

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

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 geringfügig von den direkten Zugriff auf den Eigenschaftswert, wie zum Beispiel `[GuiObject].Rotation`, das den Standard- oder modifizierten Wert der Eigenschaft zurückgibt.

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

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

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

-- Referenz auf einen Button
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

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

-- Drehung über die Stilregel-Eigenschaft anwenden
rule:SetProperty("Rotation", 30)

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

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

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

Instance:GetStyled

selector

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

Der stilisierte oder ausdrücklich modifizierte Wert der angegebenen Eigenschaft, oder 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.

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 Stileigenschaft ändert. Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` mit einer Funktion, die den Eigenschaftsnamen überprüft, zu verwenden. Subsequent calls to this method on the same object with the same property name return the same event.

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

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

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

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

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

Instance:GetStyledPropertyChangedSignal

property

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

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

Diese Methode gibt ein Array der Tags zurück, die der angegebenen Instanz zugewiesen sind, als Strings. Sie können Tags entweder im Studio im Fenster [Eigenschaften](/studio/properties) 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 zur Überprüfung der Existenz eines einzelnen Tags zu verwenden; verwenden Sie stattdessen `Class.Instance:HasTag()|HasTag()`, um nach einem bestimmten Tag zu suchen.

Instance:GetTags

Gibt ein Array aller Tags zurück, die der Instanz zugewiesen sind.

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

Instance:HasTag

Ü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 ein `Class.Instance` ein Vorfahre des angegebenen Nachkommen ist.

Ein `Class.Instance` gilt als Vorfahre eines Objekts, wenn das `Class.Instance.Parent` des Objekts oder eines seiner `Class.Instance.Parent` auf das `Class.Instance` gesetzt ist.

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

Instance:IsAncestorOf

Wahr, wenn das `Class.Instance` ein Vorfahre des angegebenen Nachkommen ist.

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

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

Beachten Sie, dass `IsDescendantOf()` nicht für einen 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 ein `Class.Instance` ein Nachkomme des angegebenen Vorfahren ist.

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/StarterGui.yaml