`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`만 있습니다, 예를 들어 `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로 설정되어 있다고 가정합니다. 드래그를 중지한
위치의 X 및 Y 좌표를 출력합니다. 예를 들어, 플레이어가 189, 180에서 객체의 드래그를
중지하면 아래와 같이 출력됩니다: 플레이어는 GuiObject를 (189, 180)에서 드래그를 중지했습니다.

이 이벤트는 플레이어가 객체를 드래그하는 것을 멈출 때 발생합니다.

또한 `Class.GuiObject.DragBegin`을 참조하세요.

GuiObject.DragStopped

화면의 왼쪽 상단 모서리를 기준으로 한 마우스의 **X** 위치입니다(픽셀 단위).

화면의 왼쪽 상단 모서리를 기준으로 한 마우스의 **Y** 위치입니다(픽셀 단위).

플레이어가 객체를 드래그하는 것을 멈출 때 발생합니다.

다음 예제는 InputBegan에서 사용자 입력을 처리하는 다양한 사용 예제 중 하나를 보여줍니다.

예상대로 작동하려면 `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에서 사용자의 입력을 처리하는 여러 사용 예 중 하나를 보여줍니다.

이 기능이 예상대로 작동하려면 `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 이벤트는 사용자가 GUI 요소인 `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 이벤트는 사용자가 GUI 요소인 `Class.GuiObject`에서 마우스를 이동할 때 발생합니다.

이 이벤트에서 전달된 `x` 및 `y` 인수를 사용하여 사용자의 마우스가 GUI에서 나올 때
위를 판단하는 것은 확실한 방법이 아닙니다. 이러한 좌표는 사용자가 같은 모서리로 GUI에서 나가더라도
변경될 수 있으며, 특히 사용자가 요소에서 빨리 나갈 때는 더욱 그렇습니다. 이는 이 좌표가
이벤트가 발생할 때의 마우스 위치를 나타내기 때문에 실제 마우스가 GUI를 떠나는 순간의 좌표가
아니라는 점 때문입니다.

이 이벤트는 GUI 요소가 다른 요소 아래에 렌더링될 때도 발생합니다.

##### 추가 정보

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

GuiObject.MouseLeave

사용자가 GUI 요소에서 마우스를 이동할 때 발생합니다.

사용자가 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 이벤트는 사용자가 GUI 요소인 `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 이벤트는 사용자가 GUI 요소인 `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_의 자식이어야 합니다.

이 이벤트는 Gamepad 선택기가 `Class.GuiObject`에 포커스를 맞추기 시작할 때 발생합니다.

GUI 요소에 대한 Gamepad 선택기의 포커스가 멈출지 확인하려면 `Class.GuiObject.SelectionLost` 이벤트를 사용하면 됩니다.

GUI가 선택 포커스를 얻으면 `Class.GuiService.SelectedObject|SelectedObject` 속성의 값도 해당 포커스를
얻은 객체로 변경됩니다. 어떤 GUI가 선택 포커스를 얻었는지 확인하려면 이 속성의 값을 확인하세요.

GuiObject.SelectionGained

Gamepad 선택기가 GuiObject에 포커스를 맞출 때 발생합니다.

다음 예제는 게임패드에서 요소의 포커스가 잃어버릴 때 메시지를 출력합니다.

이것이 예상대로 작동하기 위해서는 `LocalScript` 안에 위치하고 _gui_의 자식이어야 합니다.


이 이벤트는 Gamepad 선택기가 `Class.GuiObject`에 대한 포커스를 멈출 때 발생합니다.

GUI 요소에 대한 Gamepad 선택기가 포커스를 시작할지 확인하려면 `Class.GuiObject.SelectionGained` 이벤트를 사용하면 됩니다.

GUI가 선택 포커스를 잃으면 `Class.GuiService.SelectionObject|SelectionObject` 속성의 값이 `nil`로 변경되거나
선택 포커스를 얻는 GUI 요소로 변경됩니다. 어떤 GUI가 선택 포커스를 얻었는지 확인하거나 GUI가 선택되지 않은 경우 이 속성의 값을 확인하세요.

GuiObject.SelectionLost

Gamepad 선택기가 GuiObject의 포커스를 멈출 때 발생합니다.

이 코드 샘플은 플레이어가 UI 요소, 예를 들어 `Frame`의 화면 위치를
짧은 시간 동안 UI 요소를 눌러서 조작할 수 있게 합니다. 그런 다음 플레이어는
손가락을 이동시키고 손을 뗍니다. 제스처 동안 프레임은 흰색 윤곽선의 파란색으로
변합니다.


이 이벤트는 플레이어가 터치 지원 장치를 사용하여 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` 또는 다른 `GuiObject` 내부에 있는 내부 `Frame` 내에서 `LocalScript`에 사용됩니다. 이는 플레이어가 외부 프레임에서 `Class.GuiObject.TouchPinch` 제스처를 수행하여 내부 프레임의 크기를 조절할 수 있게 해줍니다.

이 이벤트는 플레이어가 터치 지원 장치를 사용하여 UI 요소에서 두 손가락으로 집기 또는 당기기 제스처를 할 때 발생합니다. **집기**는 두 개 이상의 손가락이 가까워 질 때 발생하고, **당기기**는 손가락이 멀어질 때 발생합니다. 이 이벤트는 `Class.GuiObject.TouchPan`과 함께 발생합니다. 이 이벤트는 플레이어가 화면에서 UI 요소의 크기(사이즈)를 조작할 수 있도록 하는 데 유용하며, 주로 확대 기능에 사용됩니다.

이 이벤트는 제스처에 관련된 손가락의 상대 화면 위치를 설명하는 `Datatype.Vector2` 테이블과 함께 발생합니다. 또한 여러 번 발생합니다: 짧은 지연 후 `Enum.UserInputState.Begin`, 제스처 동안 플레이어가 손가락을 움직일 때 `Enum.UserInputState.Change`, 마지막으로 `Enum.UserInputState.End`와 함께 발생합니다. 크기는 **곱하기**로 사용되어야 함에 유의해야 합니다.

GuiObject.TouchPinch

scale

집기 제스처의 시작점에서의 차이를 나타내는 부동 소수점 값입니다.

집기 제스처가 얼마나 빠르게 진행되고 있는지를 나타내는 부동 소수점 값입니다.

플레이어가 UI 요소에서 두 손가락을 사용하여 집거나 당기는 제스처를 수행할 때 발생합니다.

이 코드 샘플은 외부 `Frame` 또는 다른 `GuiObject` 내부에 있는 내부 `Frame` 내의 `LocalScript`를 위한 것입니다. 플레이어가 외부 프레임에서 `Class.GuiObject.TouchRotate` 제스처를 수행하여 내부 프레임을 회전할 수 있습니다.

이 이벤트는 플레이어가 터치 지원 장치를 사용하여 UI 요소에서 두 손가락으로 집기 또는 당기기 제스처를 할 때 발생합니다. 두 손가락 사이의 선의 각도가 변할 때 회전이 발생합니다. 이 이벤트는 `Class.GuiObject.TouchPan`과 함께 발생합니다. 이 이벤트는 플레이어가 화면에서 UI 요소의 회전을 조작할 수 있도록 하는 데 유용합니다.

이 이벤트는 제스처에 관련된 손가락의 상대 화면 위치를 설명하는 `Datatype.Vector2` 테이블과 함께 발생합니다. 또한 여러 번 발생합니다: 짧은 지연 후 `Enum.UserInputState.Begin`, 제스처 동안 플레이어가 손가락을 움직일 때 `Enum.UserInputState.Change`, 마지막으로 `Enum.UserInputState.End`와 함께 발생합니다.

GuiObject.TouchRotate

rotation

제스처 시작 지점에서 얼마나 회전했는지를 나타내는 부동 소수점 값입니다.

제스처가 얼마나 빠르게 수행되고 있는지를 나타내는 부동 소수점 값입니다.

플레이어가 UI 요소에서 두 손가락을 사용하여 회전 제스처를 수행할 때 발생합니다.

이 코드 샘플은 터치 가능한 장치(또는 스튜디오의 에뮬레이터)에서 스와이프 제스처를 수행할 때 `Frame`(또는 다른 `GuiObject`)이 튕기도록 합니다.
수평 스와이프는 `Class.GuiObject.BackgroundColor3`의 색조를 변경하고, 수직 스와이프는 채도를 변경합니다.

이 이벤트는 플레이어가 터치 지원 장치를 사용하여 UI 요소에서 스와이프 제스처를 수행할 때 발생합니다. 이 이벤트는 제스처의 방향(위, 아래, 왼쪽 또는 오른쪽)과 제스처에 관련된 터치 포인트의 수와 함께 발생합니다. 스와이프 제스처는 모바일 UI에서 탭을 변경하는 데 자주 사용됩니다.

GuiObject.TouchSwipe

swipeDirection

스와이프 제스처의 방향(위, 아래, 왼쪽 또는 오른쪽)을 나타내는 `Enum.SwipeDirection`입니다.

numberOfTouches

제스처에 관련된 터치 포인트 수(보통 1)입니다.

플레이어가 UI 요소에서 스와이프 제스처를 수행할 때 발생합니다.

이 코드 샘플은 터치가 가능한 장치에서 UI 요소인 `Frame`을 탭할 때 `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

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`를 사용하여
GUI 객체를 새로운 `Datatype.UDim2`로 부드럽게 크기 조정합니다.

이 함수는 트윈이 재생될 것인지 반환합니다. 일반적으로 이 함수는 항상 `true`를 반환하지만, 다른
트윈이 활성화되어 있고 재정의가 `false`로 설정된 경우 `false`를 반환합니다.

또한 `Class.GuiObject:TweenSize()` 및
`Class.GuiObject:TweenSizeAndPosition()`를 참조하세요.

GuiObject:TweenSize

endSize

GUI가 조정해야 하는 크기입니다.

GUI를 _endSize_로 완화할 방향입니다.

GUI를 _endSize_로 완화할 스타일입니다.

GUI 객체를 새로운 `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`가 3D 공간으로 입력을 침수시키는지 여부를 결정합니다. 이는 `Class.ClickDetector` 클래스와 같은 하위 모델에 해당합니다, 예를 들어 `Class.DragDetector`와 같습니다.

`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 요소를 부모 요소의 다양한 측면으로 이동합니다.
시작은 왼쪽 상단에서 하고 끝은 오른쪽 하단에서 합니다. Frame 내의
LocalScript에 붙여넣으세요, ScreenGui 내에서.


이 속성은 `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

이 속성은 `Class.GuiObject` 테두리가 자신의 차원과 관련하여 어떻게 배치되는지를 결정합니다. 동일한 이름의 열거형인 `Enum.BorderMode`를 사용합니다.

`Class.UIStroke`가 이 속성을 재정의하여 더 발전된 테두리 효과를 허용할 수 있습니다.

GuiObject.BorderMode

`Class.GuiObject` 테두리가 차지하는 방식을 결정합니다.

`Class.GuiObject` 테두리의 렌더링 너비를 픽셀 단위로 결정합니다. 이를 `0`으로 설정하면 테두리가 아예 비활성화됩니다.

`Class.UIStroke`가 이 속성을 재정의하여 더 발전된 테두리 효과를 허용할 수 있습니다.

GuiObject.BorderSizePixel

`Class.GuiObject` 테두리의 픽셀 너비를 결정합니다.

모든 2D 사용자 인터페이스 객체에 대한 추상 클래스입니다.

/reference/engine/classes/InputActionLabel.yaml