`CanvasGroup`は、その子孫をフラット化されたグループとしてレンダリングし、
`Class.CanvasGroup.GroupColor3|GroupColor3`と
`Class.CanvasGroup.GroupTransparency|GroupTransparency`がレンダリング結果にオプションで適用されます。 `Class.UIComponent`の視覚修飾子（例：
`Class.UICorner`や`Class.UIGradient`）は、`CanvasGroup`の下にある場合、グループ全体にも適用されます。 `CanvasGroup`は常に
`Class.GuiObject.ClipsDescendants|ClipsDescendants`が`true`に設定されており、すべての子孫はグループの境界外で切り取られます。

#### 重要な注意事項

- `CanvasGroup`の子孫は、祖先の`Class.LayerCollector`がその
  `Class.LayerCollector.ZIndexBehavior|ZIndexBehavior`を
  `Enum.ZIndexBehavior.Sibling`に設定している場合のみ、フラットなテクスチャとしてレンダリングされます。
- `CanvasGroup`は追加のテクスチャメモリを消費します。 テクスチャの質と
  合計メモリ使用量は、クライアントの`Enum.QualityLevel`によって制限されます。 メモリ制限を超えると、`CanvasGroup`は空白のテクスチャとしてレンダリングされます。
- `CanvasGroup`は静的サイズで使用することをお勧めします。 そうでない場合、新しいサイズに合わせて新しいテクスチャを作成する必要があります。


CanvasGroup

レンダリングされたグループに適用される色のティント。


CanvasGroup.GroupColor3

レンダリングされたグループに適用される透明度。


CanvasGroup.GroupTransparency

オプションの色/透明度の修正を伴うフラット化されたグループとして子孫をブレンドします。


`Class.GuiObject`は、2Dユーザーインターフェースオブジェクトのための抽象クラスです（`Class.BasePart`に似ています）。これは、`Class.GuiObject.Size|Size`や`Class.GuiObject.Position|Position`などのグラフィカルユーザーインターフェース（GUI）オブジェクトの表示に関連するすべてのプロパティを定義します。また、`Class.GuiObject.AbsolutePosition|AbsolutePosition`、`Class.GuiObject.AbsoluteSize|AbsoluteSize`、および`Class.GuiObject.AbsoluteRotation|AbsoluteRotation`のような便利な読み取り専用プロパティも持っています。

GUIオブジェクトのレイアウトを特別な方法で操作するには、[list/flex](/ui/list-flex-layouts)や[grid](/ui/grid-table-layouts)のようなレイアウト構造を使用し、[appearance modifiers](/ui/appearance-modifiers)を通じてコアプロパティを超えてスタイルを設定できます。

`Class.GuiObject.InputBegan|InputBegan`や`Class.GuiObject.InputEnded|InputEnded`を使用して、任意のGUIオブジェクトでマウスボタンイベントを検出することは可能ですが、`Class.ImageButton`や`Class.TextButton`のみが、クリック/プレスを検出するための便利な専用イベント（`Class.TextButton.Activated|Activated`など）を持っています。

以下の例は、`TextButton`のようなGuiObject内であることを前提としており、
`Class.GuiObject.Draggable`プロパティがtrueに設定されている必要があります。これは、
プレイヤーがオブジェクトをドラッグし始めた位置のUDim2を表示します。


このイベントは、プレイヤーがオブジェクトをドラッグし始めたときに発火します。

`Class.GuiObject.DragStopped`も参照してください。

GuiObject.DragBegin

initialPosition

`Class.GuiObject`のドラッグ操作が始まる前の位置の`Datatype.UDim2`値。

プレイヤーがオブジェクトをドラッグし始めたときに発火します。

以下の例は、`TextButton`のようなGuiObject内であることを前提としており、
`Class.GuiObject.Draggable`プロパティがtrueに設定されている必要があります。これにより、
プレイヤーがGUIのドラッグを停止した位置のXとYが表示されます。たとえば、
プレイヤーが189, 180でオブジェクトのドラッグを停止した場合、以下のように表示されます。
プレイヤーはGuiObjectを(189, 180)でドラッグを停止しました。


このイベントは、プレイヤーがオブジェクトのドラッグを停止したときに発火します。

`Class.GuiObject.DragBegin`も参照してください。

GuiObject.DragStopped

マウスの**X**画面位置（ピクセル単位）、画面の左上隅に対して相対的です。

マウスの**Y**画面位置（ピクセル単位）、画面の左上隅に対して相対的です。

プレイヤーがオブジェクトのドラッグを停止したときに発火します。

以下の例は、InputBeganからのユーザー入力をそのタイプに応じて処理する多くの使用例の1つを示しています。

これが期待通りに動作するためには、`LocalScript`に配置され、_gui_の子である必要があります。


このイベントは、ユーザーがヒューマン・コンピュータ・インターフェースデバイス（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）を介して`Class.GuiObject`と対話を開始したときに発火します。

`Class.UserInputService`には、特定のUI要素に制限されない同様の名前のイベントがあります：`Class.UserInputService.InputBegan`。

このイベントは、ゲームの状態に関係なく常に発火します。

`Class.GuiObject.InputEnded`および`Class.GuiObject.InputChanged`も参照してください。

GuiObject.InputBegan

input

ユーザー入力を照会するための便利なデータを含む`Class.InputObject`（入力の`Enum.UserInputType|タイプ`、入力の`Enum.UserInputState|状態`、および`Class.InputObject.Position|入力の画面座標`など）。

ユーザーがヒューマン・コンピュータ・インターフェースデバイスを介して操作を開始したときに発火します（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）。

以下の例は、InputChanged からのユーザー入力をそのタイプに応じて処理する多くの使用例の一つを示しています。

これが期待通りに動作するためには、`LocalScript` に配置され、_gui_ の子である必要があります。


このイベントは、ユーザーがヒューマン・コンピュータ・インターフェースデバイス（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）を介しての操作方法を変更したときに発火します。

`Class.UserInputService`には、特定のUI要素に制限されない同様の名前のイベントがあります：`Class.UserInputService.InputChanged`。

このイベントは、ゲームの状態に関係なく常に発火します。

`Class.GuiObject.InputBegan`および`Class.GuiObject.InputEnded`も参照してください。

GuiObject.InputChanged

ユーザーがヒューマン・コンピュータ・インターフェースデバイスを介しての操作方法を変更したときに発火します（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）。

以下の例は、InputEndedからのユーザー入力をそのタイプに応じて処理する多くの使用例の1つを示しています。

これが期待通りに動作するためには、`LocalScript`に配置され、_gui_の子である必要があります。


InputEndedイベントは、ユーザーがヒューマン・コンピュータ・インターフェースデバイス（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）を介しての操作を停止したときに発火します。

`Class.UserInputService`には、特定のUI要素に制限されない同様の名前のイベントがあります：`Class.UserInputService.InputEnded`。

このイベントは、ゲームの状態に関係なく常に発火します。

`Class.GuiObject.InputBegan`および`Class.GuiObject.InputChanged`も参照してください。

GuiObject.InputEnded

ユーザー入力を照会するための便利なデータを含む`Class.InputObject`（`Enum.UserInputType`、`Enum.UserInputState`、および`Class.InputObject.Position`など）。

ユーザーがヒューマン・コンピュータ・インターフェースデバイスを介しての操作を停止したときに発火します（マウスボタンが押された、タッチが始まった、キーボードボタンが押されたなど）。

次の例では、マウスがGUI要素に入るときのマウスの位置をピクセル単位で印刷します。


MouseEnterイベントは、ユーザーが`Class.GuiObject`要素にマウスを移動したときに発火します。

このイベントによって渡される`x`および`y`引数を、ユーザーのマウスがGUIに入ったときの位置を決定するための確実な方法として頼らないでください。これらの座標は、同じエッジからGUIにマウスが入る場合でも変わる可能性があります。特に、マウスが要素に素早く入るときにそうなります。これは、座標がイベントが発火したときのマウスの位置を示すためであり、マウスがGUIに入った正確な瞬間を示すものではありません。

このイベントは、GUI要素が他の要素の下にレンダリングされている場合でも発火します。

ユーザーのマウスがGUI要素から離れるときを追跡したい場合は、`Class.GuiObject.MouseLeave`イベントを使用できます。

##### 参照

- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseEnter

マウスの**X**画面座標（ピクセル単位）、画面の左上隅に対して相対的です。

マウスの**Y**画面座標（ピクセル単位）、画面の左上隅に対して相対的です。

ユーザーがGUI要素にマウスを移動したときに発火します。

MouseLeaveイベントは、ユーザーが`Class.GuiObject`要素からマウスを移動したときに発火します。

このイベントによって渡される`x`および`y`引数を、ユーザーのマウスがGUIから離れたときの位置を決定するための確実な方法として頼らないでください。これらの座標は、同じエッジからGUIを離れる場合でも変わる可能性があります。特に、マウスが要素から素早く離れるときにそうなります。これは、座標がイベントが発火したときのマウスの位置を示すためであり、マウスがGUIから離れた正確な瞬間を示すものではありません。

このイベントは、GUI要素が他の要素の下にレンダリングされている場合でも発火します。

##### 参照

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseLeave

ユーザーがGUI要素からマウスを移動したときに発火します。

ユーザーがマウスを動かすたびに発火します。これは、`Class.GuiObject`要素の内部にあるときに発生します。これは、ユーザーのマウスがGUI要素の上にあるかどうかに関係なく発火する`Class.Mouse.Move`に似ています。

このイベントは、マウスの位置が更新されると発火するため、移動中は繰り返し発火します。

`x`および`y`引数は、ユーザーのマウスの更新された画面座標をピクセル単位で示します。これらは、マウスの位置をGUI、画面、およびマウスの前の位置からのデルタを追跡するために役立ちます。

以下のコードは、ユーザーのマウスの`Datatype.Vector2`オフセットをGUI要素に対して決定する方法を示しています。
`Class.GuiObject.AbsolutePosition|AbsolutePosition`は、画面のGUIインセット内で測定されますが、このイベントの`x`および`y`引数はそれを含む画面座標であるため、サンプルは`Class.GuiService:GetGuiInset()|GetGuiInset()`を呼び出して2つの空間を調整します。

```lua
local Players = game:GetService("Players")
local GuiService = game:GetService("GuiService")

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local topLeftInset = GuiService:GetGuiInset()

	local gui_X = CustomScrollingFrame.AbsolutePosition.X
	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y

	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - topLeftInset.Y))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
このイベントは、ユーザーのマウスがGUI要素に入ったり出たりするときに正確に発火しない場合があります。したがって、`x`および`y`引数はGUIのエッジの座標と完全に一致しない場合があります。

##### 参照

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`


GuiObject.MouseMoved

ユーザーがGUI要素内でマウスを移動しているときに発火します。

WheelBackwardイベントは、ユーザーがGUI要素の上でマウスホイールを後ろにスクロールしたときに発火します。これは、ユーザーのマウスがGUI要素の上にあるかどうかに関係なく発火する`Class.Mouse.WheelBackward`に似ています。

このイベントは、ホイールの後ろへの動きを示す指標として発火します。これは、`x`および`y`マウス座標引数がこのイベントの結果として変わらないことを意味します。これらの座標は、マウスが移動したときにのみ変わり、これは`Class.GuiObject.MouseMoved`イベントで追跡できます。

##### 参照

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`

GuiObject.MouseWheelBackward

ユーザーがGUI要素の上でマウスホイールを後ろにスクロールしたときに発火します。

WheelForwardイベントは、ユーザーがGUI要素の上でマウスホイールを前にスクロールしたときに発火します。これは、ユーザーのマウスがGUI要素の上にあるかどうかに関係なく発火する`Class.Mouse.WheelForward`に似ています。

このイベントは、ホイールの前への動きを示す指標として発火します。これは、**X**および**Y**マウス座標引数がこのイベントの結果として変わらないことを意味します。これらの座標は、マウスが移動したときにのみ変わり、これは`Class.GuiObject.MouseMoved`イベントで追跡できます。

##### 参照

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseWheelForward

ユーザーのマウスの**Y**座標。

ユーザーがGUI要素の上でマウスホイールを前にスクロールしたときに発火します。

次の例では、ユーザーがゲームパッドでオブジェクトを選択したときにメッセージを表示します。

これが期待通りに動作するためには、`LocalScript`に配置され、
_gui_の子である必要があります。


このイベントは、ゲームパッドのセレクターが`Class.GuiObject`にフォーカスを合わせ始めたときに発火します。

ゲームパッドのセレクターがGUI要素へのフォーカスを停止したかどうかを確認したい場合は、`Class.GuiObject.SelectionLost`イベントを使用できます。

GUIが選択フォーカスを得ると、`Class.GuiService.SelectedObject|SelectedObject`プロパティの値も、選択を得たものに変更されます。どのGUIが選択を得たかを判断するには、このプロパティの値を確認してください。

GuiObject.SelectionGained

GuiObjectがゲームパッドセレクターでフォーカスされているときに発火します。

次の例では、要素がゲームパッドでフォーカスを失ったときにメッセージを印刷します。

これが期待通りに動作するためには、`LocalScript`に配置され、_gui_の子である必要があります。


このイベントは、ゲームパッドのセレクターが`Class.GuiObject`へのフォーカスを停止したときに発火します。

ゲームパッドのセレクターがGUI要素へのフォーカスを開始したかどうかを確認したい場合は、`Class.GuiObject.SelectionGained`イベントを使用できます。

GUIが選択フォーカスを失うと、`Class.GuiService.SelectionObject|SelectionObject`プロパティの値は`nil`または選択フォーカスを得たGUI要素に変更されます。どのGUIが選択を得たか、または選択されたGUIがないかを判断するには、このプロパティの値を確認してください。

GuiObject.SelectionLost

ゲームパッドのセレクターがGuiObjectへのフォーカスを停止したときに発火します。

このコードサンプルは、プレイヤーがUI要素（`Frame`など）の画面上の位置を操作できるようにします。
UI要素を短時間押し続けた後、プレイヤーは指を動かして離します。ジェスチャーの間、
Frameは青色で白いアウトラインが付けられます。


このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素に指を置いた後、短い瞬間に発火します。ジェスチャーに関与する指の相対的な画面位置を説明する`Datatype.Vector2`のテーブルと共に発火します。さらに、複数回発火します：`Enum.UserInputState.Begin`は短い遅延の後に、`Enum.UserInputState.Change`はプレイヤーがジェスチャー中に指を動かした場合に、最後に`Enum.UserInputState.End`が発火します。遅延はプラットフォームに依存し、スタジオでは1秒より少し長くなります。

GuiObject.TouchLongPress

touchPositions

`Datatype.Vector2`の配列で、ジェスチャーに関与する指の**相対的**な位置を説明します。

state

ジェスチャーの状態を説明する`Enum.UserInputState`:

- Beginはジェスチャーの開始時に一度発火します（短い遅延の後）
- Changeはプレイヤーが押し下げている間に指を動かした場合に発火します
- Endはプレイヤーが指を離したときにジェスチャーの終了時に一度発火します。

プレイヤーがUI要素を長押しし始め、続け、停止したときに発火します。

このコードサンプルは、外側の `Frame` または他の `GuiObject` の内側にある `Frame` 内の `LocalScript` に配置されることを意図しています。これにより、プレイヤーは外側のフレーム上で指を動かすことで内側のフレームの位置を操作できます。


このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素上で指を動かしたときに発火します。`Class.GuiObject.TouchSwipe`が発火する直前に発火し、`Class.GuiObject.TouchTap`では発火しません。このイベントは、プレイヤーが画面上のUI要素の位置を操作できるようにするために便利です。

このイベントは、ジェスチャーに関与する指の相対的な画面位置を説明する`Datatype.Vector2`のテーブルと共に発火します。さらに、複数回発火します：`Enum.UserInputState.Begin`は短い遅延の後に、`Enum.UserInputState.Change`はプレイヤーがジェスチャー中に指を動かしたときに、最後に`Enum.UserInputState.End`で発火します。

GuiObject.TouchPan

ジェスチャーに関与するすべての指の位置を示す`Datatype.Vector2`オブジェクトのLuau配列。

totalTranslation

パンジェスチャーが開始点からどれだけ進んだかを示します。

velocity

各次元でジェスチャーがどれだけ速く行われているかを示します。

ジェスチャーの`Enum.UserInputState`を示します。

プレイヤーがUI要素上で指を動かしたときに発火します。

このコードサンプルは、外側の `Frame` 内の内側の `Frame` にある `LocalScript` 用です。
プレイヤーが外側のフレームで `Class.GuiObject.TouchPinch` ジェスチャーを行うことで、
内側のフレームをスケーリングできるようにします。


このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素上で2本の指を使ってピンチまたはプルジェスチャーを行ったときに発火します。**ピンチ**は2本以上の指が近づくときに発生し、**プル**は指が離れるときに発生します。このイベントは`Class.GuiObject.TouchPan`と共に発火します。このイベントは、プレイヤーが画面上のUI要素のスケール（サイズ）を操作できるようにするために便利で、最もよくズーム機能に使用されます。

このイベントは、ジェスチャーに関与する指の相対的な画面位置を説明する`Datatype.Vector2`のテーブルと共に発火します。さらに、複数回発火します：`Enum.UserInputState.Begin`は短い遅延の後に、`Enum.UserInputState.Change`はプレイヤーがジェスチャー中に指を動かしたときに、最後に`Enum.UserInputState.End`で発火します。スケールは**乗算的に**使用する必要があることに注意してください。

GuiObject.TouchPinch

ピンチジェスチャーに関与するすべての指の位置を示す`Datatype.Vector2`オブジェクトのLuau配列。

scale

ピンチジェスチャーの開始時からの差を示す浮動小数点数。

ピンチジェスチャーがどれだけ速く行われているかを示す浮動小数点数。

プレイヤーがUI要素上で2本の指を使ってピンチまたはプルジェスチャーを行ったときに発火します。

このコードサンプルは、外側の `Frame` 内の内側の `Frame` にある `LocalScript` 用です。
プレイヤーが外側のフレームで `Class.GuiObject.TouchRotate` ジェスチャーを実行することで、
内側のフレームを回転させることができます。


このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素上で2本の指を使って回転ジェスチャーを行ったときに発火します。回転は、2本の指の間の線の角度が変わるときに発生します。このイベントは`Class.GuiObject.TouchPan`と共に発火します。このイベントは、プレイヤーが画面上のUI要素の回転を操作できるようにするために便利です。

このイベントは、ジェスチャーに関与する指の相対的な画面位置を説明する`Datatype.Vector2`のテーブルと共に発火します。さらに、複数回発火します：`Enum.UserInputState.Begin`は短い遅延の後に、`Enum.UserInputState.Change`はプレイヤーがジェスチャー中に指を動かしたときに、最後に`Enum.UserInputState.End`で発火します。

GuiObject.TouchRotate

rotation

ジェスチャーの開始時からの回転の進行度を示す浮動小数点数。

ジェスチャーがどれだけ速く行われているかを示す浮動小数点数。

プレイヤーがUI要素上で2本の指を使って回転ジェスチャーを行ったときに発火します。

このコードサンプルは、タッチ対応デバイス（またはスタジオのエミュレーター）でスワイプジェスチャーが行われると、`Frame`（または他の`GuiObject`）がバウンドするようにします。
横方向のスワイプは、`Class.GuiObject.BackgroundColor3`の色相を変更し、縦方向のスワイプは彩度を変更します。


このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素上でスワイプジェスチャーを行ったときに発火します。ジェスチャーの方向（上、下、左、または右）と、ジェスチャーに関与するタッチポイントの数と共に発火します。スワイプジェスチャーは、モバイルUIでタブを変更するためによく使用されます。

GuiObject.TouchSwipe

swipeDirection

スワイプジェスチャーの方向を示す`Enum.SwipeDirection`（上、下、左、または右）。

numberOfTouches

ジェスチャーに関与するタッチポイントの数（通常は1）。

プレイヤーがUI要素上でスワイプジェスチャーを行ったときに発火します。

このコードサンプルは、タッチ対応デバイスでタップされたときに `Frame` のような UI エレメントの `Class.GuiObject.BackgroundTransparency` を切り替えます。

このイベントは、プレイヤーがタッチ対応デバイスを使用してUI要素上でタップジェスチャーを行ったときに発火します。タップは、動きのない迅速な単一のタッチです（長押しは`Class.GuiObject.TouchLongPress`を発火させ、タッチ中に動くと`Class.GuiObject.TouchPan`および/または`Class.GuiObject.TouchSwipe`を発火させます）。このイベントは、ジェスチャーに関与する指の相対的な位置を説明する`Datatype.Vector2`オブジェクトのテーブルと共に発火します。

GuiObject.TouchTap

プレイヤーがUI要素上でタップジェスチャーを行ったときに発火します。

このコードサンプルは、コールバック関数を定義することによって、補間が完了/キャンセルされたときに検出することによるTweenPositionのより複雑な使用法を示しています。また、補間が再生されるかどうかを出力します。


指定された時間内に指定された`Enum.EasingDirection`と`Enum.EasingStyle`を使用して、GUIを新しい`Datatype.UDim2`位置にスムーズに移動します。

この関数は、ツイーンが再生されるかどうかを返します。別のツイーンが`Class.GuiObject`に作用している場合、オーバーライドパラメータが`false`の場合は再生されません。

`Class.GuiObject:TweenSize()`および`Class.GuiObject:TweenSizeAndPosition()`も参照してください。

GuiObject:TweenPosition

endPosition

easingDirection

GUIを_endPosition_にスムーズに移動させる方向。

easingStyle

GUIを_endPosition_にスムーズに移動させるスタイル。

time

ツイーンが完了するのにかかる時間（秒単位）。

override

ツイーンが進行中のツイーンをオーバーライドするかどうか。

callback

ツイーンが完了したときに実行されるコールバック関数。

ツイーンが再生されるかどうか。

GUIを新しい`Datatype.UDim2`にスムーズに移動します。

このコードサンプルは、`Class.GuiObject:TweenSize()`
関数の使用法を示しています。これは、親の`Class.GuiObject.Size`
プロパティを`UDim2.new(0.5, 0, 0.5, 0)`にアニメーションさせるもので、
これは`GuiObject`の親のサイズの両方の軸で半分になります。

さらに、コールバックパラメータを使用して、補間が停止したとき（他の補間によってキャンセルされたか、完了したか）を検出する方法も示しています。


指定された時間内に指定された`Enum.EasingDirection`と`Enum.EasingStyle`を使用して、`Class.GuiObject`を新しい`Datatype.UDim2`にスムーズにリサイズします。

この関数は、ツイーンが再生されるかどうかを返します。通常、これは常に`true`を返しますが、別のツイーンがアクティブで、オーバーライドが`false`に設定されている場合は`false`を返します。

`Class.GuiObject:TweenSize()`および`Class.GuiObject:TweenSizeAndPosition()`も参照してください。

GuiObject:TweenSize

endSize

GUIを_endSize_にスムーズに移動させる方向。

GUIを_endSize_にスムーズに移動させるスタイル。

`Class.GuiObject`を新しい`Datatype.UDim2`にスムーズにリサイズします。

以下の例では、`Class.Frame`を親のサイズの左上に補間し、サイズを0にリサイズします。


指定された時間内に指定された`Enum.EasingDirection`と`Enum.EasingStyle`を使用して、GUIを新しい`Datatype.UDim2`サイズと位置にスムーズにリサイズおよび移動します。

この関数は、ツイーンが再生されるかどうかを返します。通常、これは常に`true`を返しますが、別のツイーンがアクティブで、オーバーライドが`false`に設定されている場合は`false`を返します。

`Class.GuiObject:TweenSize()`および`Class.GuiObject:TweenSizeAndPosition()`も参照してください。

GuiObject:TweenSizeAndPosition

GUIを_endSize_および_endPosition_にスムーズに移動させる方向。

GUIを_endSize_および_endPosition_にスムーズに移動させるスタイル。

GUIを新しいサイズと位置にスムーズに移動します。

GuiObject

このコードサンプルは、ActivatedイベントのデバウンスとしてのActiveプロパティの使用法を示しています。

このプロパティは、`Class.GuiObject`が`Class.ClickDetector`クラスのような3D空間に入力を受け取るかどうかを決定します。

`Class.GuiButton`オブジェクト（`Class.ImageButton`および`Class.TextButton`）の場合、このプロパティは`Class.GuiButton.Activated|Activated`が発火するかどうかを決定します（`Class.GuiButton.AutoButtonColor|AutoButtonColor`も機能します）。このプロパティの値に関係なく、`Class.GuiObject.InputBegan|InputBegan`、`Class.GuiObject.InputChanged|InputChanged`、および`Class.GuiObject.InputEnded|InputEnded`イベントは通常通り機能します。

GuiObject.Active

このUI要素が入力を受け取るかどうかを決定します。

このコードサンプルは、UI要素を親要素の異なる側に移動させます。
左上から始まり、右下で終了します。ScreenGui内のFrameに
LocalScriptとして貼り付けてください。


このプロパティは、`Class.GuiObject`の原点を、その絶対サイズに対して決定します。原点は、要素がどこに配置されるか（`Class.GuiObject.Position`を通じて）を決定し、レンダリングされた`Class.GuiObject.Size`がどこから拡張されるかを決定します。

図解と詳細については[こちら](/ui/position-and-size#anchorpoint)を参照してください。

GuiObject.AnchorPoint

`Class.GuiObject`の原点を、その絶対サイズに対して決定します。

以下のスクリプトは、自動サイズの親フレームを作成し、
`UIListLayout`を使用して、いくつかの自動サイズの`TextLabel`
オブジェクトを挿入します。親の`UIListLayout`がその子コンテンツに合わせて自動的にサイズを変更し、
ラベルがそのテキストコンテンツに合わせて自動的にサイズを変更する様子に注目してください。
このスクリプトは`ScreenGui`に親付けできます。


このプロパティは、親UIオブジェクトのサイズをその子孫のサイズに基づいて自動的に設定するために使用されます。このプロパティを使用して、編集時または実行時にUIオブジェクトにテキストやその他のコンテンツを動的に追加でき、そのサイズはそのコンテンツに合わせて調整されます。

`Class.GuiObject.AutomaticSize|AutomaticSize`が`Enum.AutomaticSize`の値に設定されている場合、UIオブジェクトはその子コンテンツに応じてリサイズされる可能性があります。

このプロパティの使用方法と動作についての詳細は、[こちら](/ui/size-modifiers#automatic-sizing)を参照してください。

GuiObject.AutomaticSize

子コンテンツに基づいてリサイズが行われるかどうかを決定します。

`Class.GuiObject`の背景色を決定します。

GuiObject.BackgroundColor

このコードサンプルは、親フレームが Color3.fromHSV を使用して虹のすべての色をループするようにします。


`Class.GuiObject`の背景（塗りつぶし色）の色を決定します。要素にテキスト（`Class.TextBox`、`Class.TextButton`、または`Class.TextLabel`など）が含まれている場合、背景の色がテキストの色と対照的であることを確認してください。

背景の視覚的プロパティを決定する別のプロパティは`Class.GuiObject.BackgroundTransparency`です。これが`1`に設定されている場合、背景も境界線もレンダリングされません。

`Class.GuiObject.BorderColor3|BorderColor3`も参照してください。

GuiObject.BackgroundColor3

`Class.GuiObject`の背景と境界線の透明度を決定します。ただし、GUIが`Class.TextBox`、`Class.TextButton`、または`Class.TextLabel`の場合、テキストの透明度は`Class.TextBox.TextTransparency`、`Class.TextButton.TextTransparency`、および`Class.TextLabel.TextTransparency`によって決定されます。

このプロパティが`1`に設定されている場合、背景も境界線もレンダリングされず、GUIの背景は完全に透明になります。

GuiObject.BackgroundTransparency

`Class.GuiObject`の背景と境界線の透明度を決定します。

`Class.GuiObject`の境界線の色を決定します。

GuiObject.BorderColor

このコードサンプルは、ユーザーが要素の上にマウスをホバーしたときに、親GuiObjectの境界をハイライトします。


`Class.GuiObject`の矩形境界線の色を決定します（ストローク色とも呼ばれます）。これはオブジェクトの`Class.GuiObject.BackgroundColor3`とは別です。`Class.GuiObject.BorderSizePixel`プロパティが`0`に設定されている場合、オブジェクトの境界線は表示されません。

`Class.UIStroke`コンポーネントは、より高度な境界線効果を可能にします。

GuiObject.BorderColor3

このプロパティは、`Enum.BorderMode`の列挙型を使用して、`Class.GuiObject`の境界線がその寸法に対してどのようにレイアウトされるかを決定します。

`Class.UIStroke`はこのプロパティをオーバーライドし、より高度な境界線効果を可能にします。

GuiObject.BorderMode

`Class.GuiObject`の境界線がその寸法に対してどのようにレイアウトされるかを決定します。

このプロパティは、`Class.GuiObject`の境界線がピクセル単位でどれだけ幅を持つかを決定します。これを`0`に設定すると、境界線は完全に無効になります。

`Class.UIStroke`はこのプロパティをオーバーライドし、より高度な境界線効果を可能にします。

GuiObject.BorderSizePixel

`Class.GuiObject`の境界線のピクセル幅を決定します。

このプロパティは、`Class.GuiObject`が、矩形の境界外にレンダリングされる子GUI要素の部分をクリップ（不可視に）するかどうかを決定します。

#### 回転動作

`Class.StarterGui.ClipsDescendantsSupportsRotation`が有効な場合、クリッピングは回転した形状に対して正しく機能します。ただし、回転した形状によるクリッピング（クリッピング親自体が回転している場合）や丸みを帯びたコーナー（`Class.UICorner`）によるクリッピングはサポートされていません。

`Class.StarterGui.ClipsDescendantsSupportsRotation`が**無効**であり、この`Class.GuiObject`またはその先祖の`Class.GuiObject`が**ゼロ以外**の`Class.GuiObject.Rotation|Rotation`を持つ場合、このプロパティは**無視**され、子GUI要素はこのプロパティの値に関係なくレンダリングされます。

GuiObject.ClipsDescendants

親GUI要素の境界外にある子`Class.GuiObject|GuiObjects`がレンダリングされるかどうかを決定します。

`Class.GuiObject`（およびその子孫）が画面上でドラッグできるかどうかを示します。

GuiObject.Draggable

`Class.GuiObject`（およびその子孫）が画面上でドラッグできるかどうかを決定します。

プレイヤーの指が`Class.GuiObject`の上でタップされて保持されている場合、`Class.GuiObject.GuiState|GuiState`は`Enum.GuiState.Press|Press`に設定されます。同様に、プレイヤーの指が`Class.GuiObject`から離されると、`Class.GuiObject.GuiState|GuiState`は`Enum.GuiState.Idle|Idle`に設定され、`Class.GuiObject.Interactable|Interactable`が`Class.GuiObject`でオフになると、`Class.GuiState`は`Enum.GuiState.NonInteractable|NonInteractable`に設定されます。

GuiObject.GuiState

プレイヤーのマウスが`Class.GuiObject`上でアクティブに押されているかどうかを決定します。

`Class.GuiObject`上で発生する入力をどのように受け取るか、またその程度を制御します。`Enum.InputSink`を使用します。入力を受け取ることで、要素の背後にあるオブジェクト（`Class.ClickDetector`や`Class.DragDetector`を持つ3Dオブジェクトなど）に通過させないようにします。デフォルトは`Enum.InputSink.None`ですが、`Class.GuiButton`オブジェクト（`Class.ImageButton`および`Class.TextButton`）ではデフォルトが`Enum.InputSink.Activate`です。

- `Enum.InputSink.None` — オブジェクトは自分自身で入力を受け取らない。
- `Enum.InputSink.Activate` — オブジェクトはそれをアクティブにするために使用されるマウスボタンおよびタッチの押下/解放入力を受け取りますが、他の入力（マウスの動きなど）は通過させます。
- `Enum.InputSink.All` — オブジェクトは上で発生するすべての入力を受け取ります。

このプロパティは、すべての入力を受け取るか、まったく受け取らないだけのブール型の`Class.GuiObject.Active|Active`プロパティのより詳細な後継です。`Class.GuiObject.InputBegan|InputBegan`、`Class.GuiObject.InputChanged|InputChanged`、および`Class.GuiObject.InputEnded|InputEnded`イベントは、このプロパティの値に関係なく発火します。

GuiObject.InputSink

`Class.GuiObject`上で発生する入力をどのように受け取るかを制御します。

`Class.GuiButton`が操作可能かどうか、または`Class.GuiObject`の`Enum.GuiState|GuiState`が変化しているかどうかを決定します。

`Class.GuiButton`の場合：

- `Class.GuiButton`の`Class.GuiObject.Interactable|Interactable`設定が`false`に設定されている場合、`Class.GuiButton`はもはや押されたりクリックされたりできず、`Class.GuiObject.GuiState|GuiState`は常に`Enum.GuiState.NonInteractable|NonInteractable`に設定されます。
- `Class.GuiButton`の`Class.GuiObject.Interactable|Interactable`設定が`true`に設定されている場合、`Class.GuiButton`は再び通常通り動作し、`Class.GuiObject.GuiState|GuiState`も通常通り動作します。

`Class.GuiObject`の場合：

- `Class.GuiButton`の`Class.GuiObject.Interactable|Interactable`設定が`false`に設定されている場合、`Class.GuiObject.GuiState|GuiState`は常に`Enum.GuiState.NonInteractable|NonInteractable`に設定されます。
- `Class.GuiButton`の`Class.GuiObject.Interactable|Interactable`設定が`true`に設定されている場合、`Class.GuiObject.GuiState|GuiState`は再び通常通り動作します。

GuiObject.Interactable

`Class.GuiButton`が操作可能かどうか、または`Class.GuiObject`の`Enum.GuiState|GuiState`が変化しているかどうかを決定します。

このプロパティは、`Class.UIGridStyleLayout`（`Class.UIListLayout`や`Class.UIPageLayout`など）を使用する際の`Class.GuiObject`のソート順を制御します。`Class.UIGridStyleLayout.SortOrder|SortOrder`が`Enum.SortOrder.LayoutOrder`に設定されている場合、オブジェクトに兄弟UIレイアウト構造がない場合は機能しません。

`Class.GuiObject|GuiObjects`は昇順でソートされ、低い値が高い値よりも優先されます。等しい値のオブジェクトは、追加された順序に戻ります。

将来的に2つの既存の要素の間に要素を追加する必要があるかどうかわからない場合は、`100`の倍数（`0`、`100`、`200`など）を使用することをお勧めします。これにより、他の要素の間に配置される要素のために使用できるレイアウト順序値の大きなギャップが確保されます。

オブジェクトの**レンダリング**順序を決定する`Class.GuiObject.ZIndex|ZIndex`も参照してください。

GuiObject.LayoutOrder

`Class.GuiObject`が`Class.UIGridStyleLayout`で使用されるときのソート順を制御します。

この例は、`GuiObject|GUI`要素のグリッドを手動で接続することなく、ゲームパッドナビゲーションを有効にする方法を示しています。
`Class.GuiObject.NextSelectionUp`、`Class.GuiObject.NextSelectionDown`、および
`GuiObject|NextSelectionRight`、`Class.GuiObject.NextSelectionLeft`
プロパティをグリッド内のすべての要素に対して設定する必要はありません。

このコードサンプルは、`UIGridLayout`が
`Class.UIGridLayout.SortOrder|name`でソートされていることを前提としています。要素は連続した
数値順に名前が付けられています。

このコードは、UIGridLayoutと同じレベルのすべての`GuiObjects`のNextSelectionプロパティを設定するために、これに依存しています。私たちの例では、
UIGridLayoutObjectとグリッド内のGUI要素はすべて、_"Container"_という名前の`Frame`の子です。コード
`Class.Instance:GetChildren()|gets the children`は、_"Container"_の子を取得し、各子をループします。GuiObjectでない子は無視されます。各GUI要素に対して、コードは次のロジックを使用してNextSelectionプロパティを設定しようとします：

1. 1から始めて、すべてのGUI要素の名前はグリッド内の位置に一致します。
2. 左：左側のアイテムは常に現在の要素よりも1少ない番号になります。
3. 右：右側のアイテムは常に現在の要素よりも1多い番号になります。
4. 上：上のアイテムは常に現在の要素よりも1少ない行のGUIの数になります。
5. 下：下のアイテムは常に現在の要素よりも多い行のGUIの数になります。このロジックにより、行の最初と最後の要素を除くグリッドの先頭と末尾のGUI要素が、次の行と前の行にラップすることができます。左、右、上、または下に要素が存在しない場合、NextSelectionはnilのままとなり、ゲームパッドセレクタをその方向に移動しても選択されたGUIは変更されません。

この例には、ゲームパッドがない場合に備えて、キーボードの矢印キー（上、下、左、右）を使用してグリッドをテストするためのコードも含まれています。このコードの部分は、`Class.GuiService.SelectedObject`プロパティに_"1"_という名前の要素を割り当てて初期選択を行います。


このプロパティは、ユーザーが[ゲームパッド](/input/gamepad)セレクターを下に移動したときに選択される`Class.GuiObject`を設定します。このプロパティが空の場合、ゲームパッドを下に移動しても選択されるGUIは変更されません。

ゲームパッドセレクターを下に移動すると、`Class.GuiService.SelectedObject`がこのオブジェクトに設定されます。ただし、GUIが`Class.GuiObject.Selectable|Selectable`でない場合は除きます。このプロパティは、GUI要素が`Class.GuiObject.Selectable|Selectable`でなくても設定できるため、GUIの選択可能プロパティの値が期待される動作と一致することを確認してください。

`Class.GuiObject.NextSelectionUp|NextSelectionUp`、`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`、および`Class.GuiObject.NextSelectionRight|NextSelectionRight`も参照してください。

GuiObject.NextSelectionDown

ゲームパッドセレクターが下に移動したときに選択される`Class.GuiObject`を設定します。

このプロパティは、ユーザーが[ゲームパッド](/input/gamepad)セレクターを左に移動したときに選択される`Class.GuiObject`を設定します。このプロパティが空の場合、ゲームパッドを左に移動しても選択されるGUIは変更されません。

ゲームパッドセレクターを左に移動すると、`Class.GuiService.SelectedObject`がこのオブジェクトに設定されます。ただし、GUIが`Class.GuiObject.Selectable|Selectable`でない場合は除きます。このプロパティは、GUI要素が`Class.GuiObject.Selectable|Selectable`でなくても設定できるため、GUIの選択可能プロパティの値が期待される動作と一致することを確認してください。

`Class.GuiObject.NextSelectionUp|NextSelectionUp`、`Class.GuiObject.NextSelectionDown|NextSelectionDown`、および`Class.GuiObject.NextSelectionRight|NextSelectionRight`も参照してください。

GuiObject.NextSelectionLeft

ゲームパッドセレクターが左に移動したときに選択される`Class.GuiObject`を設定します。

このプロパティは、ユーザーが[ゲームパッド](/input/gamepad)セレクターを右に移動したときに選択される`Class.GuiObject`を設定します。このプロパティが空の場合、ゲームパッドを右に移動しても選択されるGUIは変更されません。

ゲームパッドセレクターを右に移動すると、`Class.GuiService.SelectedObject`がこのオブジェクトに設定されます。ただし、GUIが`Class.GuiObject.Selectable|Selectable`でない場合は除きます。このプロパティは、GUI要素が`Class.GuiObject.Selectable|Selectable`でなくても設定できるため、GUIの選択可能プロパティの値が期待される動作と一致することを確認してください。

`Class.GuiObject.NextSelectionUp|NextSelectionUp`、`Class.GuiObject.NextSelectionDown|NextSelectionDown`、および`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`も参照してください。

GuiObject.NextSelectionRight

ゲームパッドセレクターが右に移動したときに選択される`Class.GuiObject`を設定します。

このプロパティは、ユーザーが[ゲームパッド](/input/gamepad)セレクターを上に移動したときに選択される`Class.GuiObject`を設定します。このプロパティが空の場合、ゲームパッドを上に移動しても選択されるGUIは変更されません。

ゲームパッドセレクターを上に移動すると、`Class.GuiService.SelectedObject`がこのオブジェクトに設定されます。ただし、GUIが`Class.GuiObject.Selectable|Selectable`でない場合は除きます。このプロパティは、GUI要素が`Class.GuiObject.Selectable|Selectable`でなくても設定できるため、GUIの選択可能プロパティの値が期待される動作と一致することを確認してください。

`Class.GuiObject.NextSelectionDown|NextSelectionDown`、`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`、および`Class.GuiObject.NextSelectionRight|NextSelectionRight`も参照してください。

GuiObject.NextSelectionUp

ゲームパッドセレクターが上に移動したときに選択される`Class.GuiObject`を設定します。

このプロパティは、`Datatype.UDim2`を使用して`Class.GuiObject`のピクセルおよびスカラー位置を決定します。位置はオブジェクトの`Class.GuiObject.AnchorPoint`を中心にします。

スカラー位置は、親GUI要素のサイズに対して相対的です。

`Datatype.UDim2`値のピクセル部分は、親GUIのサイズに関係なく同じです。値は、オブジェクトのピクセル位置を表します。オブジェクトの実際のピクセル位置は、`Class.GuiBase2d.AbsolutePosition`プロパティから読み取ることができます。

GuiObject.Position

`Class.GuiObject`のピクセルおよびスカラー位置を決定します。

すべての2Dユーザーインターフェースオブジェクトのための抽象クラス。

/reference/engine/classes/CanvasGroup.yaml

概要