Skip to main content

XGameUiTextEntryOpen

タイトルがテキストのレンダリングを担当する仮想キーボードを開きます。デスクトップ上では現在 未実装です。

Syntax

Parameters

options   _In_
型: XGameUiTextEntryOptions
キーボードを開くときに適用する初期オプション (配置やキーボード構成など) の セットを示します。 maxLength   _In_
型: uint32_t
ユーザーが仮想キーボードで入力できる最大文字数。この数は 32K を超えることは できません。 initialText   _In__opt_z_
型: const char*
仮想キーボードに最初に表示される null 終端の文字列。 initialCursorIndex   _In_
型: uint32_t
先頭文字を基準としたカーソルの初期バイト インデックス。 handle   _Out_
型: XGameUiTextEntryHandle
新しく開いた仮想キーボードへのハンドル。

Return value

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

Remarks

この関数は、仮想キーボードがまだ表示されていない場合でも、ハンドルを取得でき次第すぐに返ります。 その他のすべての XGameUiTextEntry 関数は、ハンドルが返されたらすぐに安全に呼び出せます。 次の例は、XGameUiTextEntry 関数を使用する基本的な方法を示しています。

Requirements

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

See also

XGameUI
仮想キーボードのサポート
最終更新日 2026年8月24日