XGameUiTextEntryGetState
열린 가상 키보드의 현재 상태를 가져옵니다.구문
매개 변수
handle _In_형식: XGameUiTextEntryHandle 열린 가상 키보드에 대한 핸들입니다. changeType _Out_
형식: XGameUiTextEntryChangeTypeFlags* 게임이 마지막으로 XGameUiTextEntryGetState를 호출한 이후 텍스트가 변경되었는지 또는 가상 키보드가 해제되었는지를 설명합니다. 변경 유형이 가상 키보드가 해제되었음을 나타내는 경우, 게임은 텍스트 변경 처리를 완료한 후 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 성공 또는 오류 코드입니다. 오류 코드 목록은 오류 코드를 참조하세요.설명
최신 가상 키보드 변경 사항을 얻으려면 이 함수를 프레임당 최소 한 번 호출해야 합니다. 나중에 키보드가 해제되면 함수는 성공적으로 반환되지만, 변경 유형에는 KeyboardDismissed가 포함됩니다.요구 사항
헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
XGameUIXGameUiTextEntryOpen XGameUiTextEntryClose