> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiTextEntryGetState

> XGameUiTextEntryGetState

# XGameUiTextEntryGetState

열린 가상 키보드의 현재 상태를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XGameUiTextEntryGetState(  
         XGameUiTextEntryHandle handle,
         XGameUiTextEntryChangeTypeFlags* changeType,
         uint32_t* cursorIndex,
         uint32_t* imeClauseStartIndex,
         uint32_t* imeClauseEndIndex,
         uint32_t bufferSize,
         char* buffer
)  
```

### 매개 변수

*handle*   \_In\_\
형식: XGameUiTextEntryHandle

열린 가상 키보드에 대한 핸들입니다.

*changeType*   \_Out\_\
형식: [XGameUiTextEntryChangeTypeFlags\*](/reference/system/xgameui/enums/xgameuitextentrychangetypeflags)

게임이 마지막으로 *XGameUiTextEntryGetState*를 호출한 이후 텍스트가 변경되었는지 또는
가상 키보드가 해제되었는지를 설명합니다. 변경 유형이 가상 키보드가
해제되었음을 나타내는 경우, 게임은 텍스트 변경 처리를 완료한 후
[XGameUiTextEntryClose](/reference/system/xgameui/functions/xgameuitextentryclose)를 호출해야 합니다.

*cursorIndex*   \_Out\_opt\_\
형식: uint32\_t\*

시작 문자를 기준으로 한 커서의 바이트 인덱스입니다.

*imeClauseStartIndex*   \_Out\_opt\_\
형식: uint32\_t\*

IME 후보로 대체될 수 있는 IME 절의 시작 바이트 인덱스입니다. 이는 커서 인덱스
이전에 있습니다. IME가 사용 중이지 않은 경우 이 값은 0이 됩니다.

*imeClauseEndIndex*   \_Out\_opt\_\
형식: uint32\_t\*

IME 후보로 대체될 수 있는 IME 절의 끝 바이트 인덱스입니다. 이는 커서 인덱스
이후에 있습니다. IME가 사용 중이지 않은 경우 이 값은 0이 됩니다.

*bufferSize*   \_In\_\
형식: uint32\_t

가상 키보드에서 텍스트를 받을 게임 제공 버퍼의 크기(바이트)입니다.

*buffer*   \_Out\_\
형식: char\*

가상 키보드에 입력된 전체 텍스트로, null로 종료된 문자열입니다. 개행은
'\n'으로 표시됩니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다. 오류 코드 목록은 [오류 코드](/reference/errorcodes)를 참조하세요.

| 반환 코드                            | 설명                                                                        |
| -------------------------------- | ------------------------------------------------------------------------- |
| S\_OK                            | 작업이 성공했습니다.                                                               |
| E\_GAMEUI\_TEXTENTRY\_NOT\_SHOWN | XGameUiTextEntryHandle이 유효하지 않습니다. XGameUiTextEntryOpen을 호출해야 할 가능성이 큽니다. |

## 설명

최신 가상 키보드 변경 사항을 얻으려면 이 함수를 프레임당 최소 한 번 호출해야 합니다.
나중에 키보드가 해제되면 함수는 성공적으로 반환되지만, 변경 유형에는
KeyboardDismissed가 포함됩니다.

## 요구 사항

**헤더:** XGameUI.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XGameUI](/reference/system/xgameui/xgameui_members)\
[XGameUiTextEntryOpen](/reference/system/xgameui/functions/xgameuitextentryopen)
[XGameUiTextEntryClose](/reference/system/xgameui/functions/xgameuitextentryclose)


## Related topics

- [XGameUiTextEntryChangeTypeFlags](/ko/reference/system/xgameui/enums/xgameuitextentrychangetypeflags.md)
- [XGameUI](/ko/reference/system/xgameui/xgameui_members.md)
- [XGameUiTextEntryGetExtents](/ko/reference/system/xgameui/functions/xgameuitextentrygetextents.md)
- [XGameUiTextEntryExtents](/ko/reference/system/xgameui/structs/xgameuitextentryextents.md)
- [XGameUiSetTextEntryUiResponse](/ko/reference/system/xgameui/functions/xgameuisettextentryuiresponse.md)