UI-Erscheinungsmodifikatoren

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Durch die Nutzung von Erscheinungsmodifikatoren können Sie das Aussehen Ihrer GuiObjects weiter anpassen.

  • Wenden Sie einen Verlauf auf den Hintergrund eines Objekts an.
  • Wenden Sie einen Strich auf Text oder eine Grenze an.
  • Setzen Sie abgerundete Ecken für ein Objekt.
  • Erhöhen Sie den Abstand zwischen den Rändern eines Objekts.
  • Fügen Sie einen Schatten hinter einem Objekt hinzu.

Verlauf

Das UIGradient-Objekt wendet einen Farb- und Transparenzverlauf auf sein übergeordnetes GuiObject an.

Sie können den Verlauf konfigurieren, indem Sie:

Farbsequenz

Um die Farbsequenz eines Verlaufs festzulegen:

  1. Wählen Sie im Explorer Fenster das UIGradient aus.

  2. Klicken Sie im Eigenschaften Fenster in das Feld der Color-Eigenschaft, und klicken Sie dann auf die -Schaltfläche rechts im Eingabefeld.

  3. Jedes Dreieck auf der unteren Achse der Farbsequenz ist ein Schlüsselpunkt, der den Farbwert an diesem Punkt bestimmt.

    Farbsequenz-Popup von weiß zu weiß
    1. Klicken Sie auf einen Schlüsselpunkt in der Farbsequenz, um ihn auszuwählen oder neu zu positionieren, oder fügen Sie einen weiteren Schlüsselpunkt hinzu, indem Sie irgendwo auf das Diagramm klicken.
    2. Klicken Sie auf das kleine Quadrat neben Farbe, um das Farben-Popup-Fenster zu öffnen, und wählen Sie dann die gewünschte Farbe für den Schlüsselpunkt aus.
    3. Wiederholen Sie diese Schritte bei Bedarf, um Farben im Diagramm hinzuzufügen oder anzupassen.

Transparenz

Um die Transparenz eines Verlaufs über seinen Bereich anzupassen:

  1. Wählen Sie im Explorer Fenster das UIGradient aus.

  2. Klicken Sie im Eigenschaften Fenster in das Feld der Transparency-Eigenschaft, und klicken Sie dann auf die -Schaltfläche rechts im Eingabefeld.

  3. Jedes Quadrat im Diagramm der Zahlenfolge ist ein Schlüsselpunkt, der den Transparenzwert an diesem Punkt bestimmt.

    Schlüsselpunkte im Popup der Zahlenfolge beschriftet
    1. Klicken Sie auf einen Schlüsselpunkt in der Zahlenfolge, um ihn auszuwählen oder neu zu positionieren, oder fügen Sie einen weiteren Schlüsselpunkt hinzu, indem Sie irgendwo auf das Diagramm klicken.
    2. Geben Sie eine spezifische Zeit/Wert-Kombination über die Zeit- und Wert-Eingaben ein.
    3. Wiederholen Sie diese Schritte bei Bedarf, um Transparenzstufen im Diagramm hinzuzufügen oder anzupassen.

Typ

Die Type-Eigenschaft eines Verlaufs legt seinen Typ aus Linear, Radial oder Conical fest.

  • Linear — Die Farb-/Transparenzsequenz wechselt in einer geraden Linie über das Element. Die Richtung wird durch seine Rotation und die Position durch seinen Offset gesteuert. Dies ist der Standard.

  • Radial — Die Farb-/Transparenzsequenz strahlt von der Mitte des Elements nach außen, optional verschoben durch Offset. Der Radius wird durch den Durchschnitt der Breite und Höhe des Elements geteilt durch zwei definiert, effektiv (width+height)/4\text{(width+height)/4}. Rotation hat keinen Einfluss auf einen radialen Verlauf.

  • Conical — Die Farb-/Transparenzsequenz schwingt im Uhrzeigersinn um die Mitte des Elements, optional verschoben durch Offset. Rotation steuert den Start- und Endwinkel des Schwungs. Standardmäßig schwingt dies von 0 bis 360 Grad, aber Scale-Werte kleiner als 1 können diesen Winkel reduzieren.

Offset und Rotation

Die Offset- und Rotation-Eigenschaften ermöglichen es Ihnen, die Steuerpunkte des Verlaufs und seinen Winkel anzupassen. Wie in den folgenden Diagrammen dargestellt, basiert Offset auf einem Prozentsatz der Breite oder Höhe des Elternteils, und sowohl positive als auch negative Werte sind gültig.

Offset.X = 0.25
Offset.X = -0.25

Ähnlich, wenn Sie den Verlauf drehen, drehen sich auch die Steuerpunkte:

Maßstab

Der Scale eines Verlaufs multipliziert den Umfang des Verlaufs und steuert, wie viel der Farb-/Transparenzsequenz innerhalb des Elements sichtbar ist.

  • Wenn Scale kleiner als 1 ist, erstreckt sich der Verlauf über weniger als den gesamten Umfang. Die verbleibende Farbe/Transparenz wird gemäß der TileMode-Eigenschaft ausgefüllt.

  • Wenn Scale größer als 1 ist, erstreckt sich der Verlauf über mehr als den gesamten Umfang, und nur ein Teil der Farbe/Transparenz ist sichtbar.

Scale = 1
Scale = 0.25
Scale = 1.8

Kachelmodus

Die TileMode-Eigenschaft legt fest, wie der Verlauf wiederholt wird, wenn die gesamte Sequenz nicht vollständig das übergeordnete Element abdeckt.

  • Clamp — Standardmodus, bei dem die Farb-/Transparenzwerte am Anfang und Ende der Sequenz unendlich verlängert werden, sodass die Startwerte jeden Bereich vor dem Verlauf ausfüllen und die Endwerte jeden Bereich danach ausfüllen.

  • Repeat — Der Verlauf wiederholt sich, indem die Farb-/Transparenzsequenz nahtlos von Ende zu Anfang gewickelt wird. Dies kann eine sichtbare Naht erzeugen, wenn die ersten und letzten Farb-/Transparenzwerte in der Sequenz unterschiedlich sind.

  • Mirror — Der Verlauf spiegelt sich an jeder Grenze, sodass die Farb-/Transparenzsequenz hin und her schwingt. Dies erzeugt eine glatte Wiederholung ohne Naht, da die Richtung an jeder Kantenkante umkehrt.

Strich

Die UIStroke-Instanz wendet eine Umrandung auf Text oder eine Grenze an. Zu den Hauptmerkmalen gehören:

Dicke

Sie können die Strichbreite über die Thickness-Eigenschaft festlegen, die in Pixeln (Standard) oder skaliert relativ zum Elternteil gemessen wird, abhängig vom StrokeSizingMode des Modifikators. Wenn der Strich auf Text angewendet wird und StrokeSizingMode auf ScaledSize eingestellt ist, ist die Dicke relativ zur Schriftgröße.

Farbe oder Verlauf

Sie können die Strichfarbe über die Color-Eigenschaft festlegen sowie eine untergeordnete UIGradient-Instanz einfügen, um Farbverläufe für Striche zu erstellen.

UIStroke.Color = (0, 95, 225)
UIStroke mit UIGradient-Unterobjekt

Textumrandung oder Grenze

Je nach Typ des übergeordneten Objekts funktioniert UIStroke entweder als Textumrandung oder als Grenze. Wenn Sie UIStroke einem Textobjekt wie TextLabel unterordnen, wird es auf die Umrandung des Textes angewendet; wenn Sie UIStroke anderen GuiObjects unterordnen, wird es auf die Grenze angewendet.

TextLabel mit UIStroke-Unterobjekt
Frame mit UIStroke und UICorner-Unterobjekten

Wenn es auf ein Textobjekt angewendet wird, können Sie das Standardverhalten des Strichs durch die ApplyStrokeMode-Eigenschaft überschreiben, sodass Sie den Strich auf die Grenzen des Objekts anstatt auf den Text selbst anwenden können. Sie können sogar die Textumrandung und die Grenze unabhängig steuern, indem Sie zwei UIStroke-Instanzen einem Textobjekt unterordnen, eine auf Kontextuell und die andere auf Grenze eingestellt.

Grenzposition/Offset

BorderStrokePosition legt die Position des Strichs relativ zur Grenze seines Elternteils fest, und BorderOffset ermöglicht es Ihnen, einen zusätzlichen Offset zur Position des Strichs anzugeben.

BorderOffset = (0.15, 0)
BorderOffset = (0, -16)

Transparenz

Die Transparency-Eigenschaft legt die Strichtransparenz unabhängig von der BackgroundTransparency oder TextTransparency des übergeordneten Objekts fest. Dies ermöglicht es Ihnen, Text und Grenzen zu rendern, die "hohl" sind (nur aus einer Umrandung bestehen).

Eckenstil

Die LineJoinMode-Eigenschaft ermöglicht es Ihnen, zu steuern, wie Ecken interpretiert werden. Sie akzeptiert einen Wert von entweder Round, Bevel oder Miter.

Schichtung

Um mehrere Geschwister-UIStroke-Instanzen auf einem GuiObject von vorne nach hinten zu schichten, können Sie die ZIndex-Eigenschaft nutzen. Diejenigen mit einem niedrigeren ZIndex werden unter (hinter) denen mit einem höheren ZIndex gerendert.

Beachten Sie, dass die Renderreihenfolge für UIStroke-Instanzen mit demselben ZIndex undefiniert ist. Wenden Sie keine mehreren UIStroke-Instanzen mit demselben Index an, wenn ihre Renderreihenfolge von Bedeutung ist.

Ecken

Die UICorner-Instanz wendet eine Deformation auf die Ecken ihres übergeordneten GuiObject an. Sie können den angewendeten Radius über die CornerRadius-Eigenschaft mithilfe von Scale oder Offset steuern.

Scale rundet die Ecken auf einen Prozentsatz basierend auf der Gesamtlänge der kürzesten Kante des Elternteils, was bedeutet, dass ein Maßstab von 0.5 oder höher das Elternteil in eine "Pillen"-Form deformiert, unabhängig von seiner Breite oder Höhe. Offset rundet die Ecken auf eine spezifische Anzahl von Pixeln, unabhängig von der Breite/Höhe des Elternteils.

Scale = 0.25  ·  Offset = 0
Scale = 0.5  ·  Offset = 0
Scale = 0  ·  Offset = 32
Scale = 0  ·  Offset = 64

Sie können auch einzelne Ecken über die TopLeftRadius, TopRightRadius, BottomRightRadius und BottomLeftRadius-Eigenschaften steuern.

TopLeftRadius = (0, 0)
TopRightRadius = (0, 48)
BottomRightRadius = (0, 48)
BottomLeftRadius = (0, 0)

Padding

Ein UIPadding-Objekt wendet oberen, unteren, linken und/oder rechten Abstand auf den Inhalt des übergeordneten GuiObject an. Zum Beispiel können Sie den Text innerhalb eines Textlabels nach unten oder oben verschieben, indem Sie einen Offset auf die PaddingBottom-Eigenschaft des Modifikators anwenden.

Schatten

Ein UIShadow-Objekt rendert einen Schlagschatten hinter seiner übergeordneten UI-Instanz. Zu den Hauptmerkmalen gehören:

Unschärfe

Die BlurRadius-Eigenschaft bestimmt die Unschärfe des Schattens. Ein größerer Wert lässt die Kanten des Schattens weicher erscheinen. Beachten Sie, dass der Skalierungsfaktor dieser UDim-Eigenschaft relativ zur Breite oder Höhe des Elternteils ist, je nachdem, welches kürzer ist.

BlurRadius = (0, 0)
BlurRadius = (0.75, 0)

Farbe und Transparenz

Die Color-Eigenschaft bestimmt die Farbe des Schattens, während Transparency die Transparenz des Schattens mit 0 als vollständig undurchsichtig und 1 als vollständig transparent festlegt.

Color = (255, 255, 255)  ·  Transparency = 0.6
Color = (50, 0, 35)  ·  Transparency = 0

Offset und Ausbreitung

Die Offset-Eigenschaft verschiebt den Schatten relativ zur Position des Elternteils, während Spread den Schatten relativ zur Größe des Elternteils erweitert oder verkleinert.

Offset = {0, -14}, {0, 6}
Offset = {0.1, 0}, {-0.15, 0}
Spread = {0, 10}, {0, 10}
Spread = {0.3, 0}, {0.3, 0}
©2026 Roblox Corporation. Roblox, das Roblox-Logo und "Powering Imagination" gehören zu unseren eingetragenen und nicht eingetragenen Markenzeichen in den USA und anderen Ländern.