ScreenGui

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

ユーザーの画面に表示される 2D の主要ストレージオブジェクト。GuiObjects は、親子をプレイヤーの Class.PlayerGui

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

性能の向上のため、ScreenGui の外観は次のイベントの 1つが発生するまでキャッシュされます:

  • 子孫はそれに追加されたまたは削除されます。
  • 子孫のプロパティが変更されます。
  • Class.ScreenGui 自体のプロパティが変更されます。

これらのイベントが発生すると、ScreenGui の外観は、次のフレームで再計算されます。

概要

プロパティ

  • 並列読み取り

    この ScreenGui のコンテンツをデバイスの安全領域にクリップするかどうか。

  • 並列読み取り

    複数の ScreenGuis が描画される Z インデックスの順序を制御します。

  • 複製されていません
    並列読み取り

    この ScreenGui が Roblox のコア UI Roblox(ロブロックス)素の範囲内に溢れているかどうかを決定します。

  • スクリーンカットアウト付きのディスプレイに適用される自動 UI の互換性変換を指定します。 Specifies whether automatic UI compatibility transformations are applied to descendant "fullscreen" GuiObjects on displays with screen cutouts.

  • この ScreenGui のコンテンツに適用される安全エリアのインセットを制御します。

LayerCollector から継承した プロパティGuiBase2d から継承した プロパティ

イベント

GuiBase2d から継承した イベント
  • SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal

    ゲームパッドの選択が移動すると、退出します。または、接続された GuiBase2d または任意の子 GuiObjects 内で変更されます。

プロパティ

ClipToDeviceSafeArea

並列読み取り

このプロパティが true のすべての子供を GuiObject にクリップするようになります。デフォルトは ScreenGui で、スクリーン端に滑り込む UI のバックアップを保つために 2>Class.ScreenIn

Mobile device showing UI button clipped by device safe
area

このプロパティが false である場合、GuiObject の子孫は、デバイスの安全領域には clipされ ません。カメラのスナップや他の画面カットアウトによって隠される可能性があります。

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

このプロパティは、ScreenGui.ScreenInsetsNone に設定している場合、Class.ScreenGui.ScreenInsets|None となるため、デバイスのセーフインセットを意図的に無視します。

DisplayOrder

並列読み取り

このプロパティは、複数の ScreenGuis が描画される Z インデックスの順序を制御します。 ScreenGuis は、より高い Class.ScreenGui|DisplayOrder を持つものよりも、その下にある値の低い Class.ScreenGui|DisplayOrder を描画します。

IgnoreGuiInset

複製されていません
並列読み取り

このプロパティが false (デフォルト) である場合、ScreenInsetsCoreUISafeInsets に設定され、Roblox トップバーコア UI の下で境界を維持します。

このプロパティが true および ScreenInsets に設定されている場合、CoreUISafeInsets は 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> に設定されます。

Class.ScreenGui.ScreenInsets|ScreenInsets を参照して、スクリーンインセットが ScreenGui のコンテンツにどのように影響するかを説明します。

SafeAreaCompatibility

並列読み取り

このプロパティは、画面切り替えのある GuiObjects の下の「完全画面」 ScreenGui に適用される自動 UI の互換性変換を指定します。エリジビ

デフォルトの値は FullscreenExtension で、スクリーンにカットアウトなしで UI の外観を自動的に改善するために使用されます。ただし、新しいワークの場合は、ScreenInsets プロパティを使用し

注:子孫 UI オブジェクトは、ClipToDeviceSafeAreatrue に設定されている場合、デバイスの安全エリアによって続きます。

ScreenInsets

並列読み取り

このプロパティは、この ScreenGui のコンテンツに適用される安全エリアのインセットを制御します。

デフォルトの CoreUISafeInsets は、GuiObjects 全体をコア UI 安全エリア内に保持し、Roblox トップバーボタンやデバイスのカメラの不要なコーナーなど、他の画面カットアウトをクリアします。

Mobile device showing UI buttons inside core UI safe area

このプロパティを None に設定すると、UI オブジェクトはコア UI オブジェクトまたはデバイスのカットアウトのようなコア UI オブジェクトの後ろに隠される可能性があります。結果、カメラのノックなど、非交互コンテンツを含む None

オルタナティブな例については、画面上の UI コンテナ を参照してください。

方法

イベント