ScreenGui

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

ScreenGui è un contenitore di storage per 2D GuiObjects visualizzato sullo schermo dell'utente.A ScreenGui mostra solo se è parented a un Giocatoredi PlayerGui ; il parenting di un ScreenGui a StarterGui garantisce che si clona in ciascun Giocatoredi PlayerGui quando si uniscono all'esperienza e il loro personaggio viene generato per primo.Vedi Contenitori dell'interfaccia utente sullo schermo per ulteriori dettagli.

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

Per miglioramenti delle prestazioni, l'aspetto di un ScreenGui viene memorizzato fino a quando non si verifica uno dei seguenti eventi:

  • Un discendente viene aggiunto o rimosso da esso.
  • Una proprietà di un discendente cambia.
  • Una proprietà del ScreenGui stesso cambia.

Se uno di questi eventi si Si verificano, l'aspetto ScreenGui appare sul prossimo frame che viene visualizzato.

Sommario

Proprietà

Proprietà provenienti da LayerCollectorProprietà provenienti da GuiBase2d

Eventi

Eventi provenienti da GuiBase2d

Proprietà

ClipToDeviceSafeArea

Lettura Parallela

Se questa proprietà è true , tutti i GuiObject discendenti del ScreenGui saranno clippati nell'area sicura del Dispositivo(vedi Enum.ScreenInsets ).Il predefinito è true per mantenere la compatibilità con le versioni precedenti dell'interfaccia utente che è intenzionalmente nascosta sullo schermo, come oggetti che scivolano in vista da un bordo dello schermo quando sono necessari.

Mobile device showing UI button clipped by device safe
area

Se questa proprietà è false , GuiObject i discendenti non saranno tagliati nell'area sicura del Dispositivoe potrebbero essere oscurati dalla nota della fotocamera o da altri tagli di schermo.

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

Nota che questa proprietà verrà ignorata se imposti ScreenInsets a None , poiché ciò implica che vuoi intenzionalmente ignorare gli inserimenti sicuri del Dispositivo.

DisplayOrder

Lettura Parallela

Questa proprietà controlla l'ordine Z-index in cui vengono disegnati più container ScreenGui .Quelli con un valore più alto DisplayOrder saranno disegnati sopra quelli con un valore più basso.

IgnoreGuiInset

Non Replicato
Lettura Parallela

Se questa proprietà è false (predefinita), ScreenInsets è impostata su CoreUISafeInsets , mantenendo effettivamente i suoi confini al di sotto dell'interfaccia utente principale di Roblox.

Se questa proprietà viene cambiata in true e ScreenInsets è attualmente impostata su CoreUISafeInsets , ScreenInsets sarà impostata su DeviceSafeInsets .

Vedi ScreenInsets per i dettagli su come gli inserimenti di schermo influenzino i contenuti di un ScreenGui .

SafeAreaCompatibility

Lettura Parallela

Questa proprietà specifica se le trasformazioni automatiche di compatibilità dell'interfaccia utente sono applicate al discendente "Tutto Schermo/Schermo Intero" GuiObjects del ScreenGui su display con tagli di schermo.L'ammissibilità si verifica se l'area totale del discendente GuiObject (inclusa qualsiasi bordo applicato o UIStroke ) copre l'area sicura del Dispositivosia orizzontalmente che verticalmente.Vedi il riferimento all'enum Enum.SafeAreaCompatibility per i dettagli.

Il valore predefinito è FullscreenExtension per migliorare automaticamente l'aspetto dell'interfaccia utente che è stato redatto per schermi senza alcuna interruzione.Tuttavia, si consiglia di evitare le estensioni a schermo pieno per il nuovo lavoro; invece, usa la proprietà ScreenInsets per specificare quali inserzioni dovrebbero essere rispettate per diversi contenitori ScreenGui.

Nota che gli oggetti UI discendenti continueranno ad essere clippati dall'area sicura del Dispositivose ClipToDeviceSafeArea è impostato su true .

ScreenInsets

Lettura Parallela

Questa proprietà controlla gli inserimenti nell'area sicura che vengono applicati ai contenuti del ScreenGui .

Il predefinito di CoreUISafeInsets mantiene tutti i discendenti GuiObjects all'interno dell'area sicura dell'interfaccia utente principale, libera dai pulsanti della barra superiore di Roblox e da altre interruzioni dello schermo come il notch della fotocamera del Dispositivo.

Mobile device showing UI buttons inside core UI safe area

Se impostate questa proprietà a None, gli oggetti dell'interfaccia utente possono essere oscurati dietro gli oggetti dell'interfaccia utente principale o le interruzioni del dispositivo come il nottolino della fotocamera.Di Risultato, dovresti utilizzare solo None per un ScreenGui che contiene contenuti non interattivi come immagini di sfondo.

Vedi Contenitori dell'interfaccia utente sullo schermo per esempi alternativi.

Metodi

Eventi