Skip to main content

XGameUiTextEntryGetState

開いている仮想キーボードの現在の状態を取得します。

Syntax

Parameters

handle   _In_
型: XGameUiTextEntryHandle
開いている仮想キーボードへのハンドル。 changeType   _Out_
型: XGameUiTextEntryChangeTypeFlags*
ゲームが XGameUiTextEntryGetState を最後に呼び出してから、テキストが変更されたか、仮想キーボードが 閉じられたかを示します。変更の種類が仮想キーボードが閉じられたことを示している場合、ゲームはテキストの 変更処理が完了した時点で XGameUiTextEntryClose を呼び出す必要があります。 cursorIndex   _Out_opt_
型: uint32_t*
先頭文字を基準としたカーソルのバイト インデックス。 imeClauseStartIndex   _Out_opt_
型: uint32_t*
IME 候補で置き換えられる可能性がある IME 文節の開始バイト インデックス。この値はカーソル インデックスより前になります。 IME が使用されていない場合、この値はゼロになります。 imeClauseEndIndex   _Out_opt_
型: uint32_t*
IME 候補で置き換えられる可能性がある IME 文節の終了バイト インデックス。この値はカーソル インデックスより後になります。 IME が使用されていない場合、この値はゼロになります。 bufferSize   _In_
型: uint32_t
仮想キーボードからのテキストを受け取るゲーム提供バッファーのサイズ (バイト単位)。 buffer   _Out_
型: char*
仮想キーボードに入力された完全なテキスト (null 終端文字列)。改行は ‘\n’ として表されます。

Return value

型: HRESULT HRESULT の成功またはエラー コード。エラー コードの一覧については、Error Codes を参照してください。

Remarks

この関数は、最新の仮想キーボードの変更を取得するために、フレームごとに少なくとも 1 回呼び出す必要があります。 キーボードが後で閉じられた場合、関数は正常に返りますが、変更の種類には KeyboardDismissed が含まれます。

Requirements

ヘッダー: XGameUI.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

See also

XGameUI
XGameUiTextEntryOpen XGameUiTextEntryClose
最終更新日 2026年8月24日