keyboard_virtual_show

此函数可用于在运行游戏的设备上显示虚拟键盘。调用此函数时，需要为前三个参数中的每个参数提供以下常量之一：

• Keyboard type：该常量用于设置虚拟键盘上可用的键集。可用的键盘类型有：

• 返回类型: 此常量用于设置虚拟键盘的Return/action键上显示的内容。可用的返回类型为:

• 自动大写类型：此常量用于确定通过虚拟键盘键入的单词应如何自动大写。可用的自动大写类型包括：

最后一个参数是启用/禁用预想英文输入法，这将被设置为true以允许它，否则设置为false，但请注意，仅仅因为它被允许并不意味着它将被使用，因为这将取决于用户在设备上的偏好。在预想英文输入法模式下，虚拟键盘不会生成正常的GameMaker按键事件。相反，它将只更新最后一个按下的字符和键盘字符串变量。这是由于无法检测用于检测按键的内部文本字段中的变化是来自实际的虚拟键盘键还是来自文本建议。在这些情况下，您可能希望读取keyboard_string输入，而不是读取任何类型的原始按键输入。

还需要注意的是，根据平台操作系统的不同，用户将获得具有不同函数的不同键盘，每个目标的使用注意事项如下：

• Android：在 Android 上，不支持键盘类型kbv_type_phone_name，而是显示 ASCII 键盘，返回键类型只能是kbv_returnkey_go、kbv_returnkey_send或kbv_returnkey_done。如果在该平台上使用其他返回密钥类型，则系统将默认为下面列出的替换返回密钥：

• AndroidTV/ FireTV：ASCII 键盘不支持自定义返回键类型——将始终显示默认返回键。


• tvOS：tvOS 不支持预测文本和自动大小写，系统事件和函数keyboard_virtual_height()返回的键盘高度将默认为屏幕高度，因为它横跨整个屏幕，也因为在 tvOS 上禁用了键盘矩形尺寸函数。另请注意，除非打开虚拟键盘，否则不会广播物理(蓝牙)键盘事件。
• Xbox GDK: See this Helpdesk article

调用此函数将生成系统异步事件，其中 async_load DS 映射将填充以下键/值对：

• “event_type”-当由虚拟键盘函数触发时，这将是 “虚拟键盘状态”。


• “screen_height”-虚拟键盘的高度(以像素为单位)。如果键盘不可见，则该值将为 0。


• "keyboard_status" - 键盘的当前状态，作为以下字符串之一返回：
  • "hiding"
  • "hidden"
  • "showing"
  • "visible"

语法

keyboard_virtual_show(keyboard_type, return_key_type, autocapitalization_type, predictive_text_enabled);

返回:

N/A

例子:

if (input == false)
{
    input = true;
    keyboard_virtual_show(kbv_type_numbers, kbv_returnkey_default, kbv_autocapitalize_none, false);
}

如果给定的变量未设置为true，则上面的代码将调出操作系统虚拟键盘。