`Class.GuiButton`은 `Class.GuiObject`로부터 상속받는 추상 클래스입니다.
이 클래스는 인터랙티브하고 클릭 가능한 `Class.ImageButton`과
`Class.TextButton` 객체의 기본 클래스입니다. 이 클래스는 또한
인터랙티브 행동을 위한 여러 속성을 정의합니다. 즉, `Class.GuiButton.AutoButtonColor|AutoButtonColor`
과 `Class.GuiButton.Modal|Modal`입니다.

`Class.GuiButton`의 가장 중요한 이벤트는
`Class.GuiButton.Activated|Activated`로, 버튼이 활성화될 때 발생하는 **멀티 플랫폼 이벤트**입니다.
마우스를 사용할 경우, 이는 버튼을 클릭하고 커서가 여전히 UI 객체 위에 있을 때 버튼을 놓는 것을 의미합니다.
터치의 경우, 버튼을 누르는 대신 터치가 적용됩니다. 마지막으로, 게임패드의 경우,
`Class.GuiButton.Activated|Activated`는 **A** 버튼이 눌렸다 놓였을 때 `Class.GuiButton`이 선택되는 경우에 발생합니다.
간단히 말해, 이 이벤트는 단일 사용자 입력에 대한 훌륭한 일반 인터페이스를 제공하기 때문에
멀티 플랫폼 사용자 인터페이스 프로그래밍에 매우 유용합니다.

데스크탑에서 왼쪽 클릭 누르고 떼는 것이 감지되거나 모바일에서 터치가 떼어지거나, UI 내비게이션 모드에서 **A**/크로스가 활성화되면 발생합니다.

이 이벤트는 서버에서 발생하지 않기 때문에 `Class.LocalScript`에서만 사용해야 하며, `Enum.RunContext.Client`의 `Class.Script.RunContext|RunContext`가 있는 `Class.Script`에서만 사용할 수 있습니다.

GuiButton.Activated

inputObject

clickCount

버튼이 활성화될 때 발생합니다.

이 이벤트는 사용자의 마우스가 `Class.GuiButton`을 완전히 왼쪽 클릭할 때 발생합니다.

클릭과 관련하여 마우스는 `Class.GuiButton`의 범위 내에 있어야 하며 마우스 버튼은
이 이벤트가 발생하기 전에 눌리었다가 다시 올라가야 합니다. 마우스가
`Class.GuiButton`의 범위를 벗어나서 놓이면 이 이벤트는 발생하지 않습니다. 이러한 제한을 피하고 싶다면,
`Class.GuiButton.MouseButton1Down|MouseButton1Down`과
`Class.GuiButton.MouseButton1Up|MouseButton1Up`을 사용할 수 있습니다. 이 이벤트는 사용자가
왼쪽 마우스 버튼을 눌렀을 때 또는 위로 올렸을 때 발생합니다.

GuiButton.MouseButton1Click

사용자의 마우스가 `Class.GuiButton`을 완전히 왼쪽 클릭할 때 발생합니다.

이 이벤트는 사용자가 `Class.GuiButton`에서 왼쪽 마우스 버튼을 눌렀을 때 발생합니다.

이벤트가 발생하기 위해 사용자가 `Class.GuiButton`에서 **누르고** 놓아야 하는
이벤트의 경우, `Class.GuiButton.MouseButton1Click|MouseButton1Click`을 사용하는 것을 고려하세요.

GuiButton.MouseButton1Down

마우스의 **X** 화면 좌표 (픽셀 단위)입니다.

마우스의 **Y** 화면 좌표 (픽셀 단위)입니다.

사용자가 `Class.GuiButton`에서 왼쪽 마우스 버튼을 눌렀을 때 발생합니다.

이 이벤트는 사용자가 `Class.GuiButton`에서 왼쪽 마우스 버튼을 놓았을 때 발생합니다.

이벤트가 발생하기 위해 사용자가 `Class.GuiButton`에서 **누르고** 놓아야 하는
이벤트의 경우, `Class.GuiButton.MouseButton1Click|MouseButton1Click`을 사용하는 것을 고려하세요.

GuiButton.MouseButton1Up

사용자가 `Class.GuiButton`에서 왼쪽 마우스 버튼을 놓았을 때 발생합니다.

이 이벤트는 사용자의 마우스가 `Class.GuiButton`을 완전히 오른쪽 클릭할 때 발생합니다.

클릭과 관련하여 마우스는 `Class.GuiButton`의 범위 내에 있어야 하며 마우스 버튼은
이 이벤트가 발생하기 전에 눌리었다가 다시 올라가야 합니다. 마우스가
`Class.GuiButton`의 범위를 벗어나서 놓이면 이 이벤트는 발생하지 않습니다. 이러한 제한을 피하고 싶다면,
`Class.GuiButton.MouseButton2Down|MouseButton2Down`과
`Class.GuiButton.MouseButton2Up|MouseButton2Up`을 사용할 수 있습니다. 이 이벤트는 사용자가
오른쪽 마우스 버튼을 눌렀을 때 또는 위로 올렸을 때 발생합니다.

GuiButton.MouseButton2Click

사용자의 마우스가 `Class.GuiButton`을 완전히 오른쪽 클릭할 때 발생합니다.

이 이벤트는 사용자가 `Class.GuiButton`에서 오른쪽 마우스 버튼을 눌렀을 때 발생합니다.

이벤트가 발생하기 위해 사용자가 `Class.GuiButton`에서 **누르고** 놓아야 하는
이벤트의 경우, `Class.GuiButton.MouseButton2Click|MouseButton2Click`을 사용하는 것을 고려하세요.

GuiButton.MouseButton2Down

사용자가 `Class.GuiButton`에서 오른쪽 마우스 버튼을 눌렀을 때 발생합니다.

이 이벤트는 사용자가 `Class.GuiButton`에서 오른쪽 마우스 버튼을 놓았을 때 발생합니다.

이벤트가 발생하기 위해 사용자가 `Class.GuiButton`에서 **누르고** 놓아야 하는
이벤트의 경우, `Class.GuiButton.MouseButton2Click|MouseButton2Click`을 사용하는 것을 고려하세요.

GuiButton.MouseButton2Up

사용자가 `Class.GuiButton`에서 오른쪽 마우스 버튼을 놓았을 때 발생합니다.

마우스에서 오른쪽 클릭 눌렀다 떼었을 때, 터치 입력에서 길게 누를 때, 게임패드에서 `R3`가 감지되거나, 키보드를 사용하여 UI 탐색 모드에서 <kbd>Alt</kbd><kbd>Enter</kbd>가 감지될 때 발생합니다.


GuiButton.SecondaryActivated

대체 활성화 행동을 나타내는 입력 객체입니다.

버튼의 "보조" 입력이 활성화될 때 발생합니다.

GuiButton

이 속성은 사용자의 `Class.Mouse`가 버튼 위에 호버하거나 클릭할 때 버튼이
자동으로 색상을 변경할지 여부를 결정합니다. `true`인 경우, 마우스가 버튼 위에
호버하거나 클릭할 때 버튼은 자동으로 색상이 변경됩니다. `false`인 경우,
버튼은 변경되지 않습니다.

사용자의 마우스가 버튼 위에 호버하거나 클릭할 때 버튼의 변화를 커스터마이즈하고 싶다면,
`Class.ImageButton`을 사용하고 요소의 `Class.ImageButton.HoverImage|HoverImage`와
`Class.ImageButton.PressedImage|PressedImage`를 변경하는 것을 고려하세요.

참고로, 이 속성은 `Class.ImageButton`의 `Class.ImageButton.Image|Image` 속성이
이미지로 설정된 경우에는 영향을 미치지 않습니다. 또한, 이 속성은 `Class.ImageButton`
에 대해 `Class.ImageButton.HoverImage|HoverImage`가 `nil`이 아닐 때 마우스 호버 시와,
`Class.ImageButton.PressedImage|PressedImage`가 `nil`이 아닐 때 마우스 클릭 시에 영향을 주지 않습니다.

GuiButton.AutoButtonColor

버튼 위에 마우스가 호버하면 버튼이 자동으로 색상을 변경할지 여부를 결정합니다.

`Class.GuiButton` 위에 마우스가 호버될 때 재생될 `Class.HapticEffect` 인스턴스입니다.

GuiButton.HoverHapticEffect

GUI 요소가 보이는 동안 `true`이면 마우스가 잠기지 않으며,
오른쪽 마우스 버튼이 눌리지 않는 한 잠기지 않습니다.

GuiButton.Modal

GUI 요소가 보이는 동안 `true`이면 오른쪽 마우스 버튼이 눌리지 않는 한
마우스가 잠기지 않습니다.

`Class.GuiButton`이 눌릴 때 재생될 `Class.HapticEffect` 인스턴스입니다.

GuiButton.PressHapticEffect

객체가 선택되었는지 여부를 나타내는 부울 속성입니다.

GuiButton.Selected

미리 결정된 스타일 목록에 따라 `Class.GuiButton`의 스타일을 설정합니다.

GuiButton.Style

인터랙티브 2D 사용자 인터페이스 요소를 위한 추상 클래스입니다.

`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

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