ScreenGui
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
ScreenGui es un contenedor de almacenamiento para 2D GuiObjects que se muestra en la pantalla del usuario.Un ScreenGui solo se muestra si está patrocinado por un jugador de PlayerGui ; patrocinar a un ScreenGui a StarterGui garantiza que se clone en cada jugador de PlayerGui cuando se unan a la experiencia y su personaje se genere primero.Vea Contenedores de interfaz de usuario en la pantalla para obtener más detalles.
Para mejoras de rendimiento, la apariencia de un ScreenGui se cacha hasta que ocurra uno de los siguientes eventos:
- Se agrega o se elimina un descendiente de él.
- Una propiedad de un descendiente cambia.
- Una propiedad del propio ScreenGui cambia.
Si producirsecualquiera de estos eventos, la apariencia ScreenGui se recomputa en el siguiente marco que se renderiza.
Resumen
Propiedades
Si desea recortar el contenido de este ScreenGui a la zona segura del dispositivo.
Controla el orden del índice Z en el que se dibujan múltiples contenedores ScreenGui .
Determina si los ScreenGui superan el rango de los elementos de interfaz de usuario principales de Roblox.
Specifica si se aplican transformaciones de compatibilidad de interfaz automática a la descendencia "pantalla completa" GuiObjects.
Controla los inserciones de área segura que se aplican al contenido del ScreenGui .
Alterna la visibilidad de este LayerCollector .
Determina si los LayerCollector reinicios (se elimina a sí mismo y se reclona en el personaje del jugador PlayerGui) cada vez que el personaje del jugador reaparece.
Controla cómo GuiObject.ZIndex se comporta en todos los descendientes de este LayerCollector .
Describe la posición actual de la pantalla de un elemento GuiBase2d , en píxeles.
Describe la rotación de la pantalla actual de un elemento GuiBase2d en grados.
Describe el tamaño de la pantalla actual de un elemento GuiBase2d , en píxeles.
Cuando se establece en true, la localización se aplicará a este GuiBase2d y a sus descendientes.
Una referencia a un LocalizationTable para usar para aplicar localización automatizada a este GuiBase2d y sus descendientes.
Personaliza el comportamiento de selección del gamepad en la dirección de abajo.
Personaliza el comportamiento de selección del gamepad en la dirección izquierda.
Personaliza el comportamiento de selección del gamepad en la dirección correcta.
Personaliza el comportamiento de selección del gamepad en la dirección de arriba.
Permite la personalización del movimiento de selección del gamepad.
Eventos
Eventos heredados de GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se enciende cuando la selección del gamepad se mueve a, deja o cambia dentro del conectado GuiBase2d o cualquier descendiente GuiObjects .
Propiedades
ClipToDeviceSafeArea
Si esta propiedad es true , todos los descendientes GuiObject de la ScreenGui se recortarán a la zona segura del dispositivo (ver Enum.ScreenInsets ).El predeterminado es true para mantener la compatibilidad hacia atrás de la interfaz de usuario que se oculta intencionalmente fuera de la pantalla, como objetos que deslizan en la vista desde el borde de la pantalla cuando se necesitan.
Si esta propiedad es , los descendientes no se recortarán al área segura del dispositivo y pueden ser ocultados por la ranura de la cámara o otros recortes de pantalla.
Tenga en cuenta que esta propiedad se ignorará si configura ScreenInsets a None , ya que hacerlo implica que usted desea ignorar intencionalmente las inserciones seguras del dispositivo.
DisplayOrder
Esta propiedad controla el orden de Z-index en el que se dibujan múltiples contenedores ScreenGui .Aquellos con un valor más alto DisplayOrder serán dibujados por encima de aquellos con un valor más bajo.
IgnoreGuiInset
Si esta propiedad es false (predeterminada), ScreenInsets se establece en CoreUISafeInsets , efectivamente manteniendo sus límites por debajo de la interfaz de usuario principal de Roblox.
Si esta propiedad se cambia a true y ScreenInsets está actualmente establecida en CoreUISafeInsets , ScreenInsets se establecerá en DeviceSafeInsets .
Vea ScreenInsets para detalles sobre cómo las inserciones de pantalla afectan el contenido de un ScreenGui .
SafeAreaCompatibility
Esta propiedad especifica si se aplican transformaciones de compatibilidad de interfaz de usuario automática a la descendencia "pantalla completa" GuiObjects de la ScreenGui en pantallas con recortes de pantalla.La elegibilidad ocurre si el área total del descendiente GuiObject (incluyendo cualquier borde aplicado o UIStroke ) cubre la zona segura del dispositivo tanto horizontal como verticalmente.Vea la referencia de enumeración Enum.SafeAreaCompatibility para detalles.
El valor predeterminado es FullscreenExtension para mejorar automáticamente la apariencia de la interfaz que fue autorizada para pantallas sin recortes.Sin embargo, se recomienda que evites las extensiones de pantalla completa para el nuevo trabajo; en cambio, utiliza la propiedad ScreenInsets para especificar qué inserciones deben respetarse para diferentes contenedores ScreenGui.
Tenga en cuenta que los objetos de interfaz de usuario descendientes continuarán siendo recortados por la zona segura del dispositivo si ClipToDeviceSafeArea está configurado como true .
ScreenInsets
Esta propiedad controla las inserciones de área segura que se aplican al contenido del ScreenGui .
El predeterminado de CoreUISafeInsets mantiene todos los descendientes GuiObjects dentro de la zona segura de la interfaz de usuario principal, limpia de los botones de la barra superior de Roblox y otros recortes de pantalla como la ranura de la cámara del dispositivo.
Si estableces esta propiedad a None, los objetos de la interfaz de usuario pueden ser ocultados detrás de objetos de interfaz de usuario del núcleo o recortes de dispositivos como la ranura de la cámara.Como resultado, solo debe usar None para un ScreenGui que contenga contenido no interactivo como imágenes de fondo.
Vea Contenedores de IU en la pantalla para ejemplos alternativos.