ScreenGui

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

显示在用户屏幕上的 2D GuiObjects 的主要存储对象。一个 ScreenGui 只会显示在玩家的 Class

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

为了提高性能,ScreenGui 的外观在一个以下事件发生时被缓存:

  • 子女是添加到或从其添加。
  • 子代的属性发生了变更。
  • Class.ScreenGui 本身的属性变更。

如果发生任何一个此事件,ScreenGui 外观在它渲染的下一个框架上重新计算。

概要

属性

继承自LayerCollector属性继承自GuiBase2d属性

活动

继承自GuiBase2d活动

属性

ClipToDeviceSafeArea

读取并联

如果此属性是 true ,那么所有 GuiObject 子集都会被切换到设备的安全区域 (见 ScreenGui ) 。默认值是 1> true1> 来保持意图上隐藏在屏幕边缘的 UI 的兼容性,例

Mobile device showing UI button clipped by device safe
area

如果此属性是 falseGuiObject 子代将不会被剪到设备的安全区域,可能被相机的位置或其他屏幕切割出的屏幕部分遮蔽。

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

注意,如果您将 ScreenGui.ScreenInsets 设置为 None,那么该属性将被忽略,因为这意味着您有意图地想要忽略设备的安全套件。

DisplayOrder

读取并联

此属性控制多个ScreenGuis 的绘制顺序。ScreenGuis 用更高的DisplayOrder 将在最上方绘制在最低值的下方。

IgnoreGuiInset

未复制
读取并联

如果此属性是 false (默认),ScreenInsets 设置为 CoreUISafeInsets,有效地将其边界设置在 Roblox 顶部栏中。

如果此属性改为 trueScreenInsets 当前设置为 CoreUISafeInsets ,1> Class.ScreenGui.ScreenInsets|ScreenInsets1> 将设置为 4> Class.ScreenGui.ScreenInsets|DeviceSafeIn

有关ScreenInsets的细节,请参阅ScreenGui

SafeAreaCompatibility

读取并联

此属性指定是否应用自动界面兼容变形到此 ScreenGui 上的设备示器上的屏幕切割 GuiObject 的安全区域。如果 1> Class.UIStroke1> (包

默认值是 FullscreenExtension 以便自动改善屏幕无任何切割的 UI 的外观。但是,建议您避免全屏扩展,而是使用 ScreenInsets 属性来指定哪些在设置中应该被尊重。相反,您可以使用 Class.ScreenGui|Screen

注意,子对象 UI 对象将继续被设备的安全区域切换到 ClipToDeviceSafeArea 如果 true 设置为 true 。

ScreenInsets

读取并联

这个属性控制应用于此 ScreenGui 内容的保险区域。

默认值 CoreUISafeInsets 保留所有后裔 GuiObjects 在核心 UI 安全区域内,清除 Roblox 顶部栏按钮和其他屏幕切换,例如设备的相机不同。

Mobile device showing UI buttons inside core UI safe area

如果您将此属性设置为 None,UI 对象可能会被核心 UI 对象或设备切割如相机不孔。因结果,您应该仅使用 None 对于包含非交互内容的 ScreenGui 。例如,您不应该使用 1> Class.ScreenGui1> 来包含背景图像的 UI 对象。

请参阅屏幕上的用户界面容器获取替代示例。

方法

活动