ScreenGui

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

顯示在用戶屏幕上的 2D GuiObjects 的主要存儲對象。 A ScreenGui 只會顯示在玩家的

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

為了獲得性能提升,ScreenGui 的外觀會在一個以下事件發生時儲存在監視器中:

  • 有子孫添加或移除。
  • 子孫的屬性改變。
  • Class.ScreenGui 本身的屬性會改變。

如果任何一項這些事件發生,ScreenGui 外觀在它的下一個框架中重新計算。

概要

屬性

屬性 繼承自 LayerCollector屬性 繼承自 GuiBase2d

活動

活動 繼承自 GuiBase2d

屬性

ClipToDeviceSafeArea

平行讀取

如果此屬性是 true,所有 GuiObject 的後代將被切換到裝置的安全區域 (請參閱 ScreenGui ) 。預設值是 2>true2> 來維護意圖為被隱藏在線上的 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

平行讀取

此屬性控制 Z 索引順序,在多個 ScreenGuis 被畫出的順序。 ScreenGuis 使用更高的 DisplayOrder 會在上面那些具有較低值的人的上面會被畫出。

IgnoreGuiInset

未複製
平行讀取

如果此屬性是 false (預設),ScreenInsets 設為 CoreUISafeInsets,這樣就可以有效地保持它在 Roblox 最上方條狀核心 UI 下方的界限。

如果此屬性變更為 trueScreenInsets 目前設為 CoreUISafeInsets ,1> Class.ScreenGui.ScreenInsets|ScreenInsets1> 將設為 4> Class.ScreenGui.ScreenInsets

有關螢幕設定對 ScreenInsets 內容的影響,請參閱 ScreenGui 的Class.ScreenGui.ScreenInsets|ScreenInsets。

SafeAreaCompatibility

平行讀取

此屬性指定是否要對此 GuiObjects 上的顯示裝置上的「完整螢幕」ScreenGui 的後代自動使用者介面容量進行轉換。 適用性發生於

預設值是 FullscreenExtension 以便自動改善沒有任何切割的 UI 的外觀。然而,建議您避免使用全屏畫面的擴展機制;相反,您應該使用 ScreenInsets 屬性來指定哪些擴展機

注意,子孫 UI 對象將繼續被裝置的安全區域切換,如果 ClipToDeviceSafeArea 設為 true

ScreenInsets

平行讀取

此屬性控制適用於此 ScreenGui 內容的安全區域。

預設值 CoreUISafeInsets 保留所有從 GuiObjects 的所有子 EnumerateScreenInsets|CoreUISafeEnumerateScreenInsets 在核心 UI 安全區域內,清除 Roblox 上方條狀按鈕和其他屏幕切換,例如裝置的鏡頭不帶盲區。

Mobile device showing UI buttons inside core UI safe area

將此屬性設為 None 時,UI 對象可能會被核心 UI 對象或裝置切換後隱藏在畫廊不屬性上,例如鏡頭不屬性。因結果,您應該只使用 None 對於包含非交互內容的 ScreenGui ,例如背景圖像。

請參閱 螢幕使用者介面容器 以獲得更多示例。

方法

活動