`InputActionLabel`은 드래그 앤 드롭 가능한 `Class.GuiObject`로, 플레이어의 현재 입력 장치(키보드/마우스, 게임패드, 터치, VR)에 따라 `Class.InputAction`에 대한 적절한 키 또는 아이콘을 자동으로 표시합니다. 플레이어가 장치를 전환하거나 바인딩이 재바인딩되면, 라벨은 스크립트 없이 즉시 업데이트됩니다.

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

이것이 예상대로 작동하려면 `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 이벤트는 사용자가 `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` 오프셋을 결정하는 방법을 보여줍니다.
`Class.GuiObject.AbsolutePosition|AbsolutePosition`은 화면의 GUI 인셋 내부에서 측정되며, 이 이벤트의 `x` 및 `y` 인수는 이를 포함하는 화면 좌표이므로, 샘플은 두 공간을 조정하기 위해 `Class.GuiService:GetGuiInset()|GetGuiInset()`을 호출합니다.

```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 요소 위에서 마우스 휠을 뒤로 스크롤할 때 발생합니다. 이는 `Class.Mouse.WheelBackward`와 유사하며, 사용자의 마우스가 GUI 요소 위에 있는지 여부에 관계없이 발생합니다.

이 이벤트는 휠의 뒤로 스크롤된 움직임을 나타내는 지표로 발생합니다. 이는 이 이벤트의 결과로 `x` 및 `y` 마우스 좌표 인수가 변경되지 않음을 의미합니다. 이러한 좌표는 마우스가 이동할 때만 변경되며, 이는 `Class.GuiObject.MouseMoved` 이벤트로 추적할 수 있습니다.

##### 참조

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

GuiObject.MouseWheelBackward

사용자가 GUI 요소 위에서 마우스 휠을 뒤로 스크롤할 때 발생합니다.

WheelForward 이벤트는 사용자가 GUI 요소 위에서 마우스 휠을 앞으로 스크롤할 때 발생합니다. 이는 `Class.Mouse.WheelForward`와 유사하며, 사용자의 마우스가 GUI 요소 위에 있는지 여부에 관계없이 발생합니다.

이 이벤트는 휠의 앞으로 스크롤된 움직임을 나타내는 지표로 발생합니다. 이는 이 이벤트의 결과로 **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 요소에서 두 손가락으로 집기 또는 당기기 제스처를 수행할 때 발생합니다. **집기**는 두 개 이상의 손가락이 서로 가까워질 때 발생하고, **당기기**는 손가락이 멀어질 때 발생합니다. 이 이벤트는 `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`를 위한 것입니다.
다른 `GuiObject` 내에 있습니다. 플레이어가 외부 프레임에서 `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

플레이어가 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가 크기 조정해야 할 크기입니다.

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 객체의 크기를 자동으로 조정하는 데 사용됩니다. 이 속성을 사용하여 편집 또는 실행 시간에 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` 배경 색상을 결정합니다.

`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

요약