跳轉到主要內容

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年10月6日