Skip to main content

XGameUiTextEntryOpen

타이틀이 텍스트 렌더링을 담당하는 가상 키보드를 엽니다. 현재 데스크톱에서는 구현되지 않았습니다.

구문

매개 변수

options   _In_
형식: XGameUiTextEntryOptions
배치 및 키보드 구성 등 키보드를 열 때 적용할 초기 옵션 집합을 나타냅니다. maxLength   _In_
형식: uint32_t
사용자가 가상 키보드에서 입력할 수 있는 최대 문자 수입니다. 이 숫자는 32K를 초과할 수 없습니다. initialText   _In__opt_z_
형식: const char*
가상 키보드에 처음에 채워지는 null로 종료된 문자열입니다. initialCursorIndex   _In_
형식: uint32_t
시작 문자를 기준으로 한 커서의 초기 바이트 인덱스입니다. handle   _Out_
형식: XGameUiTextEntryHandle
새로 열린 가상 키보드에 대한 핸들입니다.

반환 값

형식: HRESULT HRESULT 성공 또는 오류 코드입니다. 오류 코드 목록은 오류 코드를 참조하세요.

설명

이 함수는 가상 키보드가 아직 표시되지 않은 경우에도 핸들을 얻는 즉시 반환됩니다. 핸들이 반환되는 즉시 다른 모든 XGameUiTextEntry 함수를 안전하게 호출할 수 있습니다. 다음 예제는 XGameUiTextEntry 함수를 사용하는 기본 방법을 보여 줍니다.

요구 사항

헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

함께 보기

XGameUI
가상 키보드 지원
마지막 수정일 2026년 8월 24일