ScreenGui
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Das Haupt-Speicherobjekt für 2D GuiObjects , das auf dem Bildschirm des Benutzers angezeigt wird. Ein ScreenGui zeigt nur an, wenn
Für Leistungssteigerungen wird die Aktualisierung eines ScreenGui bis zu einem der folgenden Ereignisse verzögert:
- Ein Nachkommen wird hinzugefügt oder entfernt.
- Eine Eigenschaft eines Nachkommen ändert sich.
- Eine Eigenschaft des ScreenGui selbst ändert sich.
Wenn eines dieser Ereignisse auftreten, wird die ScreenGui Ausgabe auf dem nächsten Bildschirm, auf dem sie gerendert wird, neu berechnet.
Zusammenfassung
Eigenschaften
Ob die Inhalte dieses ScreenGui an den sicheren Bereich des Geräts geklippt werden sollen.
Steuert die Z-Index-Reihenfolge, in der mehrere ScreenGuis gezeichnet werden.
Bestimmt, ob dies ScreenGui übersteigt die Reichweite der Kerndateien von Roblox.
Gibt an, ob automatische UI-Kompatibilitäts-Transformierungen auf "Vollbild"-Anwendungen für Displays mit Bildschneidungen angewendet werden.
Steuert die sicheren Bereichselemente, die auf die Inhalte dieses ScreenGui angewendet werden.
Schaltet die Sichtbarkeit von diesem LayerCollector um.
Bestimmt, ob der LayerCollector zurückgesetzt wird (selbst gelöscht und in den Spieler:in's PlayerGui klont), jedes Mal, wenn der Charakter des Spieler:inrespawns.
Steuert, wie GuiObject.ZIndex auf allen Nachkommen dieses LayerCollector agiert.
Beschreibt die tatsächliche Bildschirmposition eines UI-Elements in Pixeln.
Beschreibt die tatsächliche Bildschirmdrehung eines UI-Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines UI-Elements in Pixel.
Wenn auf wahr gesetzt, wird die Lokalisierung auf diesen GuiBase2d und seinen Nachkommen angewendet.
Eine Verweisung auf eine LocalizationTable , die verwendet wird, um automatisierte Lokalisierung auf diesen GuiBase2d und seinen Nachkommen anzuwenden.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung unten.
Anpassen Sie das Gamepad-Auswahlverhalten in der linken Richtung.
Benutzerdefiniert das Verhalten der Spielpad-Auswahl in die richtige Richtung.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung nach oben.
Erlaubt die Anpassung der Gamepad-Auswahl.
Ereignisse
Ereignisse von GuiBase2d übernommen- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Gamepad-Auswahl bewegt wird, geht oder sich in der verbundenen GuiBase2d oder einem Nachfolge GuiObjekten ändert.
Eigenschaften
ClipToDeviceSafeArea
Wenn diese Eigenschaft true ist, werden alle Nachkommen von GuiObject , die von diesem ScreenGui abgeleitet sind, in den sicheren Bereich des Geräts geklippt (siehe 1> Enum.ScreenInsets1> ). Die Standard ist 4> true 4>, um die Kompatibil
Wenn diese Eigenschaft false ist, werden Nachkommen von GuiObject in der sicheren Zone des Geräts nicht eingeklippt und können durch die Kamera-Namensschacht oder andere Bildschirm-Schrägstriche verborgen sein.
Beachten Sie, dass diese Eigenschaft ignoriert wird, wenn Sie ScreenGui.ScreenInsets auf None einstellen, da dies impliziert, dass Sie die sicherheitsbasierten Insets des Geräts absichtlich ignorieren möchten.
DisplayOrder
Dieses Eigenschaften steuert die Z-Index-Ordnung, in der mehrere ScreenGuis gezeichnet werden. ScreenGuis mit einem höheren DisplayOrder wird über diejenigen mit einem niedrigeren Wert gezeichnet.
IgnoreGuiInset
Wenn diese Eigenschaft false (Standard) ist, wird ScreenInsets auf CoreUISafeInsets gesetzt, wodurch seine Grenzen unter der Roblox-Top-Bar-UI effektiv gehalten werden.
Wenn diese Eigenschaft auf true und ScreenInsets aktuell auf CoreUISafeInsets gesetzt ist, wird 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> auf 4> Class.ScreenGui.ScreenInsets|DeviceSafeInsets
Siehe ScreenInsets für Details darüber, wie Bildschirm-Einstellungen die Inhalte eines ScreenGui beeinflussen.
SafeAreaCompatibility
Diese Eigenschaft spezifiziert, ob automatische UI-Kompatibilitäts-Transformierungen auf dem Nachkommen "Vollbild" GuiObjects von diesem ScreenGui auf Anzeigen mit Bildschneide ausgewendet werden. Die
Der Standardwert ist FullscreenExtension , um das Aussehen von UI automatisch zu verbessern, die für Bildschirme ohne Kürzungen geschrieben wurde. Wenn Sie jedoch neue Arbeiten vermeiden möchten, empfehlen wir Ihnen, vollständige Erweiterungen für neue Arbeit zu vermeiden; stattdessen verwenden Sie die Eigenschaft Class.ScreenGui.ScreenInsets|Screen
Beachten Sie, dass die nachkommenden UI-Objekte weiterhin durch die sichere Zone des Geräts geschnitten werden, wenn ClipToDeviceSafeArea auf true eingestellt ist.
ScreenInsets
Dieses Eigenschaftsteuert die sicheren Bereichselemente, die auf die Inhalte dieses ScreenGui angewendet werden.
Die Standardversion von CoreUISafeInsets behält alle Nachkommen von GuiObjects im Kerndisplay-Sicherheitsbereich, frei von den Roblox-Top-Bar-Schaltflächen und anderen Bildschirmschnitten wie der Kamera-Notch des Geräts.
Wenn Sie diese Eigenschaft auf None setzen, können UI-Objekte hinter dem Kern-UI-Objekt oder dem Geräte-Cutout wie der Kamera nicht verborgen werden. Ergebnissollten Sie nur None für ein ScreenGui verwenden, das keine interaktiven Inhalte wie Hintergrundbilder enthält.
Siehe On-Screen UI Containers für alternative Beispiele.