# UserInputState

## Overview

UserInputState는 현재 발생 중이거나 최근에 완료된 사용자 입력 동작의 상태를 나타내는 Enum입니다.

InputObject의 UserInputState 속성과 UserInputService, GuiObject의 다양한 이벤트에서 널리 사용됩니다. 입력 타입(Enum.UserInputType)에 따라 Enum의 동작이 달라질 수 있습니다.

## Items

| Name   | Value | Description                                                                                        |
| ------ | ----- | -------------------------------------------------------------------------------------------------- |
| Begin  | 0     | InputObject가 게임과 상호작용을 시작할 때 발생합니다. 예: 키를 누르거나, 마우스 버튼을 누르거나, 터치가 시작될 때.                           |
| Change | 1     | 지속적인 입력 중 상태가 계속 변경될 때 발생하는 상태입니다. 예: 마우스 이동, 게임패드 썸스틱 이동, 터치 드래그 등.                               |
| End    | 2     | InputObject와의 상호작용이 종료될 때 발생하는 상태입니다. 예: 키를 놓거나, 마우스 버튼에서 손을 떼거나, 터치가 끝날 때.                        |
| Cancel | 3     | 입력이 더 이상 바인딩된 액션과 관련이 없을 때 발생하는 상태입니다. 주로 ContextActionService와 함께 사용됩니다. 예: 입력이 바인딩 해제되거나 재할당될 때. |
| None   | 4     | 특정 상태를 나타내지 않는 기본값입니다.                                                                             |

## See also

{% content-ref url="/pages/LYv0TpZ6tsx68rvMhJug" %}
[InputObject](/korean/development/api-reference/classes/inputobject.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/enums/userinputstate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.