ScreenGui
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
ScreenGui は、ユーザーの画面に表示される 2D GuiObjects のストレージコンテナです。A ScreenGui は、親がプレイヤーの PlayerGui に属している場合にのみ表示されます;プレイヤーの ScreenGui を StarterGui に親にすると、体験に参加し、キャラクターが最初にスポーンするときにそれぞれのプレイヤーの PlayerGui にクローンされます。詳細については、画面上の UI コンテナ を参照してください。
パフォーマンスの向上のため、次のイベントの 1つが発生するまで、ScreenGui の外観がキャッシュされます：
- 子孫がそれに追加されたり、削除されたりします。
- 下位のプロパティが変更されます。
- ScreenGui 自体のプロパティが変更されます。
これらのイベントのいずれかが発生すると、ScreenGui 表示は、レンダリングされる次のフレームで再計算されます。
概要
プロパティ
この ScreenGui のコンテンツをデバイスの安全領域にクリップするかどうか。
複数の ScreenGui コンテナが描かれる Z-index 順序を制御します。
ScreenGui が Roblox のコア UI 要素の範囲にオーバーフローするかどうかを決定します。
自動 UI 互換が切り取り画面を持つディスプレイで子孫の「フルスクリーン」に適用されるかどうかを指定します。Specifies whether automatic UI compatibility transformations are applied to descendant "fullscreen" GuiObjects on displays with screen cutouts.
ScreenGui のコンテンツに適用される安全エリアの挿入を制御します。
この LayerCollector の表示を切り替えます。
プレイヤーのキャラクターが再スポーンするたびに、 がリセットされるかどうかを決定します。
GuiObject.ZIndex がこの LayerCollector のすべての子孫でどのように振る舞うかを制御します。
ピクセルで、GuiBase2d 要素の実際の画面位置を説明します。
GuiBase2d 要素の実際のスクリーン回転を度数で説明します。
ピクセルで、GuiBase2d 要素の実際の画面サイズを説明します。
true に設定すると、ローカライゼーションがこの GuiBase2d とその子孫に適用されます。
この LocalizationTable とその子孫に自動翻訳を適用するために使用する GuiBase2d の参照。
下方向のゲームパッド選択動作をカスタマイズします。
左方向でゲームパッドの選択動作をカスタマイズします。
右向きにゲームパッドの選択動作をカスタマイズします。
上向きのゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
イベント
GuiBase2d から継承した イベント- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動し、離れ、または接続された またはその子孫の中で変更されると、炎が発生します。
プロパティ
ClipToDeviceSafeArea
このプロパティが である場合、すべての 子孫がデバイスの安全領域にクリップされます (見る )。デフォルトは true で、画面端にスライドしてビューに表示されるオブジェクトなど、意図的に非表示になっている UI のバックワード互換性を維持します。
このプロパティが である場合、 子孫はデバイスの安全領域にクリップされず、カメラのノッチまたは他のスクリーンカットで隠される可能性があります。
このプロパティは、ScreenInsets を None に設定すると無視されますが、そうするとデバイスの安全な挿入を意図的に無視したいことを示唆しているためです。
IgnoreGuiInset
このプロパティが false (デフォルト) の場合、ScreenInsets は CoreUISafeInsets に設定され、効果的に Roblox トップバーコアUIの境界を下に保持します。
このプロパティが true に変更され、 ScreenInsets が現在 CoreUISafeInsets に設定されている場合、 ScreenInsets は DeviceSafeInsets に設定されます。
スクリーンインサートが ScreenInsets のコンテンツにどのように影響するかの詳細は、ScreenGui を参照してください。
SafeAreaCompatibility
このプロパティは、自動 UI 互換が画面カットアウトで表示される の子「フルスクリーン」に適用されるかどうかを指定します。資格は、子孫の総面積 (適用された境界を含む) がデバイスの安全領域を横方向と縦方向の両方で覆っている場合に発生します。詳細については、Enum.SafeAreaCompatibility 枚数参照を参照してください。
デフォルト値は、切り取りなしの画面用に作成された UI の外観を自動的に改善するために FullscreenExtension です。ただし、新しい作業にはフルスクリーン拡張を避けることをお勧めします;代わりに、ScreenInsets プロパティを使用して、異なる ScreenGui コンテナに対して尊重すべき挿入を指定します。
子孫の UI オブジェクトは、ClipToDeviceSafeArea が true に設定されている場合、デバイスの安全領域によってクリップされ続けます。
ScreenInsets
このプロパティは、ScreenGui のコンテンツに適用される安全エリア挿入を制御します。
デフォルトの CoreUISafeInsets は、すべての子孫 GuiObjects をコアのUIセーフエリア内に保ち、Roblox のトップバーボタンやデバイスのカメラノッチのような他の画面カットアウトをクリアします。
このプロパティを None に設定すると、UIオブジェクトはコアの UIオブジェクトやカメラノッチのようなデバイスカットアウトの背後に隠される可能性があります。結果として、背景画像のような非対話コンテンツを含む None については、ScreenGui のみを使用する必要があります。
代替の例は、画面上の UI コンテナ を参照してください。