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日