ScreenGui
*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.

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à
Se clonare i contenuti di questo ScreenGui alla zona sicura del Dispositivo.
Controlla l'ordine dell'indice Z in cui vengono disegnati più container ScreenGui .
Determina se gli ScreenGui superano il limite della gamma degli elementi UI principali di Roblox.
Specifica se le trasformazioni automatiche di compatibilità dell'interfaccia utente sono applicate al discendente "Tutto Schermo/Schermo Intero" su display con ritagli di schermo.
Controlla gli inserimenti nell'area sicura che vengono applicati ai contenuti del ScreenGui .
Attiva/disattiva la visibilità di questo LayerCollector .
Determina se le LayerCollector resets (si auto-elimina e si replica nel personaggio del giocatore PlayerGui ) ogni volta che il personaggio del Giocatorerespawna.
Controlla come GuiObject.ZIndex si comporta su tutti i discendenti di questo LayerCollector .
Descrive la posizione effettiva dello schermo di un elemento GuiBase2d in pixel.
Descrive la rotazione effettiva dello schermo di un elemento GuiBase2d in gradi.
Descrive la dimensione effettiva dello schermo di un elemento GuiBase2d , in pixel.
Quando è impostato su true , la localizzazione verrà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable da utilizzare per applicare la localizzazione automatizzata a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento di selezione del gamepad nella direzione down.
Personalizza il comportamento di selezione del gamepad nella direzione sinistra.
Personalizza il comportamento di selezione del gamepad nella direzione giusta.
Personalizza il comportamento di selezione del gamepad nella direzione up.
Consente la personalizzazione del movimento di selezione del gamepad.
Metodi
Eventi
Eventi provenienti da GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si accende quando la selezione del gamepad si sposta, lascia o cambia all'interno del connesso GuiBase2d o di qualsiasi discendente GuiObjects .
Proprietà
ClipToDeviceSafeArea
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.
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.
Nota che questa proprietà verrà ignorata se imposti ScreenInsets a None , poiché ciò implica che vuoi intenzionalmente ignorare gli inserimenti sicuri del Dispositivo.
DisplayOrder
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
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
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
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.

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.