> ## 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.

# XGameUiShowTextEntryAsync

> XGameUiShowTextEntryAsync

# XGameUiShowTextEntryAsync

사용자가 정보를 입력할 수 있도록 텍스트 입력 UI를 표시합니다.

## 구문

```cpp theme={null}
HRESULT XGameUiShowTextEntryAsync(  
         XAsyncBlock* async,  
         const char* titleText,  
         const char* descriptionText,  
         const char* defaultText,  
         XGameUiTextEntryInputScope inputScope,  
         uint32_t maxTextLength  
)  
```

### 매개 변수

*async*   \_In\_<br />형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

[XAsyncRun](/reference/system/xasync/functions/xasyncrun)에 전달되는 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)에 대한 포인터입니다.

*titleText*   \_In\_opt\_z\_<br />형식: char\*

텍스트 입력 UI의 텍스트 제목입니다.

*descriptionText*   \_In\_opt\_z\_<br />형식: char\*

텍스트 입력 UI의 텍스트 설명입니다.

*defaultText*   \_In\_opt\_z\_<br />형식: char\*

텍스트 입력 UI에 처음에 채워지는 기본 텍스트입니다.

*inputScope*   \_In\_<br />형식: [XGameUiTextEntryInputScope](/reference/system/xgameui/enums/xgameuitextentryinputscope)

허용되는 정보 유형을 나타내는 텍스트 입력의 입력 범위를 지정합니다. 이 범위는 게임에서 원하는 텍스트에 대한 힌트를 제공합니다. 게임은 여전히 키보드에서 다시 받는 텍스트의 유효성을 검사해야 합니다.

*maxTextLength*   \_In\_<br />형식: uint32\_t

사용자가 텍스트 입력 UI에서 입력할 수 있는 최대 문자 수입니다. 콘솔에서는 최대 문자 수가 1024자입니다. PC에서는 제한이 없습니다. 값 0을 전달하면 최대 문자 길이가 1024자로 처리됩니다. 또한 \_inputScope\_가 XGameUiTextEntryInputScope::Password인 경우, 최대 길이는 항상 1024자이며 *maxTextLength* 값은 무시됩니다.

### 반환 값

형식: HRESULT

비동기 호출의 HRESULT 성공 또는 오류 코드입니다.

결과를 가져오려면 *AsyncBlock* 콜백 내부 또는 *AsyncBlock* 완료 후 [XGameUiShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize) 및 [XGameUiShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult)를 호출하세요.

## 설명

콘솔에서는 텍스트 입력 필드와 화면 가상 키보드(OSK)가 모두 제공됩니다. Windows에서는 텍스트 입력 필드가 있는 새 창이 제공됩니다. Windows에서는 사용자가 물리적 키보드 대신 화면 키보드를 사용하도록 구성된 경우(예: 태블릿 모드일 때)에만 가상 키보드가 나타납니다.

UI를 호출하면 게임이 *제한 모드(constrained mode)* 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 [XBOX 게임 수명 주기(NDA 항목)](/build/console-features/console-workflows/xbox-game-life-cycle)를 참조하세요.

## 요구 사항

**헤더:** XGameUI.h

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

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

## 함께 보기

[XGameUI](/reference/system/xgameui/xgameui_members)<br />[가상 키보드 지원](/build/core-features/common/input/overviews/virtualkeyboardsupport) [XGameUIShowTextEntryResult](/reference/system/xgameui/functions/xgameuishowtextentryresult)<br />[XGameUIShowTextEntryResultSize](/reference/system/xgameui/functions/xgameuishowtextentryresultsize)<br />[XBOX 게임 수명 주기(NDA 항목)](/build/console-features/console-workflows/xbox-game-life-cycle)


## Related topics

- [XGameUiShowTextEntryResult](/ko/reference/system/xgameui/functions/xgameuishowtextentryresult.md)
- [XGameUiShowTextEntryUiCallback](/ko/reference/system/xgameui/functions/xgameuishowtextentryuicallback.md)
- [XGameUiShowTextEntryResultSize](/ko/reference/system/xgameui/functions/xgameuishowtextentryresultsize.md)
- [XGameUiSetTextEntryUiResponse](/ko/reference/system/xgameui/functions/xgameuisettextentryuiresponse.md)
- [XGameUiTextEntryInputScope](/ko/reference/system/xgameui/enums/xgameuitextentryinputscope.md)