`InputActionLabel`は、プレイヤーの現在の入力デバイス（キーボード/マウス、ゲームパッド、タッチ、VR）に基づいて、適切なキーまたはアイコンを自動的に表示するドラッグアンドドロップの`Class.GuiObject`です。プレイヤーがデバイスを切り替えたり、バインディングが再バインドされると、ラベルはスクリプトなしで瞬時に更新されます。

`InputActionLabel`のレンダリングは、`Class.InputAction`（`Class.InputActionLabel.InputAction`を介してリンクされている）と、そのアクションの子`Class.InputBinding|InputBindings`に依存します。ラベルが表示する内容を解決する際、次の順序に従います：

1. **カスタム画像** — 子の`Class.InputBinding|InputBindings`に`Class.InputBinding.DisplayImage|DisplayImage`プロパティが設定されている場合、ラベルはそれらの画像を直接レンダリングし、オプションで`Class.InputActionLabel.ImageColor3|ImageColor3`および`Class.InputActionLabel.ImageTransparency|ImageTransparency`で修正されます。

2. **プラットフォームキー画像** — カスタム画像がない場合、ラベルは子の`Class.InputBinding|InputBindings`のためにプラットフォーム提供の画像を`Class.UserInputService:GetImageForKeyCode()`を介してレンダリングします。複合バインディングには、`+`区切りで複数のアイコンが表示されます。

3. **カスタム名** — 利用可能な画像がない場合、子の`Class.InputBinding|InputBindings`に`Class.InputBinding.DisplayName|DisplayName`プロパティが設定されている場合、ラベルはそのテキストを`Class.InputActionLabel.FontFace|FontFace`、`Class.InputActionLabel.TextColor3|TextColor3`、`Class.InputActionLabel.TextSize|TextSize`、`Class.InputActionLabel.TextTransparency|TextTransparency`、`Class.InputActionLabel.TextWrapped|TextWrapped`、`Class.InputActionLabel.TextXAlignment|TextXAlignment`、および`Class.InputActionLabel.TextYAlignment|TextYAlignment`で定義されたスタイルでレンダリングします。

4. **プラットフォームキー文字列** — 上記のすべてがない場合、ラベルは`Class.UserInputService:GetStringForKeyCode()`を介してプラットフォーム提供の文字列をレンダリングします。

5. `Class.InputAction`が割り当てられていないか、子の`Class.InputBinding`が存在しない場合、ラベルはプレースホルダーアイコンを表示します。


InputActionLabel

このプロパティは`Class.TextLabel.FontFace`に似ており、ラベルがテキストモードでレンダリングされるときに使用されるフォントファミリー、ウェイト、およびスタイルを決定します。


InputActionLabel.FontFace

テキストをレンダリングするために使用されるフォントを決定します。


このプロパティは、ラベル画像の色付け方法を決定します。白に設定すると、色付けは行われません。このプロパティは画像アセットを再利用するのに便利です。ソース画像が完全に白で透明な場合、このプロパティでラベル全体の色を一度に設定できます。


InputActionLabel.ImageColor3

レンダリングされたラベル画像の色付け方法を決定します。


このプロパティは、レンダリングされたラベル画像のアルファを決定します。`0`の値は完全に不透明で、`1`の値は完全に透明（見えない）です。


InputActionLabel.ImageTransparency

レンダリングされたラベル画像の透明度を決定します。


ラベルが自動的に解決してその優先バインディングを表示する`Class.InputAction`インスタンスです。バインディングが変更されると（再バインドや入力デバイスの切り替えによって）、ラベルは自動的に更新されます。

これを`nil`に設定すると、表示がクリアされ、プレースホルダーが表示されます。


InputActionLabel.InputAction

このラベルが表示する優先バインディングの`Class.InputAction`。


ラベルが画像モードでレンダリングされるときの最初の解決された画像の`Datatype.Content`を含みます。テキストまたはプレースホルダーモードのときは空です。これは、バインディングが解決されるときにエンジンによって設定される読み取り専用プロパティです。


InputActionLabel.ResolvedImageContent

現在表示されている解決された画像コンテンツ。


ラベルがテキストモードでレンダリングされるときの`Ctrl + Shift + Space`のような構成されたキー名文字列を含みます。ラベルが画像またはプレースホルダーモードでレンダリングされるときは空です。これは、バインディングが解決されるときにエンジンによって設定される読み取り専用プロパティです。


InputActionLabel.ResolvedText

現在表示されている解決されたキー名文字列。


このプロパティは、ラベルによってレンダリングされるすべてのテキストの色を決定します。


InputActionLabel.TextColor3

レンダリングされたテキストの色を決定します。


テキストモードのレンダリングのためのフォントサイズをピクセル単位で制御します。値は`1`と`200`の間に制限されます。


InputActionLabel.TextSize

オフセット内のテキストの行の高さを決定します。


このプロパティは、ラベルによってレンダリングされるすべてのテキストの透明度を決定します。


InputActionLabel.TextTransparency

レンダリングされたテキストの透明度を決定します。


`true`の場合、テキストはラベルのスペース内で複数行にレンダリングされ、`Class.InputActionLabel.TextSize|TextSize`の行がオブジェクトの`Class.GuiBase2d.AbsoluteSize`を超えないようにします。これは、長いテキストの行を複数行に分割することで実現されます。


InputActionLabel.TextWrapped

テキストがラベルのスペース内で複数行に折り返すかどうかを決定します。


このプロパティは、ラベルのスペース内でレンダリングされるテキストの水平揃えを決定します。


InputActionLabel.TextXAlignment

レンダリングされたテキストの水平揃えを決定します。


このプロパティは、ラベルのスペース内でレンダリングされるテキストの垂直揃えを決定します。


InputActionLabel.TextYAlignment

レンダリングされたテキストの垂直揃えを決定します。


アクションのキー割り当てをテキストまたは画像として自動的に表示する`Class.GuiObject`です。


`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`がレンダリングされるかどうかを決定します。

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

/reference/engine/classes/InputActionLabel.yaml

概要