ScreenGui

顯示已棄用項目

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

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

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

為了提高性能,ScreenGui 的外觀會被緩存,直到下列事件之一發生:

  • 子孫被添加到或從它移除。
  • 子孫的屬性變更。
  • ScreenGui 本身的屬性發生變化。

如果這些事件之一發生,則在下一個渲染的框架上重新計算 ScreenGui 外觀。

概要

屬性

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

活動

活動 繼承自 GuiBase2d

屬性

ClipToDeviceSafeArea

平行讀取

如果此屬性是 true ,所有 GuiObject 子孫的 ScreenGui 將被剪輯到裝置的安全區域(見 Enum.ScreenInsets)。預設是 true 來維持意圖隱藏在屏幕邊緣的 UI 的向後兼容性,例如在需要時從屏幕邊緣滑入視野的對象。

Mobile device showing UI button clipped by device safe
area

如果此屬性是 , 子孫將不會被切割到裝置的安全區域,可能會被相機切割或其他屏幕切割而遮蓋。

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

請注意,如果你將 ScreenInsets 設為 None,這個屬性將被忽略,因為這會暗示你故意忽略裝置的安全插入。

DisplayOrder

平行讀取

此屬性控制多個 ScreenGui 容器被繪製的 Z-index 順序。那些擁有更高值的 DisplayOrder 將被繪在那些擁有更低值的人之上。

IgnoreGuiInset

未複製
平行讀取

如果此屬性是 false (預設值),ScreenInsets 將設為 CoreUISafeInsets,有效地將其邊界保持在 Roblox 頂部欄核心 UI 以下。

如果此屬性變更為 trueScreenInsets 當前設置為 CoreUISafeInsetsScreenInsets 將設為 DeviceSafeInsets

請參閱 ScreenInsets 有關如何屏幕插入影響 ScreenGui 內容的細節。

SafeAreaCompatibility

平行讀取

此屬性指定是否應用自動的用戶介面兼容變換到子「全螢幕」GuiObjectsScreenGui上顯示屏幕截圖。資格發生,如果子孫的總面積 GuiObject (包括任何已應用的邊界或 UIStroke)覆蓋裝置的安全區域,垂直和水平兩方面。查看 Enum.SafeAreaCompatibility 枚列參考以獲得詳情。

預設值是 FullscreenExtension 以自動改善沒有任何切割的屏幕上的 UI 外觀。然而,建議您避免為新工作使用全螢幕擴展;相反,使用 ScreenInsets 屬性來指定哪些插入應該在不同的 ScreenGui 容器中被尊重。

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

ScreenInsets

平行讀取

此屬性控制應用於 ScreenGui 內容的安全區插入。

默认值 CoreUISafeInsets 將所有子孫 GuiObjects 保留在核心 UI 安全區內,清除 Roblox 頂部欄按鈕和其他屏幕切割點,例如裝置的相機孔。

Mobile device showing UI buttons inside core UI safe area

如果您將此屬性設為 None,用戶介面對象可能會被核心用戶介面對象或相機槽等裝置切割背後隱藏。因結果,您只應該使用 None 來創建包含背景圖像等非互動內容的 ScreenGui

請參閱在畫面上的使用者介面容器以獲得替代示例。

方法

活動