ScreenGui
*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.
ScreenGui jest kontenerem magazynowym dla 2D GuiObjects wyświetlanym na ekranie użytkownika.A ScreenGui pokazuje się tylko, jeśli jest powiązany z graczem PlayerGui ; powiązanie ScreenGui z StarterGui gwarantuje, że zostanie sklonowany do każdego gracza PlayerGui, gdy dołączą do doświadczenia i ich postać pojawi się po raz pierwszy.Zobacz Pojemniki UI na ekranie dla dalszych szczegółów.
Aby poprawić wydajność, wygląd ScreenGui jest przechowywany do czasu wystąpienia jednego z następujących wydarzeń:
- Potomek jest dodany do niego lub usunięty.
- Właściwość potomka zmienia się.
- Właściwość własna ScreenGui sama zmienia się.
Jeśli którekolwiek z tych wydarzeń występować, wygląd ScreenGui zostanie ponownie obliczony na następnym ramie, który zostanie wyrenderowany.
Podsumowanie
Właściwości
Czy chcesz przeciąć zawartość tego ScreenGui do bezpiecznej strefy urządzenie.
Kontroluje kolejność indeksu Z, w której rysowane są wielokrotnie ScreenGui kontenery.
Określa, czy ScreenGui przekracza zakres głównych elementów interfejsu użytkownika Roblox.
Określa, czy zostaną zastosowane automatyczne transformacje kompatybilności interfejsu do potomnego "pełnoekranowego" GuiObjects na wyświetlaczach z przecięciami ekranu.
Kontroluje wstawki bezpiecznej strefy, które są stosowane do zawartości ScreenGui.
Przełącza widoczność tego LayerCollector .
Określa, czy odnowienia LayerCollector (samodzielnie się resetuje i klonuje do postaci gracza PlayerGui) następują za każdym razem, gdy postać gracza się odrodzi.
Kontroluje, jak GuiObject.ZIndex zachowuje się na wszystkich potomkach tego LayerCollector .
Opisuje rzeczywistą pozycję ekranu elementu GuiBase2d w pikselach.
Opisuje rzeczywitą rotację ekranu elementu GuiBase2d w stopniach.
Opisuje rzeczywistą rozdzielczość ekranu elementu GuiBase2d w pikselach.
Gdy ustawiono na true, lokalizacja zostanie zastosowana do tego GuiBase2d i jego potomków.
Odwołanie do LocalizationTable , które ma być użyte do zastosowania automatyzowanej lokalizacji do tego GuiBase2d i jego potomków.
Dostosowuje zachowanie wyboru pada w dół w grze.
Dostosowuje zachowanie wyboru gamepada w lewo.
Dostosowuje zachowanie wyboru gamepada w prawnym kierunku.
Dostosowuje zachowanie wyboru gamepada w kierunku góry.
Umożliwia dostosowanie ruchu wyboru gamepada.
Zdarzenia
Zdarzenia odziedziczeni z: GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Wybucha, gdy wybór gamepada przenosi się do, opuszcza lub zmienia w ramach połączonego GuiBase2d lub dowolnego potomka GuiObjects.
Właściwości
ClipToDeviceSafeArea
Jeśli ta właściwość jest true, wszystkie GuiObject potomkowie z ScreenGui zostaną obcięte do bezpiecznej strefy urządzenie(patrz Enum.ScreenInsets ).Domyślną wartością jest true utrzymanie kompatybilności wstecznej interfejsu, który jest celowo ukryty poza ekranem, tak jak obiekty, które przesuwają się do widoku z krawędzi ekranu, gdy są potrzebne.
Jeśli ta właściwość jest , potomkowie nie zostaną obcięte do bezpiecznej strefy urządzeniei mogą być zasłonięte przez notkę kamery lub inne przecięcia ekranu.
Zauważ, że ta właściwość zostanie zignorowana, jeśli ustawisz ScreenInsets na None, ponieważ oznacza to, że celowo chcesz zignorować bezpieczne wstawki urządzenie.
DisplayOrder
Właściwość ta kontroluje kolejność indeksu Z, w której rysowane są wielokrotnie ScreenGui kontenery.Ci z wyższą wartością DisplayOrder będą rysowani na górze tych z niższą wartością.
IgnoreGuiInset
Jeśli ta właściwość jest false (domyślna), ScreenInsets jest ustawiona na CoreUISafeInsets , skutecznie utrzymując jej granice poniżej głównego interfejsu UI Roblox.
Jeśli ta właściwość zostanie zmieniona na true i ScreenInsets jest obecnie ustawiona na CoreUISafeInsets , ScreenInsets zostanie ustawiona na DeviceSafeInsets .
Zobacz ScreenInsets szczegóły na temat tego, jak wstawki ekranu wpływają na zawartość ScreenGui .
SafeAreaCompatibility
Właściwość ta określa, czy zostaną zastosowane automatyczne transformacje kompatybilności interfejsu do potomnego "pełnoekranowego" z ekranami z przecięciami ekranu.Kwalifikacja występuje, jeśli całkowita powierzchnia potomka GuiObject (w tym wszelkie zastosowane granice lub UIStroke ) pokrywa bezpieczną strefę urządzeniezarówno poziomo, jak i pionowo.Zobacz odniesienie Enum.SafeAreaCompatibility enum dla szczegółów.
Domyślną wartością jest FullscreenExtension w celu automatycznego poprawienia wyglądu interfejsu, który został sporządzony bez żadnych cięć.Zaleca się jednak unikanie rozszerzeń pełnoekranowych dla nowej pracy; zamiast tego użyj właściwości ScreenInsets, aby określić, które wstawki powinny być respektowane dla różnych ScreenGui pojemników.
Zauważ, że obiekty interfejsu użytkownika potomnego będą nadal przycinane przez bezpieczną strefę urządzenie, jeśli ClipToDeviceSafeArea jest ustawione na true .
ScreenInsets
Właściwość ta kontroluje wstawki bezpiecznej strefy, które są stosowane do zawartości ScreenGui.
Domyślnie CoreUISafeInsets zachowuje wszystkie potomki GuiObjects wewnątrz bezpiecznej strefy interfejsu użytkownika, wolnej od przycisków paska górnego Roblox i innych przecięć ekranu, takich jak notka kamery urządzenie.
Jeśli ustawisz tę właściwość na None, obiekty interfejsu użytkownika mogą być zasłonięte za pomocą podstawowych obiektów interfejsu użytkownika lub przecięć urządzeń, takich jak notka kamery.W wynikpowinieneś używać tylko None dla ScreenGui, który zawiera nieinteraktywną treść, taką jak obrazy tła.
Zobacz Pojemniki interfejsu użytkownika na ekranie dla alternatywnych przykładów.