ScreenGui

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

El objeto de almacenamiento principal para 2D GuiObjects mostrado en la pantalla del usuario. Un ScreenGui solo muestra si está vincul

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

Para mejoras de rendimiento, la apariencia de un ScreenGui está guardada 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 de la ScreenGui en sí misma cambia.

Si producirsecualquiera de estos eventos, la apariencia de ScreenGui se recompila en el marco siguiente en que se renderiza.

Resumen

Propiedades

Propiedades heredados de LayerCollectorPropiedades heredados de GuiBase2d

Eventos

Eventos heredados de GuiBase2d

Propiedades

ClipToDeviceSafeArea

Leer paralelo

Si esta propiedad es true , todos los descendientes de este GuiObject se cortarán a la zona segura del dispositivo (ver Class.GuiObj

Mobile device showing UI button clipped by device safe
area

Si esta propiedad es false , los descendientes de GuiObject no se cortarán a la zona segura del dispositivo y pueden ser ocultos por el píxel de cámara o otras salidas de pantalla.

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

Tenga en cuenta que esta propiedad se ignorará si establece ScreenGui.ScreenInsets a None, ya que esto implica que tiene la intención de desregistrar los inicios de sesión seguros del dispositivo.

DisplayOrder

Leer paralelo

Esta propiedad controla el orden en el que se dibujan varios ScreenGuis con un valor más alto. ScreenGuis con un valor más bajo se dibujará en la parte superior de los que tienen un valor más bajo.

IgnoreGuiInset

No replicado
Leer paralelo

Si esta propiedad es false (por defecto), ScreenInsets está configurado como Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.Enmarca.En

Si esta propiedad se cambia a true y ScreenInsets está actualmente configurado como CoreUISafeInsets , 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> se configurará como 4> Class.ScreenGui.ScreenInsets|DeviceSafe

Vea ScreenInsets para obtener más información sobre cómo los inserciones de pantalla afectan el contenido de un ScreenGui .

SafeAreaCompatibility

Leer paralelo

Esta propiedad especifica si las transformaciones de compatibilidad de la interfaz de dispositivoautomática se aplican a la descendencia "pantalla completa" GuiObjects de este ScreenGui en pantallas con cortes de pantalla. La elegibilidad ocurre si

El valor predeterminado es FullscreenExtension para mejorar automáticamente la apariencia de la interfaz de usuario que fue autora para pantallas sin cortes. Sin embargo, se recomienda que evite las extensiones de pantalla para el nuevo trabajo; en cambio, use la propiedad ScreenInsets para especificar qué insets

Nota que los objetos de la interfaz de usuario descendente continuarán siendo cortados por la zona segura del dispositivo si se establece que ClipToDeviceSafeArea está configurado como true .

ScreenInsets

Leer paralelo

Esta propiedad controla las inyecciones de área segura que se aplican a los contenidos de este ScreenGui .

La configuración predeterminada de CoreUISafeInsets mantiene todos los descendientes de GuiObjects dentro de la zona segura de la interfaz de usuario del núcleo, alejados de los botones de la barra superior de Roblox y otros cortes de pantalla como el nivel de cámara del dispositivo.

Mobile device showing UI buttons inside core UI safe area

Si establece esta propiedad en None , los objetos de la interfaz de usuario pueden estar ocultos detrás de los objetos de la interfaz de usuario de núcleo o cortes de dispositivo como la cámara noch. Como resultado, solo debe usar None para un ScreenGui que contiene contenido no interactivo como imágenes de fondo.

Vea Contenedores de IU de pantalla para obtener ejemplos alternativos.

Métodos

Eventos