`InputActionLabel` is a drag-and-drop `Class.GuiObject` that automatically
shows the appropriate key or icon for an `Class.InputAction` based on the
player's current input device (keyboard/mouse, gamepad, touch, VR). When the
player switches devices or the binding is rebound, the label updates instantly
without scripting.

Rendering of the `InputActionLabel` depends on the `Class.InputAction` (linked
through `Class.InputActionLabel.InputAction`) and that action's child
`Class.InputBinding|InputBindings`. As the label resolves what to show, it
follows this order:

1. **Custom Images** — If child `Class.InputBinding|InputBindings` have their
   `Class.InputBinding.DisplayImage|DisplayImage` property set, the label
   renders those images directly, optionally modified by
   `Class.InputActionLabel.ImageColor3|ImageColor3` and
   `Class.InputActionLabel.ImageTransparency|ImageTransparency`.

2. **Platform Key Images** — Lacking custom images, the label renders
   platform-provided images for child `Class.InputBinding|InputBindings`
   through `Class.UserInputService:GetImageForKeyCode()`, if such images are
   available. Composite bindings with modifiers show multiple icons with `+`
   separators.

3. **Custom Names** — Lacking available images, if child
   `Class.InputBinding|InputBindings` have their
   `Class.InputBinding.DisplayName|DisplayName` property set, the label
   renders that text in a style defined by
   `Class.InputActionLabel.FontFace|FontFace`,
   `Class.InputActionLabel.TextColor3|TextColor3`,
   `Class.InputActionLabel.TextSize|TextSize`,
   `Class.InputActionLabel.TextTransparency|TextTransparency`,
   `Class.InputActionLabel.TextWrapped|TextWrapped`,
   `Class.InputActionLabel.TextXAlignment|TextXAlignment`, and
   `Class.InputActionLabel.TextYAlignment|TextYAlignment`.

4. **Platform Key Strings** — Lacking all of the above, the label renders
   platform-provided strings through
   `Class.UserInputService:GetStringForKeyCode()`.

5. If no `Class.InputAction` is assigned or no child `Class.InputBinding`
   exists, the label renders a placeholder icon.


InputActionLabel

This property is similar to `Class.TextLabel.FontFace` and determines the
font family, weight, and style used when the label renders in a text mode.


InputActionLabel.FontFace

Determines the font used to render text.


This property determines how label images are colorized. When set to
white, no colorization occurs. This property is useful for reusing image
assets; if the source images are completely white with transparency, you
can set the entire label color at once with this property.


InputActionLabel.ImageColor3

Determines how rendered label images will be colorized.


This property determines the alpha of rendered label images. A value of
`0` is completely opaque and a value of `1` is completely transparent
(invisible).


InputActionLabel.ImageTransparency

Determines the transparency of rendered label images.


The `Class.InputAction` instance for which to have the label automatically
resolve and display its preferred binding. When the binding changes (due
to rebinding or input device switching), the label updates automatically.

Setting this to `nil` clears the display and shows the placeholder.


InputActionLabel.InputAction

The `Class.InputAction` whose preferred binding this label displays.


Contains the `Datatype.Content` of the first resolved image when the label
renders in an image mode. Empty when in text or placeholder mode. This is
a read-only property set by the engine when the binding resolves.


InputActionLabel.ResolvedImageContent

Read-only. The resolved image content currently being displayed.


Contains the composed key name string such as `Ctrl + Shift + Space` when
the label renders in text mode. Empty when the label renders in image or
placeholder mode. This is a read-only property set by the engine when the
binding resolves.


InputActionLabel.ResolvedText

The resolved key name string currently being displayed.


This property determines the color of all text rendered by the label.


InputActionLabel.TextColor3

Controls the font size in pixels for text mode rendering. Value is clamped
between `1` and `200`.


InputActionLabel.TextSize

Determines the line height of text in offsets.


This property determines the transparency of all text rendered by the
label.


InputActionLabel.TextTransparency

Determines the transparency of rendered text.


When `true`, text renders on multiple lines within the label's space so
that `Class.InputActionLabel.TextSize|TextSize` lines never exceed the
`Class.GuiBase2d.AbsoluteSize` of the object. This is achieved by breaking
long lines of text into multiple lines.


InputActionLabel.TextWrapped

Determines if text wraps to multiple lines within the label's space.


This property determines the horizontal alignment of text rendered within
the label's space.


InputActionLabel.TextXAlignment

Determines the horizontal alignment of rendered text.


This property determines the vertical alignment of text rendered within
the label's space.


InputActionLabel.TextYAlignment

Determines the vertical alignment of rendered text.


A `Class.GuiObject` that automatically displays the keybinding for an action
as text or an image.


`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`だけです。

以下の例は、`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` からユーザー入力を処理する多くの使用例の1つを示しています。

これが期待通りに機能するためには、`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、画面でのマウスの位置を確定するのに役立ち、また、グローバル変数で追跡されている場合には、マウスの前の位置からのデルタを示すのにも役立ちます。

以下のコードは、GUI要素に対するユーザーのマウスの`Datatype.Vector2`オフセットを決定する方法を示しています:

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

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

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	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 - 36))
	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イベントは、ユーザーが`Class.GuiObject`要素の上でマウスホイールを後方にスクロールすると発火します。これは、ユーザーのマウスが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イベントは、ユーザーが`Class.GuiObject`要素の上でマウスホイールを前方にスクロールすると発火します。これは、ユーザーのマウスが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への焦点を停止したときに発火します。

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

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

GuiObject.TouchLongPress

touchPositions

ジェスチャーに関与する指の**相対的**な位置を記述する`Datatype.Vector2`の配列。

state

`Enum.UserInputState`はジェスチャーの状態を示します:

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

プレイヤーがUI要素の長押しを開始、続行、停止すると発火します。

このコードサンプルは、外側の `Frame` 内にある内側の `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` または他の `GuiObject` の内部にある
内部 `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要素上で二本の指を使ってピンチまたはプルジェスチャーを行うと発火します。

このコードサンプルは、外側の `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

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

rotation

ジェスチャーの開始時から回転がどれだけ進んだかを示す浮動小数点数。

ジェスチャーが実行されている速度を示す浮動小数点数。

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

このコードサンプルは、タッチ対応デバイス（またはスタジオのエミュレーター）でスワイプジェスチャーが行われたときに、`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

ジェスチャーに関与する指の**相対的**
位置を記述する`Datatype.Vector2`の配列。

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

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


指定した時間内に指定した `Enum.EasingDirection` と `Enum.EasingStyle` を使用して、GUIを新しい `Datatype.UDim2` の位置に滑らかに移動します。

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

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

GuiObject:TweenPosition

endPosition

easingDirection

_endPosition_ に向けてGUIを穏やかに移動させる方向。

easingStyle

_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

_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

_endSize_ および _endPosition_ に向けてGUIを穏やかに移動させる方向。

_endSize_ および _endPosition_ に対して穏やかに移動させるスタイル。

GUIを新しいサイズと位置に滑らかに移動します。

GuiObject

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

このプロパティは、`Class.GuiObject`が`Class.ClickDetector`クラス（`Class.DragDetector`など）を持つ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`の値を`Enum.AutomaticSize|None`以外に設定すると、この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`の背景色を決定します。

このプロパティは`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`の境界のピクセル幅を決定します。

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

/reference/engine/classes/InputActionLabel.yaml