ScreenGui
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
L'oggetto di archiviazione principale per 2D GuiObjects visualizzato sullo schermo dell'utente. Un ScreenGui mostra solo se è parented
Per le migliorazioni delle prestazioni, l'aspetto di un ScreenGui è memorizzato fino a quando uno dei seguenti eventi non si verifica:
- Un discendente viene aggiunto o rimosso da esso.
- Una proprietà di un discendente cambia.
- Una proprietà del ScreenGui stesso cambia.
Se uno qualsiasi di questi eventi si Si verificano, l'aspetto ScreenGui viene ricalcolato sul prossimo frame in cui viene visualizzato.
Sommario
Proprietà
Se clippare i contenuti di questo ScreenGui all'area di sicurezza del Dispositivo.
Controlla l'ordine Z-index in cui vengono disegnati più ScreenGuis .
Determina se questo ScreenGui si sovrappone agli elementi UI del core di Roblox.
Specifica se le trasformazioni automatiche della compatibilità UI vengono applicate ai discendenti "Tutto Schermo/Schermo Intero" GuiObjects sui dispositivi con tagliatasche.
Controlla le impostazioni dell'area di sicurezza applicate ai contenuti di questo ScreenGui .
Attiva/disattiva la visibilità di questo LayerCollector .
Determina se il LayerCollector resets (deletes itself and re-clones into the Giocatore's PlayerGui ) ogni volta che il personaggio del Giocatorerespawna.
Controlla il modo in cui GuiObject.ZIndex si comporta su tutti i discendenti di questo LayerCollector .
Descrive la posizione reale dello schermo di un elemento UI, in pixel.
Descrive la rotazione dell'interfaccia utente reale, in gradi.
Descrive la dimensione reale dello schermo di un elemento UI, in pixel.
Quando impostato su true, la localizzazione sarà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable per essere utilizzato per applicare la localizzazione automatica a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento della selezione del gamepad nella direzione in cui si muove verso il basso.
Personalizza il comportamento di selezione del gamepad nella direzione di sinistra.
Personalizza il comportamento della selezione del gamepad nella direzione giusta.
Personalizza il comportamento della selezione del gamepad nell'area di direzione up.
Consente la personalizzazione della selezione del gamepad.
Metodi
Eventi
Eventi provenienti da GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si attiva quando la selezione del gamepad si muove, si lascia o cambia all'interno della GuiBase2d connessa o di qualsiasi altro GuiObjects.
Proprietà
ClipToDeviceSafeArea
Se questa proprietà è true, tutti i discendenti di questo GuiObject saranno tagliati alla zona di sicurezza del Dispositivo(vedi ScreenGui ) . Il valore predefinito è 2>true2> per mantenere la compatibilità con l'antico UI che è intenzionalmente nascosto offline, come gli
Se questa proprietà è false , GuiObject discendenti non saranno tagliati nella zona di sicurezza del Dispositivoe potrebbero essere oscurati dalla camera notch o altri tagli di schermo.
Nota che questa proprietà sarà ignorata se impostate ScreenGui.ScreenInsets a None, poiché ciò implica che volete intenzionalmente ignorare gli insetti di sicurezza del Dispositivo.
DisplayOrder
Questa proprietà controlla l'ordine Z-index in cui più ScreenGuis vengono disegnati. ScreenGuis con un ordine di DisplayOrder più elevato sarà disegnato sopra quelli con un valore inferiore.
IgnoreGuiInset
Se questa proprietà è false (predefinito), ScreenInsets è impostato su CoreUISafeInsets , effettivamente mantenendo i suoi limiti sotto la barra superiore del Roblox.
Se questa proprietà è cambiata in true e ScreenInsets è attualmente impostata su CoreUISafeInsets, 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> sarà impostata su 4> Class.ScreenGui.ScreenInsets|Device
Vedi ScreenInsets per i dettagli su come gli inserimenti di schermo influenzano i contenuti di un ScreenGui .
SafeAreaCompatibility
Questa proprietà specifica se le trasformazioni automatiche della UI vengono applicate al discendente "Tutto Schermo/Schermo Intero" GuiObjects di questo ScreenGui su Dispositivocon tagli orizzontali. L'ammissibilità si verifica se l'area tot
Il valore predefinito è FullscreenExtension per migliorare automaticamente l'aspetto dell'interfaccia utente che è stato autoreggiato per gli schermi senza alcuna cutout. Tuttavia, è consigliato evitare le estensioni fullscreen per il nuovo lavoro; invece, usa la proprietà Class.ScreenGui.ScreenInsets|ScreenInsets
Nota che gli oggetti UI discendenti continueranno ad essere tagliati dalla zona sicura del Dispositivose ClipToDeviceSafeArea è impostato su true .
ScreenInsets
Questa proprietà controlla le impostazioni dell'area di sicurezza applicate ai contenuti di questo ScreenGui .
Il valore predefinito di CoreUISafeInsets mantiene tutti i discendenti GuiObjects all'interno dell'area di sicurezza UI core, pulendo dai pulsanti della barra superiore Roblox e da altri tagli di schermo come la notch della fotocamera del Dispositivo.
Se impostate questa proprietà su None, gli oggetti UI potrebbero essere oscuri dietro gli oggetti UI core o le cutout del dispositivo come la notch della fotocamera. Di Risultato, dovreste utilizzare solo None per un ScreenGui che contiene contenuti non interattabili come le immagini di sottofondo.
Vedi Container UI on-screen per esempi alternativi.