ScreenGui
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
ScreenGui ist ein Speichercontainer für 2D GuiObjects , die auf dem Bildschirm des Benutzers angezeigt wird.Ein wird nur angezeigt, wenn es einem Spieler:inzugewiesen wird; das Eltern sein eines zu einem sorgt dafür, dass es sich in jedem Spieler:inklont, wenn sie sich der Erfahrung anschließen und ihr Charakter zuerst spawnet.Siehe On‑Screen-UI-Container für weitere Details.
Für Leistungsverbesserungen wird das Aussehen eines ScreenGui bis zu einem der folgenden Ereignisse zwischengespeichert:
- Ein Nachkomme wird hinzugefügt oder von ihm entfernt.
- Eigenschaft eines Abkömmlings ändert sich.
- Eigenschaft des ScreenGui selbst ändert sich.
Wenn eines dieser Ereignisse auftreten, wird das Erscheinungsbild ScreenGui auf dem nächsten Frame neu berechnet, der gerendert wird.
Zusammenfassung
Eigenschaften
Ob die Inhalte dieser ScreenGui in den sicheren Bereich des Geräts geschnitten werden sollen.
Steuert die Z-Index-Reihenfolge, in der mehrere ScreenGui Container gezeichnet werden.
Bestimmt, ob die ScreenGui Überschreitungen in die Reichweite der Kern-UI-Elemente von Roblox gehen.
Gibt an, ob automatische UI-Kompatibilitäts-Transformierungen auf den Nachfolger "Vollbild" GuiObjects.
Steuert die sicheren Bereichseinsätze, die auf den Inhalt des ScreenGui angewendet werden.
Schaltet die Sichtbarkeit dieses LayerCollector um.
Bestimmt, ob die LayerCollector-Reset (sich selbst löscht und wieder klont in den Charakter des Spieler:inPlayerGui ) jedes Mal erfolgt, wenn der Charakter des Spieler:inrespawniert.
Steuert, wie GuiObject.ZIndex sich auf alle Nachkommen dieser LayerCollector verhält.
Beschreibt die tatsächliche Bildschirmposition eines GuiBase2d Elements, in Pixeln.
Beschreibt die tatsächliche Bildschirm rotation eines GuiBase2d Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines GuiBase2d Elements, in Pixeln.
Wenn es auf true gesetzt wird, wird die Lokalisierung auf dieses GuiBase2d und seine Nachkommen angewendet.
Eine Referenz auf ein LocalizationTable , das verwendet werden soll, um automatisierte Lokalisierung auf dieses GuiBase2d und seine Nachkommen anzuwenden.
Passt das Spielpadauswahlverhalten in die Down-Richtung an.
Passt das Spielpadauswahlverhalten in die linke Richtung an.
Passt das Spielpadauswahlverhalten in die richtige Richtung an.
Passt das Spielpadauswahlverhalten in die Richtung oben an.
Ermöglicht die Anpassung der Gamepad-Auswahlbewegung.
Ereignisse
Ereignisse von GuiBase2d übernommen- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Auswahl des Gamepads sich auf, verlässt oder ändert innerhalb der verbundenen GuiBase2d oder eines Nachkommens GuiObjects.
Eigenschaften
ClipToDeviceSafeArea
Wenn diese Eigenschaft true ist, werden alle GuiObject Nachkommen des ScreenGui in den sicheren Bereich des Geräts geschnitten (siehe Enum.ScreenInsets ).Der Standard ist true , die Rückwärtskompatibilität der UI beizubehalten, die absichtlich offscreen gehalten wird, wie Objekte, die von einem Bildrand in den Blick rutschen, wenn sie benötigt werden.
Wenn diese Eigenschaft ist, werden Nachkommen nicht in den sicheren Bereich des Geräts geklippt und können durch die Kamera-Notch oder andere Bildschirmabschnitte verschleiert werden.
Beachten Sie, dass diese Eigenschaft ignoriert wird, wenn Sie ScreenInsets auf None setzen, da dies bedeutet, dass Sie absichtlich die sicheren Einlagen des Geräts ignorieren möchten.
DisplayOrder
Diese Eigenschaft steuert die Z-Index-Reihenfolge, in der mehrere ScreenGui Container gezeichnet werden.Diejenigen mit einem höheren DisplayOrder werden auf dem oberen Rand derjenigen mit einem niedrigeren Wert gezeichnet.
IgnoreGuiInset
Wenn diese Eigenschaft false (Standard) ist, wird ScreenInsets auf CoreUISafeInsets festgelegt, wodurch ihre Grenzen effektiv unter der Roblox-Oberfläche-UI liegen.
Wenn diese Eigenschaft auf geändert wird und derzeit auf gesetzt ist, wird auf gesetzt.
Siehe ScreenInsets für Details darüber, wie Bildschirm-Einsätze den Inhalt eines ScreenGui beeinflussen.
SafeAreaCompatibility
Diese Eigenschaft gibt an, ob automatische UI-Kompatibilitäts-Transformierungen auf den Nachfolger "Vollbild" angewendet werden, der auf Bildschirmen mit Ausschnitten angezeigt wird.Die Berechtigung besteht, wenn die Gesamtfläche des Abkömmlings GuiObject (einschließlich aller angewendeten Grenzen oder UIStroke ) die sichere Fläche des Geräts sowohl horizontal als auch vertikal abdeckt.Siehe die Enum.SafeAreaCompatibility Enum-Referenz für Details.
Der Standardwert ist FullscreenExtension , um die Darstellung von UI automatisch zu verbessern, die für Bildschirme ohne Schnitte erstellt wurde.Es wird jedoch empfohlen, vollständige Bildschirm-Erweiterungen für neue Arbeit zu vermeiden; stattdessen verwende die Eigenschaft ScreenInsets, um anzugeben, welche Einsätze für verschiedene ScreenGui Container respektiert werden sollen.
Beachten Sie, dass abstehende UI-Objekte weiterhin vom sicheren Bereich des Geräts gekappt werden, wenn ClipToDeviceSafeArea auf true gesetzt ist.
ScreenInsets
Diese Eigenschaft steuert die sicheren Bereichseinsätze, die auf den Inhalt des ScreenGui angewendet werden.
Die Standardversion von CoreUISafeInsets behält alle Nachkommen GuiObjects innerhalb des Kern-UI-Sicherheitsbereichs, frei von den Roblox-Symbolen der oberen Leiste und anderen Bildschirmabschnitten wie der Kameraöffnung des Geräts.
Wenn Sie diese Eigenschaft auf None festlegen, können UI-Objekte hinter Kern-UI-Objekten oder Geräteausschnitten wie der Kamera-Notch verschwinden.Als Ergebnis solltest du nur None für ein ScreenGui, das nichtinteraktiven Inhalt wie Hintergrundbilder enthält, verwenden.
Siehe On-Screen-UI-Container für alternative Beispiele.