ScreenGui

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Główny obiekt przechowywania dla 2D GuiObjects wyświetlony na ekranie użytkownika. A ScreenGui t

Example ScreenGui with various GuiObject children, including a Frame, TextLabel, TextBox, and ImageButton.

Dla poprawy wydajności ScreenGui jest zapamiętywany do czasu pojścia jednego z następujących wydarzeń:

  • Dodany jest lub usunięty z niego potomstwo.
  • Właściwość odeszłego potomka się zmienia.
  • Własność Class.ScreenGui sama się zmienia.

Jeśli jeden z tych wydarzeń się występować, wygląd ScreenGui jest odliczany na następnym klatce, która jest renderowana.

Podsumowanie

Właściwości

Właściwości odziedziczeni z: LayerCollectorWłaściwości odziedziczeni z: GuiBase2d

Zdarzenia

Zdarzenia odziedziczeni z: GuiBase2d

Właściwości

ClipToDeviceSafeArea

Odczyt równoległy

Jeśli właściwość jest true, wszystkie potomstwa GuiObject z tej właściwości ScreenGui zostaną skrócone do bezpiecznej obszaru urządzenie(patrz 2>枚.ScreenInsets2>). Domyślnie jest 5>true5>, ab

Mobile device showing UI button clipped by device safe
area

Jeśli właściwość jest false , GuiObject potomstwa będą nie przycięte do obszaru bezpieczeństwa urządzeniei mogą być zaciemnione przez kamerę lub inne obszary ekranu.

Mobile device showing UI button overflowing device safe
area, obscured by screen camera notch

Uwaga, że ta właściwość zostanie ignorowana, jeśli ustawisz ScreenGui.ScreenInsets na None, ponieważ takie działanie oznacza, że intencjonalnie chcesz ignorować zestawy bezpieczeństwa urządzenie.

DisplayOrder

Odczyt równoległy

To właściwość kontroluje porządek Z-INDEX, w którym wiele ScreenGuis jest rysowanych. ScreenGuis z wyższym DisplayOrder będzie rysowane na górze tych z niższą wartością.

IgnoreGuiInset

Bez replikacji
Odczyt równoległy

Jeśli właściwość jest false (domyślnie), ScreenInsets ustawiony na CoreUISafeInsets , skutecznie utrzymuje jej granice poniżej głównej górnej krawędzi gniazda Roblox.

Jeśli ta właściwość jest zmieniona na true i ScreenInsets jest obecnie ustawione na CoreUISafeInsets , 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> zostanie ustawione na 4> Enum.ScreenIn

Zobacz ScreenInsets dla szczegółów jak screeny wpływają na treści ScreenGui .

SafeAreaCompatibility

Odczyt równoległy

Właściwość ta określa, czy automatyczne transformacje kompatybilności z pełny ekranurządzeniesą stosowane do potomnego "pełnokomputerowego" GuiObjects tego ScreenGui

Domyślną wartością jest FullscreenExtension , aby automatycznie poprawić wygląd UI, która została autorstwa bez żadnych cięć. Jest jednak rekomendowane, aby uniknąć wszystkich wtyczek w pełnym ekranie; zamiast tego użyj właściwości Class.ScreenGui.ScreenIn

Uwaga: obiekty interfejsu potomnego nadal będą przycięte przez bezpieczną obszar urządzenie, jeśli ClipToDeviceSafeArea ustawiony na true.

ScreenInsets

Odczyt równoległy

To właściwość kontroluje zestawy bezpieczeństwa, które są stosowane do treści tego ScreenGui .

Domyślny wynik CoreUISafeInsets utrzymuje wszystkie potomstwa GuiObjects w obszarze bezpieczeństwa UI głównego, wolny od przycisków na górnej barze Roblox i innych krodek ekranowych, takich jak kąt aparatu urządzenie.

Mobile device showing UI buttons inside core UI safe area

Jeśli ustawisz tę właściwość na None, obiekty UI mogą być zaciemnione za podstawowe obiekty UI lub urządzenia wieńcowe, takie jak kamera notch. W wynikpowinieneś używać tylko None dla ScreenGui, który zawiera nieskomunikowaną treść, taką jak obrazy tła.

Zobacz Container na interfejs użytkownika na ekranie dla przykładów alternatywnych.

Metody

Zdarzenia