다음을 통해 공유

XGameUiShowTextEntryAsync

  • 아티클

사용자가 정보를 입력하기 위한 텍스트 입력 UI를 표시합니다.

구문

HRESULT XGameUiShowTextEntryAsync(  
         XAsyncBlock* async,  
         const char* titleText,  
         const char* descriptionText,  
         const char* defaultText,  
         XGameUiTextEntryInputScope inputScope,  
         uint32_t maxTextLength  
)

매개 변수

async _In_
형식: XAsyncBlock*

XAsyncRun에 전달된 XAsyncBlock에 대한 포인터입니다.

titleText _In_opt_z_
형식: char*

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

descriptionText _In_opt_z_
형식: char*

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

defaultText _In_opt_z_
형식: char*

텍스트 입력 UI에 최초로 입력된 기본 텍스트입니다.

inputScope _In_
형식: XGameUiTextEntryInputScope

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

maxTextLength _In_
형식: uint32_t

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

반환 값

형식: HRESULT

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

결과를 가져오기 위해 AsyncBlock 콜백 내에서 또는 AsyncBlock이 완료된 후에 XGameUiShowTextEntryResultSize 및 XGameUiShowTextEntryResult를 호출합니다.

비고

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

UI를 호출하면 게임이 제한 모드로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 시스템 리소스를 적게 받게 됩니다. 타이틀의 제한 모드 및 기타 운영 모드에 대한 자세한 내용은 Xbox 게임 수명 주기(NDA 항목)를 참조하세요.

요구 사항

헤더: XGameUI.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameUI
가상 키보드 지원XGameUIShowTextEntryResult
XGameUIShowTextEntryResultSize
Xbox 게임 수명 주기(NDA 항목)