Die `Class.UIDragDetector`-Instanz erleichtert und fördert die Interaktion
mit 2D Benutzeroberflächenelementen in einer Erfahrung, wie Schiebereglern und
Drehreglern. Wichtige Funktionen sind:

- Stellen Sie eine `Class.UIDragDetector` unter jede `Class.GuiObject`-Instanz, um
  sie über alle Eingaben ohne eine einzige Codezeile beweglich zu machen.

- Wählen Sie aus mehreren `Class.UIDragDetector.DragStyle|DragStyle`-Optionen,
  legen Sie fest, wie das Objekt auf Bewegungen über
  `Class.UIDragDetector.ResponseStyle|ResponseStyle` reagiert, und wenden Sie optional
  Achsen, Bewegungseinschränkungen oder Ziehgrenzen an.

- Skripte können auf die Manipulation der gezogenen Objekte reagieren, um logische
  Reaktionen zu steuern, wie das Anpassen von Einstellungen.

- `Class.UIDragDetector|UIDragDetectors` funktionieren in Studio, solange Sie
  **nicht** die Werkzeuge **Auswählen**, **Bewegen**, **Skalieren** oder **Drehen** verwenden,
  noch bestimmte Plugins oder Studios **UI**-Bearbeitungswerkzeuge.


Wird ausgelöst, wenn ein Benutzer das UI-Element weiterhin zieht, nachdem
`Class.UIDragDetector.DragStart|DragStart` initiiert wurde.


UIDragDetector.DragContinue

inputPosition

`Datatype.Vector2`, das die aktuelle Eingabeposition darstellt.


Wird ausgelöst, wenn ein Benutzer das UI-Element aufhört zu ziehen.


UIDragDetector.DragEnd

Wird ausgelöst, wenn ein Benutzer mit dem Ziehen des UI-Elements beginnt.


UIDragDetector.DragStart

Fügt eine Funktion hinzu, um vorgeschlagene Bewegung zu modifizieren oder einzuschränken. Die Funktion nimmt
 einen Eingabewert `Datatype.UDim2` (Position) und float (Rotation) von **vorgeschlagener**
 Bewegung entgegen und gibt einen `Datatype.UDim2` und float von **modifizierter** oder
 unveränderter Bewegung zurück. Sie können mehrere Funktionen hinzufügen, die in
 Reihenfolge nach `priority` aufgerufen werden, wobei die Ergebnisse in einer Kette
 übergeben werden.

Der Eingang wird im Raum ausgedrückt, der durch die
`Class.UIDragDetector.DragSpace|DragSpace`-Eigenschaft definiert ist, entweder als Delta oder
 die endgültige gewünschte Position/Richtung, basierend auf der
`Class.UIDragDetector.DragRelativity|DragRelativity`-Eigenschaft. Der Ausgang
sollte im gleichen Raum und der gleichen Relativität ausgedrückt werden,
es sei denn, er wird überschrieben, indem als dritte und vierte Rückgabewerte ein bestimmter
`Enum.UIDragDetectorDragRelativity` und `Enum.UIDragDetectorDragSpace` zurückgegeben werden.

Um eine hinzugefügte Einschränkungsfunktion zu entfernen, rufen Sie die
`Datatype.RBXScriptConnection:Disconnect()|Disconnect()` auf dem zurückgegebenen
Verbindungsobjekt auf.


UIDragDetector:AddConstraintFunction

priority

Die Reihenfolge der Priorität für Funktionen, die über diese Methode hinzugefügt wurden. Höhere
Werte haben Vorrang vor niedrigeren Werten.


function

Funktion zur Modifikation oder Einschränkung der vorgeschlagenen Bewegung. Diese Funktion
nimmt einen Eingabewert `Datatype.UDim2` und float von **vorgeschlagener** Bewegung entgegen und
gibt einen `Datatype.UDim2` und float von **modifizierter** oder unveränderter
Bewegung zurück. Sie kann optional einen
`Enum.UIDragDetectorDragRelativity` und `Enum.UIDragDetectorDragSpace` zurückgeben
 als dritte und vierte Rückgabewerte als Ausgabeüberschreibungen.


Verwenden Sie dieses Verbindungsobjekt, um die Einschränkungsfunktion zu entfernen.


Fügt eine Funktion hinzu, um vorgeschlagene Bewegung zu modifizieren oder einzuschränken.


Wenn keine `Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` festgelegt ist,
 gibt diese Funktion die `Datatype.UDim2`-Position des unmittelbaren Elternteils des gezogenen
Objekts `Class.GuiObject` zurück (sofern vorhanden), andernfalls die
`Datatype.UDim2`-Position des gezogenen Objekts.

Wenn eine `Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` festgelegt ist,
 gibt diese Funktion die `Datatype.UDim2`-Position dieser Referenzinstanz zurück.


UIDragDetector:GetReferencePosition

`Datatype.UDim2`-Position des aktuellen Ziehens Referenzelement.


Gibt die Referenz `Datatype.UDim2`-Position des aktuellen Ziehens
Referenzursprungs zurück.


Wenn keine `Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` festgelegt ist,
 gibt diese Funktion die Rotation des unmittelbaren Elternteils des gezogenen Objekts `Class.GuiObject`
 (sofern vorhanden) zurück, andernfalls die Rotation des gezogenen Objekts.

Wenn eine `Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` festgelegt ist,
 gibt diese Funktion die Rotation dieser Referenzinstanz zurück.


UIDragDetector:GetReferenceRotation

Rotation des aktuellen Ziehens Referenzelements.


Gibt die Referenzrotation des aktuellen Ziehens Referenzelements zurück.


Übergibt eine Funktion, die verwendet wird, wenn und nur wenn
`Class.UIDragDetector.DragStyle|DragStyle` auf
`Enum.UIDragDetectorDragStyle.Scriptable` eingestellt ist. Die gegebene Funktion erhält die
Eingabeposition im Bildschirmraum des Signals mit dem Typ `Datatype.Vector2` und
gibt eine `Datatype.UDim2` (Position) und float (Rotation) zurück, die die
gewünschte Bewegung des Ziehens enthält. Der Raum der Rückgabewerte und die
Relativität der Bewegung werden durch die
`Class.UIDragDetector.DragSpace|DragSpace` und
`Class.UIDragDetector.DragRelativity|DragRelativity`-Eigenschaften bestimmt,
sofern sie nicht überschrieben werden, indem man einen bestimmten
`Enum.UIDragDetectorDragRelativity` und
`Enum.UIDragDetectorDragSpace` als dritte und vierte Rückgabewerte zurückgibt.

Wenn die Funktion `nil` zurückgibt, wird das Objekt nicht bewegt. Dies ist
nützlich, wenn das Skript noch nicht alle Informationen gesammelt hat, die es benötigt,
 um die richtige Antwort zu geben, oder in vorübergehenden Fällen, in denen Sie wollen,
dass das Objekt an seinem Platz bleibt.


UIDragDetector:SetDragStyleFunction

Funktion zur Überwachung von
`Class.UIDragDetector.DragContinue|DragContinue`-Signalen. Diese
Funktion erhält die Eingabeposition des Signals im Bildschirmraum und gibt
 eine `Datatype.UDim2` und float zurück, die die gewünschte Bewegung des Ziehens enthalten
 im gewünschten Raum und Relativität. Wenn diese Funktion `nil` zurückgibt,
 wird das Objekt nicht bewegt.


Übergibt eine Funktion, die verwendet wird, wenn und nur wenn
`Class.UIDragDetector.DragStyle|DragStyle` auf
`Enum.UIDragDetectorDragStyle.Scriptable` eingestellt ist.


UIDragDetector

Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` aktiviert ist. Wenn diese Eigenschaft leer
ist, verwendet der Detektor das Standardsymbol.

Um das aktivierte Cursor-Symbol zu ändern, setzen Sie diese Eigenschaft auf die
Asset-ID des Bildes, das Sie verwenden möchten.


UIDragDetector.ActivatedCursorIcon

Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` aktiviert ist.


Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` aktiviert ist. Wenn diese Eigenschaft leer
ist, verwendet der Detektor das Standardsymbol.

Um das aktivierte Cursor-Symbol zu ändern, setzen Sie diese Eigenschaft auf die Asset-ID
des Bildes, das Sie verwenden möchten. Nur Asset-URIs werden für diese
Eigenschaft unterstützt.


UIDragDetector.ActivatedCursorIconContent

Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` aktiviert ist. Unterstützt nur Asset-URIs.


Bestimmt das Begrenzungsverhalten des gezogenen UI-Objekts, wenn der Detektor's
`Class.UIDragDetector.BoundingUI|BoundingUI` eingestellt ist. Siehe
`Enum.UIDragDetectorBoundingBehavior` für Details zu den Verhaltensweisen jedes
Einstellungen.


UIDragDetector.BoundingBehavior

Bestimmt das Begrenzungsverhalten des gezogenen UI-Objekts, wenn der Detektor's
`Class.UIDragDetector.BoundingUI|BoundingUI` eingestellt ist.


Wenn gesetzt, erlaubt die `Class.UIDragDetector`-Instanz nicht, dass die Grenzen der
Eltern-`Class.GuiObject` außerhalb der Grenzen der
**BoundingUI**-Instanz gezogen werden.

Beachten Sie, dass, wenn ein Teil der Eltern-`Class.GuiObject` außerhalb der
**BoundingUI**-Grenzen liegt, die anfängliche Eingabeposition zu Beginn des Ziehens und deren
relative Position während des Ziehens für die Begrenzungserkennung verwendet wird, bis
das gesamte gezogene Objekt innerhalb der Grenzen liegt, nach dem das
Objekt innerhalb der Grenzen eingeschränkt wird.


UIDragDetector.BoundingUI

Instanz, deren Begrenzungsbereich die Ziehgrenzen für die Eltern-
`Class.GuiObject` definiert.


Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` schwebt. Wenn diese Eigenschaft leer
ist, verwendet der Detektor das Standardsymbol.

Um das Cursor-Symbol zu ändern, setzen Sie diese Eigenschaft auf die Asset-ID des Bildes,
das Sie verwenden möchten.


UIDragDetector.CursorIcon

Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` schwebt.


Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` schwebt. Wenn diese Eigenschaft leer
ist, verwendet der Detektor das Standardsymbol.

Um das Cursor-Symbol zu ändern, setzen Sie diese Eigenschaft auf die Asset-ID des Bildes,
das Sie verwenden möchten. Nur Asset-URIs werden für diese Eigenschaft unterstützt.


UIDragDetector.CursorIconContent

Legt das Cursor-Symbol fest, das angezeigt werden soll, wenn die Maus über der
Elterneinstanz dieses `Class.UIDragDetector` schwebt. Unterstützt nur Asset-URIs.


`Datatype.Vector2`-Wert, der die Bewegungsachse für das gezogene
Objekt definiert, wenn `Class.UIDragDetector.DragStyle|DragStyle` auf
`Enum.UIDragDetectorDragStyle.TranslateLine` eingestellt ist. Die Achse wird im
lokalen Raum der `Class.UIDragDetector` definiert, es sei denn,
`Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` wird definiert,
 in diesem Fall wird die Achse im lokalen Raum dieser Instanz definiert.


UIDragDetector.DragAxis

Die Ziehachse für die `Class.UIDragDetector`-Instanz, wenn
`Class.UIDragDetector.DragStyle|DragStyle` auf
`Enum.UIDragDetectorDragStyle.TranslateLine` eingestellt ist.


Gilt nur, wenn eine benutzerdefinierte Ziehfunktion über
`Class.UIDragDetector:SetDragStyleFunction()|SetDragStyleFunction()` oder
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` registriert ist.
Legt das Paradigma fest, das die Relativität der Eingaben/Ausgaben der registrierten
Funktion definiert.

Zum Beispiel wird das Zurückgeben von `Datatype.UDim2.fromOffset(1, 0)` von einer
registrierten Funktion mit diesem Wert auf
`Enum.UIDragDetectorDragRelativity.Absolute` gesetzt, die Elterninstanz des Detektors
**zu** `(1, 0)` im angegebenen
`Class.UIDragDetector.DragSpace|DragSpace` bewegen, während das Zurückgeben der
selben `Datatype.UDim2` mit diesem Wert auf
`Enum.UIDragDetectorDragRelativity.Relative` gesetzt die Elterninstanz des Detektors
**um** `(1, 0)` im angegebenen
`Class.UIDragDetector.DragSpace|DragSpace` bewegen wird.


UIDragDetector.DragRelativity

Legt das Paradigma fest, das die Relativität von Eingaben/Ausgaben von einer
benutzerdefinierten Ziehfunktion definiert.


Die Rotation, die durch das aktuelle Ziehen ausgeführt wird. Dieser Wert wird in
Grad relativ zum lokalen Raum der `Class.UIDragDetector` definiert, es sei denn,
`Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` wird definiert,
 in diesem Fall ist die Rotation im lokalen Raum dieser Instanz und von ihrer positiven
**X**-Achse definiert.

Diese Eigenschaft kann geändert werden, solange kein aktives Ziehen vorhanden ist, um das
gezogene Objekt zu drehen.


UIDragDetector.DragRotation

Die Rotation, die durch das aktuelle Ziehen ausgeführt wird.


Gilt nur, wenn eine benutzerdefinierte Ziehfunktion über
`Class.UIDragDetector:SetDragStyleFunction()|SetDragStyleFunction()` oder
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` registriert ist.
Legt das Paradigma fest, das den Raum der Eingaben/Ausgaben der registrierten Funktion definiert.

Beispielsweise, wenn die Elterninstanz des Detektors `Class.GuiObject` ein Kind von einer
Eltern-`Class.GuiObject` ist, die rotiert:

- Das Zurückgeben von `Datatype.UDim2.fromOffset(1, 0)` von einer registrierten Funktion
  mit diesem Wert auf `Enum.UIDragDetectorDragSpace.Parent` gesetzt wird
  die Elterninstanz des Detektors `Class.GuiObject` um 1 Pixel nach rechts im
  lokalen Raum bewegen, der von der Rotation des Elternteils betroffen ist.

- Das Zurückgeben von `Datatype.UDim2.fromOffset(1, 0)` von einer registrierten Funktion
  mit diesem Wert auf `Enum.UIDragDetectorDragSpace.LayerCollector`
  wird die Elterninstanz des Detektors `Class.GuiObject` um 1
  Pixel nach rechts im Raum des `Class.LayerCollector` bewegen.


UIDragDetector.DragSpace

Legt das Paradigma fest, das den Raum der Eingaben/Ausgaben von einer benutzerdefinierten
Ziehfunktion definiert.


Das Paradigma, das verwendet wird, um vorgeschlagene Bewegung zu erzeugen, gegeben durch einen Stream von Eingabe-
Positionsvektoren. Siehe `Enum.UIDragDetectorDragStyle` für Optionen.


UIDragDetector.DragStyle

Das Paradigma, das verwendet wird, um vorgeschlagene Bewegung zu erzeugen.


Die Translation, die durch das aktuelle Ziehen in einem
`Datatype.UDim2`-Wert ausgedrückt wird. Die Translation erfolgt durch
`Datatype.UDim.Offset|Offset` oder `Datatype.UDim.Scale|Scale`-Wertänderungen,
abhängig von dem `Class.UIDragDetector.DragRelativity|DragRelativity`-Wert, und sie ist relativ zum lokalen Raum des Detektors,
es sei denn, es ist eine
`Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance` definiert.

Diese Eigenschaft kann geändert werden, während kein aktives Ziehen vorhanden ist, um das
gezogene Objekt zu bewegen.


UIDragDetector.DragUDim2

Die Translation, die durch das aktuelle Ziehen in einem
`Datatype.UDim2`-Wert ausgedrückt wird.


Wenn `true`, reagiert der `Class.UIDragDetector` auf Benutzereingaben; wenn `false`,
 tut er dies nicht.


UIDragDetector.Enabled

Ob der `Class.UIDragDetector` auf Benutzereingaben reagiert.


Wenn diese Eigenschaft größer ist als
`Class.UIDragDetector.MinDragAngle|MinDragAngle`, wird die Rotation auf den Bereich von
`Class.UIDragDetector.MinDragAngle|MinDragAngle` und
`Class.UIDragDetector.MaxDragAngle|MaxDragAngle` begrenzt. Positive Werte behindern
im Uhrzeigersinn rotation, während negative Werte die
Gegenuhrzeigersinn-rotation verhindern.

Dies ist keine Einschränkung; es behindert lediglich die Versuche des Detektors, Bewegung
erzeugen zu wollen, um innerhalb von Grenzen zu bleiben. Siehe
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` um eine benutzerdefinierte Einschränkung zu einem Drag hinzuzufügen.

Nur relevant, wenn `Class.UIDragDetector.DragStyle|DragStyle` ist
`Enum.UIDragDetectorDragStyle.Rotate`.


UIDragDetector.MaxDragAngle

Zusammen mit `Class.UIDragDetector.MinDragAngle|MinDragAngle` behindert es die
Versuche des Detektors, Drehbewegungen zu erzeugen.


Wenn die entsprechenden `Datatype.UDim.Offset|Offset` und/oder
`Datatype.UDim.Scale|Scale`-Werte in allen Dimensionen größer sind als die von
`Class.UIDragDetector.MinDragTranslation|MinDragTranslation`, wird die lineare/ebene Translation
im Bereich von `Class.UIDragDetector.MinDragTranslation|MinDragTranslation` und
`Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation` begrenzt.

Dies ist keine Einschränkung; es behindert lediglich die Versuche des Detektors, Bewegung
erzeugen zu wollen, um innerhalb von Grenzen zu bleiben. Siehe
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` um eine benutzerdefinierte Einschränkung zu einem Drag hinzuzufügen.

Nur relevant, wenn `Class.UIDragDetector.DragStyle|DragStyle` ist
`Enum.UIDragDetectorDragStyle.TranslateLine` oder
`Enum.UIDragDetectorDragStyle.TranslatePlane`.


UIDragDetector.MaxDragTranslation

Zusammen mit `Class.UIDragDetector.MinDragTranslation|MinDragTranslation` hindert es die
Versuche des Detektors, lineare/ebene Bewegungen zu erzeugen.


Wenn diese Eigenschaft kleiner ist als
`Class.UIDragDetector.MaxDragAngle|MaxDragAngle`, wird die Rotation auf den Bereich von
`Class.UIDragDetector.MinDragAngle|MinDragAngle` und
`Class.UIDragDetector.MaxDragAngle|MaxDragAngle` begrenzt. Positive Werte behindern
im Uhrzeigersinn rotation, während negative Werte die
Gegenuhrzeigersinn-rotation verhindern.

Dies ist keine Einschränkung; es behindert lediglich die Versuche des Detektors, Bewegung
erzeugen zu wollen, um innerhalb von Grenzen zu bleiben. Siehe
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` um eine benutzerdefinierte Einschränkung zu einem Drag hinzuzufügen.

Nur relevant, wenn `Class.UIDragDetector.DragStyle|DragStyle` ist
`Enum.UIDragDetectorDragStyle.Rotate`.


UIDragDetector.MinDragAngle

Zusammen mit `Class.UIDragDetector.MaxDragAngle|MaxDragAngle` behindert es die
Versuche des Detektors, Drehbewegungen zu erzeugen.


Wenn die entsprechenden `Datatype.UDim.Offset|Offset` und/oder
`Datatype.UDim.Scale|Scale`-Werte in allen Dimensionen kleiner sind als die von
`Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation`, wird die lineare/ebene Translation
im Bereich von `Class.UIDragDetector.MinDragTranslation|MinDragTranslation` und
`Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation` begrenzt.

Dies ist keine Einschränkung; es behindert lediglich die Versuche des Detektors, Bewegung
erzeugen zu wollen, um innerhalb von Grenzen zu bleiben. Siehe
`Class.UIDragDetector:AddConstraintFunction()|AddConstraintFunction()` um eine benutzerdefinierte Einschränkung zu einem Drag hinzuzufügen.

Nur relevant, wenn `Class.UIDragDetector.DragStyle|DragStyle` ist
`Enum.UIDragDetectorDragStyle.TranslateLine` oder
`Enum.UIDragDetectorDragStyle.TranslatePlane`.


UIDragDetector.MinDragTranslation

Zusammen mit `Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation` hindert es die
Versuche des Detektors, lineare/ebene Bewegungen zu erzeugen.


Eine `Class.GuiObject`-Instanz, deren lokaler Raum und absoluter Mittelpunkt
position der Referenzraum und Ursprung für den Detektor ist. Das Setzen dieser
Referenz beeinflusst Eigenschaften wie
`Class.UIDragDetector.DragUDim2|DragUDim2`,
`Class.UIDragDetector.DragRotation|DragRotation` und das Verhalten von
`Class.UIDragDetector.DragAxis|DragAxis`.


UIDragDetector.ReferenceUIInstance

Eine `Class.GuiObject`-Instanz, deren lokaler Raum und absoluter Mittelpunkt
position der Referenzraum und Ursprung für den Detektor ist.


Sobald die vorgeschlagene Bewegung berechnet und möglicherweise eingeschränkt wurde,
wird dieses Paradigma verwendet, um zu bestimmen, wie sich das
`Class.GuiObject`, das von der `Class.UIDragDetector` betroffen ist, bewegen (oder nicht bewegen) soll. Siehe
`Enum.UIDragDetectorResponseStyle` für Optionen.


UIDragDetector.ResponseStyle

Das Paradigma, das verwendet wird, um die Reaktion auf vorgeschlagene Bewegung zu definieren.


Definiert die maximale Ziehgeschwindigkeit für die Translation als Kombination von
`Datatype.UDim.Scale|Scale` und `Datatype.UDim.Offset|Offset` der ersten
Vorfahren-`Class.ScreenGui` oder `Class.SurfaceGui`, zu der der
`Class.UIDragDetector` gehört. Dieser Wert muss positiv sein und jeder
Wert unter `0` wird auf `0` begrenzt.


UIDragDetector.SelectionModeDragSpeed

Maximale Ziehgeschwindigkeit für die Translation.


Definiert den maximalen Winkel pro Sekunde, bei dem die `Class.UIDragDetector`
rotieren kann. Dieser Wert muss positiv sein und jeder Wert unter `0` wird auf
`0` begrenzt.


UIDragDetector.SelectionModeRotateSpeed

Maximaler Winkel pro Sekunde, den die `Class.UIDragDetector` drehen kann.


`Enum.UIDragSpeedAxisMapping`-Wert, der die **X**/**Y**
Dimension Ziehgeschwindigkeiten bestimmt.


UIDragDetector.UIDragSpeedAxisMapping

Instanz, die die Interaktion mit UI-Elementen in einer
Erfahrung erleichtert und fördert.


Eine Basis-Klasse für UI-Einschränkungen und Layout-Klassen; erbt von
`Class.UIBase`.


UIComponent

Eine Basis-Klasse für UI-Einschränkungen und Layout-Klassen.


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


UIBase

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

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

Demonstriert die Erkennung von Änderungen in der Abstammung einer Instanz, indem die `Class.Instance.AncestryChanged`-Ereignis verbunden wird.

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

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

Dieses Ereignis enthält zwei Parameter: `child` bezieht sich auf die `Class.Instance`,
dessen `Class.Instance.Parent` tatsächlich geändert wurde, während `parent` sich auf die
e neue `Class.Instance.Parent` bezieht.

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

Instance.AncestryChanged

child

Die `Class.Instance`, deren `Class.Instance.Parent` geändert wurde.

parent

Der neue `Class.Instance.Parent` der `Class.Instance`, deren
`Class.Instance.Parent` geändert wurde.

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

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

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

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "geändert")
end

part.AttributeChanged:Connect(attributeChanged)
```
Siehe auch `Class.Instance:GetAttributeChangedSignal()`, das ein Ereignis zurückgibt,
das ausgelöst wird, wenn ein bestimmtes Attribut geändert wird.

Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.

Wird ausgelöst, wenn ein Attribut an der `Class.Instance` geändert wird.

Dieses Snippet druckt die Namen von Objekten aus, während sie zum Workspace hinzugefügt werden:

Ausgelöst, nachdem ein Objekt diesem `Class.Instance` zugeordnet wurde.

Beachten Sie, dass es notwendig ist, `Class.Instance:WaitForChild()` zu verwenden, wenn
der Client verwendet wird, um Objekte zu erkennen, die vom Server erstellt wurden,
beim Indizieren der Nachkommen dieser Objekte. Das liegt daran, dass das Objekt und
seine Nachkommen nicht gleichzeitig vom Server an den Client repliziert werden.
Zum Beispiel:

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

Workspace.ChildAdded:Connect(function(child)
	-- Verwenden Sie WaitForChild(), da Nachkommen möglicherweise noch nicht repliziert wurden
	local head = child:WaitForChild("Head")
end)
```
Beachten Sie, dass dieses Ereignis nur für unmittelbare Kinder der
`Class.Instance` funktioniert. 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 in diese `Class.Instance` eingefügt wird.

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

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

Entfernt bezieht sich darauf, wenn der Elterne von einem Objekt von dieser
`Class.Instance` auf etwas anderes als diese `Class.Instance` geändert wird. Beachten Sie, dass dieses
Ereignis auch ausgelöst wird, wenn ein Kind zerstört wird (unter Verwendung von
`Class.Instance:Destroy()`), da die Zerstörungsfunktion den Elterne 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 in die `Class.Instance` eingefügt wurde.

Da es für jeden Nachkommen ausgelöst wird, wird das Einfügen eines Objekts in die
`Class.Instance` das Ereignis für dieses Objekt und alle seine Nachkommen einzeln auslösen.

Wenn Sie sich nur für die **direkten Kinder** der `Class.Instance` interessieren, verwenden Sie
`Class.Instance.ChildAdded` stattdessen.

Siehe auch `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Wird ausgelöst, nachdem ein Nachkomme in die `Class.Instance` eingefügt wurde.

Das folgende Beispiel gibt den Namen eines Nachkommens aus, während er entfernt wird
aus dem Workspace:

Dieses Ereignis wird **unmittelbar bevor** die übergeordnete `Class.Instance`
so geändert wird, dass eine **Nachfahr**-Instanz nicht mehr ein
Nachfahre ist. `Class.Instance:Destroy()|Destroy()` ändert das `Class.Instance.Parent|Parent` einer Instanz auf `nil`, sodass der Aufruf dieser Methode auf einem Nachfahren der übergeordneten Instanz dazu führt, dass dieses Ereignis ausgelöst wird.

Da dieses Ereignis **vor** der Entfernung des Nachfahren ausgelöst wird, bleibt der Elternteil des Nachfahren zum Zeitpunkt des Auslösens dieses Ereignisses unverändert. Wenn der Nachfahre auch ein **direktes Kind** des Elternteils ist, wird dieses Ereignis
vor `Class.Instance.ChildRemoved` ausgelöst.

Wenn ein Nachfahre Kinder hat, wird dieses Ereignis zuerst mit dem Nachfahren ausgelöst,
gefolgt von seinen Nachfahren.

##### Warnung

Dieses Ereignis wird mit dem Nachfahrenobjekt, das entfernt wird, ausgelöst.
Der Versuch, das `Class.Instance.Parent|Parent` des Nachfahren auf
etwas anderes zu setzen, wird fehlschlagen. Im Folgenden ein Beispiel, das dies demonstriert:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipuliere nicht den Elternteil des Nachfahren in dieser Funktion!
	-- Dieses Ereignis wird ausgelöst, WEIL der Elternteil manipuliert wurde und die Änderung noch nicht erfolgt ist.
	-- 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 unmittelbar bevor ein Nachfahre der `Class.Instance` entfernt wird, ausgelöst.

Dieses Beispiel zeigt, wie ein Instanz, die zerstört wird, an ihrem Platz bleibt, bis die verbundene Funktion ausführt.

Dieses Beispiel zeigt, wie ein Instanz zerstört wird, bevor das Signal ausgelöst wird, wenn das Verhalten verschobener Signale verwendet wird.

Die `Class.Instance` wird niemals aus dem Speicher gelöscht, während eine verbundene
Funktion sie noch verwendet. Wenn die Funktion jedoch an irgendeinem Punkt wartend ist,
wird die `Class.Instance` und ihre Nachfahren auf `nil` gesetzt.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Immediate` gesetzt ist, wird dieses Ereignis unmittelbar bevor die
`Class.Instance` oder einer ihrer Vorfahren mit `Class.Instance:Destroy()` zerstört wird, ausgelöst.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis an dem nächsten Wiederaufnahme-
punkt ausgelöst, der nach der Zerstörung der `Class.Instance` oder einer ihrer Vorfahren mit
`Class.Instance:Destroy()` liegt.

Mit dem Verhalten `Enum.SignalBehavior.Deferred|Deferred` ist es problematisch, ein Skript
mit seinem eigenen `Class.Instance.Destroying`-Ereignis zu verbinden, da das Skript
vor dem Aufruf des Rückrufs zerstört wird (was bedeutet, dass es nicht ausgeführt wird).

Beim Löschen einer `Class.Instance` im Studio, wie zum Beispiel dem manuellem Löschen
über den [Explorer](/studio/explorer) oder über ein Plugin,
wird die `Class.Instance` nicht zerstört. Stattdessen wird der Elternteil auf `nil`
gesetzt, was Sie mit `Class.Instance.AncestryChanged` verfolgen können.

Instance.Destroying

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

Dieses Ereignis wird ausgelöst, wenn eine Stil-Eigenschaft der Instanz geändert wird,
 einschließlich 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 Stil-Eigenschaft der Instanz geändert wird, einschließlich
wenn eine Eigenschaft auf `nil` gesetzt wird.

Instance.childAdded

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 gegebenen Tag erzeugt 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 die vorherigen Tags überschreibt.

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

Instance:AddTag

Diese Methode zerstört alle Kinder und Nachkommen einer Instanz.

```
local part = Instance.new("Part")

-- Fügen Sie einige Funkeln hinzu
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Kinder:", #part:GetChildren())  --> Kinder: 3

part:ClearAllChildren()

print("Kinder:", #part:GetChildren())  --> Kinder: 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 zu zerstören ist. Zum
Beispiel wird das folgende Codebeispiel alle
`Class.BasePart|BaseParts` zerstören, die von einem `Class.Model` abstammen:

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

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Diese Methode zerstört alle Kinder einer Instanz.

Demonstriert das Klonen eines Modells mit `Class.Instance:Clone()`.

`Clone()` erstellt eine Kopie einer Instanz und all ihrer Nachkommen,
ignoriert alle Instanzen, die nicht
`Class.Instance.Archivable|Archivable` sind. Die Kopie der Wurzelinstanz wird
von dieser Methode zurückgegeben und ihr `Class.Instance.Parent|Parent` wird auf
`nil` gesetzt. Beachte, dass wenn die Instanz selbst
`Class.Instance.Archivable|Archivable` auf `false` gesetzt hat, diese Methode
`nil` zurückgibt.

Wenn eine Referenz-Eigenschaft wie `Class.ObjectValue.Value` in einer
clonierten Instanz gesetzt ist, hängt der Wert der Eigenschaft der Kopie von
wert der Originalinstanz ab:

- Wenn eine Referenz-Eigenschaft auf eine Instanz verweist, die **auch** geklont wurde,
  wird die Kopie auf die Kopie verweisen.
- Wenn eine Referenz-Eigenschaft auf eine Instanz verweist, die **nicht** geklont wurde,
  bleibt der gleiche Wert in der Kopie erhalten.


Instance:Clone

Erstellt eine Kopie einer Instanz und aller ihrer Nachkommen, wobei Instanzen,
 die nicht `Class.Instance.Archivable|Archivable` sind, ignoriert werden.

Demonstriert das Zerstören eines Teils 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()` bei allen Kindern auf. Diese Methode ist der korrekte Weg, um Objekte zu
entsorgen, die nicht mehr benötigt werden.

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

Als Best Practice sollte nach dem Aufruf von `Destroy()` auf einem 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 = "Hallo, Welt"
part:Destroy()
-- Machen Sie das nicht:
print(part.Name)  --> "Hallo, Welt"
-- Machen Sie das, um die obige Zeile unbrauchbar zu machen:
part = nil
```
Sobald eine `Class.Instance` durch diese Methode zerstört wurde, kann sie nicht
wiederverwendet werden, da die `Class.Instance.Parent`-Eigenschaft gesperrt ist. Um ein
Objekt **vorübergehend** zu entfernen, anstatt es zu zerstören, setzen Sie
`Class.Instance.Parent|Parent` auf `nil`. Zum Beispiel:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Um ein Objekt nach einer bestimmten Zeit zu zerstören, verwenden Sie
`Class.Debris:AddItem()`.

Instance:Destroy

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die
`Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft
`Destroy()` für alle Kinder auf.

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

Diese Methode arbeitet aufwärts, was bedeutet, dass sie am unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben zum
`Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahr gefunden wird,
rückt sie `nil` zurück.

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

```
local car = object:FindFirstAncestor("Car")
```
Für Varianten dieser Methode, die Vorfahren einer spezifischen 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 des `Class.Instance` zurück, dessen
`Class.Instance.Name` gleich dem gegebenen Namen ist.

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

Diese Methode arbeitet aufwärts, was bedeutet, dass sie am unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben zum
`Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahr gefunden wird,
rückt sie `nil` zurück.

Eine häufige Nutzung 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 überprüft, anstatt
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` existiert auch,
verwendet die `Class.Object:IsA()`-Methode, um die Klassenvererbung zu respektieren.

Instance:FindFirstAncestorOfClass

className

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

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

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

Diese Methode arbeitet aufwärts, was bedeutet, dass sie am unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und nach oben zum
`Class.DataModel` arbeitet. Wenn kein übereinstimmender Vorfahr gefunden wird,
rückt sie `nil` zurück.

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

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Daher wird das folgende Codebeispiel den ersten
`Class.BasePart`-Vorfahr zurückgeben, unabhängig davon, ob er ein
`Class.WedgePart`, `Class.MeshPart` oder `Class.Part` ist.

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

Instance:FindFirstAncestorWhichIsA

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

Die folgende Suche würde im Workspace nach einem Objekt mit dem Namen "Brick" suchen. Wenn es gefunden wird,
wird der Name des Objekts auf "Foo" geändert.

Gibt das erste Kind der `Class.Instance` mit dem angegebenen Namen zurück, oder
`nil`, wenn kein solches Kind existiert. Wenn das optionale Argument `recursive`
`true` ist, sucht diese Methode alle Nachkommen und nicht nur die unmittelbaren
Kinder der `Class.Instance`.

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

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

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

-- Die folgende Zeile gibt einen Fehler aus, wenn der Teil nicht im Workspace existiert
Workspace.Part.Transparency = 0.5
```
Ein besserer Ansatz ist die Verwendung von `FindFirstChild()`, um zuerst nach
`Part` zu suchen und dann eine `if`-Anweisung zu verwenden, um den Code
auszuführen, der sie 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 einer Eigenschaft entspricht

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

Im folgenden Beispiel wird ein `Class.Folder` namens `Color` zu einem
`Class.Part` hinzugefügt, das auch die `Class.Part.Color`-Eigenschaft hat. Beachten Sie,
dass `part.Color` auf den `Datatype.Color3`-Eigenshaftenwert verweist, nicht auf die
Kindinstanz `Class.Folder`. Ein Vorteil der Verwendung von
`Class.Instance:FindFirstChild()|FindFirstChild()` besteht darin, dass die
Einführung neuer Eigenschaften kein Risiko für Ihren Code darstellt.

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

##### Leistungshinweise

`Class.Instance:FindFirstChild()|FindFirstChild()` benötigt etwa 20% länger
als die Verwendung des Punktoperators und fast 8 mal länger als einfach nur eine
Referenz auf ein Objekt zu speichern. Daher sollten Sie vermeiden, es in
leistungsabhängigem Code aufzurufen, wie in engen Schleifen oder Funktionen,
die mit `Class.RunService.Heartbeat` und `Class.RunService.PreRender`
verbunden sind. Stattdessen sollten Sie das Ergebnis in einer Variable speichern oder
`Class.Instance.ChildAdded|ChildAdded` oder
`Class.Instance:WaitForChild()|WaitForChild()` verwenden, um zu erkennen,
wann ein Kind mit einem gegebenen Namen verfügbar wird.

Instance:FindFirstChild

recursive

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

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

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 und die die Klassenvererbung ignoriert. 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 gegebenen Klassennamen ist.

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

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

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

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Daher wird das folgende Codebeispiel das erste
`Class.BasePart`-Kind zurückgeben, unabhängig davon, ob es ein `Class.WedgePart`,
`Class.MeshPart` oder `Class.Part` ist.

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

Instance:FindFirstChildWhichIsA

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

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

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

Instance:FindFirstDescendant

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

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

Instance:GetActor

Gibt die `Class.Actor` zurück, die mit der Instanz assoziiert ist, falls vorhanden.

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

Zum Beispiel setzt der folgende Code-Schnipsel den Wert des Attributs `InitialPosition` der Instanz:

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

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

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

##### Siehe auch

- `Class.Instance:SetAttribute()`, die das Attribut mit dem gegebenen
  Namen auf den gegebenen Wert setzt.
- `Class.Instance:GetAttributes()`, die ein Dictionary von 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 gegebenen 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 der Ausnahme, dass es nur
ausgelöst wird, wenn sich das spezifische gegebene Attribut ändert; effektiv ähnelt es
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` aber
für Attribute.

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

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

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

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

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

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Siehe auch `Class.Instance.AttributeChanged`, das ausgelöst wird, wann immer ein
Attribut auf der Instanz geändert wird.

Instance:GetAttributeChangedSignal

Der Name des bestimmten Attributs, für das das Änderungssignal
zurückgegeben wird.

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

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

Diese Methode gibt ein Dictionary von Schlüssel-Wert-Paaren für jedes Attribut
zurück, wobei der Schlüssel der Name des Attributs und der Wert ein-nicht-nil Wert ist.

Zum Beispiel gibt der folgende Code 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 zugewiesen wurde,
zum gegebenen Attributnamen.

Instance:GetAttributes

Ein Dictionary von Zeichenfolgen → Varianten-Paaren für jedes Attribut,
bei dem die Zeichenfolge der Name des Attributs und die Variante ein nicht-nil
Wert ist.

Gibt ein Dictionary der Attribute der Instanz zurück.

Instance

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

/reference/engine/classes/UIDragDetector.yaml