ScreenGui 是用户屏幕上显示的 2D GuiObjects 的存储容器。A ScreenGui 仅显示如果与玩家的 PlayerGui 关联；将 ScreenGui 关联到 StarterGui 将确保它在他们加入体验时克隆到每个玩家的 PlayerGui 当他们的角色首次生成。请参阅屏幕上的用户界面容器以获取更多详情。
为了性能提升，ScreenGui 的外观将被缓存，直到以下事件之一发生：
- 后裔被添加到或从它移除。
- 子孙的属性发生了变化。
- ScreenGui 自身的属性发生了变化。
如果这些事件之一发生，那么在下一帧渲染时，ScreenGui 的外观将重新计算在下一帧渲染时。
概要
属性
是否要将此 ScreenGui 的内容剪切到设备的安全区域。
控制多个 ScreenGui 容器被绘制的 Z-索引顺序。
决定是否 ScreenGui 溢出到 Roblox 核心 UI 元素范围。
指定是否应用自动 UI 兼容转换到子“全屏” GuiObjects 在显示具有屏幕切割的设备上。
控制应用于 ScreenGui 内容的安全区插入。
属性
切换这个 LayerCollector 的可见性。
决定是否重置 LayerCollector (删除自己并重新克隆到玩家角色的 PlayerGui )每次玩家角色重生。
控制 GuiObject.ZIndex 如何在这个 LayerCollector 的所有子孙上行为。
属性
活动
继承自GuiBase2d的活动活动
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
当游戏手柄选择移动到、离开或在连接的 或任何子手柄中更改时，发生火焰。
属性
ClipToDeviceSafeArea
如果此属性是 ，所有 子孙都会被剪切到设备的安全区域（见 ）。默认值是 true 以保持向后兼容的用户界面，例如在需要时从屏幕边缘滑入视图的对象。
如果此属性是 , 子孙将不会被切割到设备的安全区域，可能被相机的凹陷或其他屏幕切割所隐藏。
请注意，如果你将 ScreenInsets 设置为 None ,那么设置将被忽略，因为这会暗示你故意忽略设备的安全插入。
IgnoreGuiInset
如果此属性是 false (默认)，那么 ScreenInsets 将设置为 CoreUISafeInsets，有效地将其边界控制在 Roblox 顶部栏核心 UI 以下。
如果此属性更改为 true 和 ScreenInsets 当前设置为 CoreUISafeInsets ，那么 ScreenInsets 将设置为 DeviceSafeInsets 。
请参阅ScreenInsets了解屏幕插入如何影响ScreenGui的内容。
SafeAreaCompatibility
此属性指定是否应用自动用户界面兼容转换到子“全屏” 的显示，其上有屏幕切割。条件适用于如果后裔的总面积 GuiObject (包括任何应用的边界或 UIStroke ) 覆盖了设备的安全区域，既垂直又水平。查看 Enum.SafeAreaCompatibility 枚列参考以获取详细信息。
默认值为 FullscreenExtension 以自动提高没有任何截断的 UI 的外观。然而，建议您避免为新工作添加全屏扩展；相反，使用 ScreenInsets 属性指定哪些插入应受到不同 ScreenGui 容器的尊重。
请注意，子孙 UI 对象仍将被设备的安全区域剪切，如果 ClipToDeviceSafeArea 设置为 true 。
ScreenInsets
该属性控制应用于 ScreenGui 内容的安全区插入。
默认值 CoreUISafeInsets 将所有子孙 GuiObjects 保留在核心 UI 安全区内，清除 Roblox 顶部栏按钮和设备相机窗口等其他屏幕切割部分。
如果您将此属性设置为 None，用户界面对象可能会被核心用户界面对象或像相机槽一样的设备切割背后遮蔽。因结果，您只应该使用 None 为包含背景图像等非互动内容的 ScreenGui。
请参阅屏幕上的 UI 容器获取替代示例。