ScreenGui 是用於在使用者的屏幕上顯示的2DGuiObjects儲存容器。A ScreenGui 只會顯示如果與玩家的 PlayerGui 相關;將 ScreenGui 複製到每個玩家的 StarterGui 當他們加入體驗時,他們的角色首次重生時,將確保它複製到每個玩家的 PlayerGui 中。請參閱在畫面上的使用者介面容器以獲得更多詳情。

為了提高性能,ScreenGui 的外觀會被緩存,直到下列事件之一發生:
- 子孫被添加到或從它移除。
- 子孫的屬性變更。
- ScreenGui 本身的屬性發生變化。
如果這些事件之一發生,則在下一個渲染的框架上重新計算 ScreenGui 外觀。
概要
屬性
是否要將此 ScreenGui 的內容剪貼到裝置的安全區域。
控制多個 ScreenGui 容器被繪製的 Z-index 順序。
決定是否超出 ScreenGui 到 Roblox 核心 UI 元素範圍。
指定是否應用自動的用戶介面兼容變換到子孫「全螢幕」GuiObjects上顯示時有切割畫面。
控制應用於 ScreenGui 內容的安全區插入。
切換此 LayerCollector 的可見度。
決定是否在玩家的角色重生每次時,LayerCollector 重設 (刪除自己並重新複製到玩家的角色中的 PlayerGui)。
控制如何 GuiObject.ZIndex 在這個 LayerCollector 的所有子孫上行為。
活動
活動 繼承自 GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
當遊戲控制器選擇移動到、離開或變更連接的 GuiBase2d 或任何子控制器 GuiObjects 時發生火災。
屬性
ClipToDeviceSafeArea
如果此屬性是 true ,所有 GuiObject 子孫的 ScreenGui 將被剪輯到裝置的安全區域(見 Enum.ScreenInsets)。預設是 true 來維持意圖隱藏在屏幕邊緣的 UI 的向後兼容性,例如在需要時從屏幕邊緣滑入視野的對象。
如果此屬性是 , 子孫將不會被切割到裝置的安全區域,可能會被相機切割或其他屏幕切割而遮蓋。
請注意,如果你將 ScreenInsets 設為 None,這個屬性將被忽略,因為這會暗示你故意忽略裝置的安全插入。
IgnoreGuiInset
如果此屬性是 false (預設值),ScreenInsets 將設為 CoreUISafeInsets,有效地將其邊界保持在 Roblox 頂部欄核心 UI 以下。
如果此屬性變更為 true 和 ScreenInsets 當前設置為 CoreUISafeInsets , ScreenInsets 將設為 DeviceSafeInsets 。
請參閱 ScreenInsets 有關如何屏幕插入影響 ScreenGui 內容的細節。
SafeAreaCompatibility
此屬性指定是否應用自動的用戶介面兼容變換到子「全螢幕」GuiObjects 的ScreenGui上顯示屏幕截圖。資格發生,如果子孫的總面積 GuiObject (包括任何已應用的邊界或 UIStroke)覆蓋裝置的安全區域,垂直和水平兩方面。查看 Enum.SafeAreaCompatibility 枚列參考以獲得詳情。
預設值是 FullscreenExtension 以自動改善沒有任何切割的屏幕上的 UI 外觀。然而,建議您避免為新工作使用全螢幕擴展;相反,使用 ScreenInsets 屬性來指定哪些插入應該在不同的 ScreenGui 容器中被尊重。
請注意,子孫 UI 對象將繼續被裝置的安全區域剪輯,如果 ClipToDeviceSafeArea 設為 true 。
ScreenInsets
此屬性控制應用於 ScreenGui 內容的安全區插入。
默认值 CoreUISafeInsets 將所有子孫 GuiObjects 保留在核心 UI 安全區內,清除 Roblox 頂部欄按鈕和其他屏幕切割點,例如裝置的相機孔。

如果您將此屬性設為 None,用戶介面對象可能會被核心用戶介面對象或相機槽等裝置切割背後隱藏。因結果,您只應該使用 None 來創建包含背景圖像等非互動內容的 ScreenGui 。
請參閱在畫面上的使用者介面容器以獲得替代示例。