XGameUiShowTextEntryAsync
사용자가 정보를 입력할 수 있도록 텍스트 입력 UI를 표시합니다.구문
매개 변수
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를 호출하면 게임이 제한 모드(constrained mode) 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 XBOX 게임 수명 주기(NDA 항목)를 참조하세요.요구 사항
헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
XGameUI가상 키보드 지원 XGameUIShowTextEntryResult
XGameUIShowTextEntryResultSize
XBOX 게임 수명 주기(NDA 항목)