dbg_text_input

此函数在当前调试部分中创建一个文本字段。

默认情况下，文本输入修改作为字符串变量引用的变量。您可以通过将可选的 type 参数设置为以下值之一来更改此 数据类型 ：

• "s" 或 "t"：一个字符串，typeof 返回 "string"
• "i" 或 "d"：一个整数，typeof 返回 "int64"
• "f"、"r" 或 "g"：实数，typeof 返回 "number"

文本字段还接受十六进制和二进制作为整数和实数的输入，即 0xcafebabe 或 0b1010101。它将该输入转换为给定数据类型的正确值。

警告 如果引用的变量存储的值与您提供给此函数的类型不同，则您对文本所做的任何更改都将更改引用的变量的类型。

注意 在 Android 上，编辑文本字段将显示屏幕键盘。

语法:

dbg_text_input(ref[, label, type]);

返回:

N/A

示例1：基本使用

Create Event

description = "This description can be changed";
var _ref = ref_create(self, "description");
dbg_text_input(_ref, "Enter the description here:");

上面的代码首先将一些文本赋给实例变量description。然后使用ref_create创建对此变量的引用。接下来，它使用dbg_text_input创建一个文本输入控件，引用将该控件链接到变量。

示例 2：自定义数据类型

Create Event

an_integer = 5;
a_real = 0.3583;
a_string = "3289430";

ref_to_count = ref_create(self, "an_integer");
ref_to_some_value = ref_create(self, "a_real");
ref_to_a_string = ref_create(self, "a_string");

dbg_text_input(ref_to_count, "An Integer", "i");
dbg_text_input(ref_to_some_value, "A Real", "f");
dbg_text_input(ref_to_a_string, "A String", "s");

Draw Event

draw_text(5, 600, $"An Integer ({typeof(an_integer)}): {an_integer}");
draw_text(5, 620, $"A Real ({typeof(a_real)}): {a_real}");
draw_text(5, 640, $"A String ({typeof(a_string)}): {a_string}");

此代码示例演示如何将自定义数据类型与文本输入调试控件结合使用。

在对象的 Create 事件中，首先定义几个变量。它们被分配一个实数、另一个实数和一个字符串值。然后，创建对每个实例变量的引用。之后，使用 dbg_text_input 创建文本输入，并通过对每个变量的引用来修改这些变量。对 dbg_text_input 的函数调用将调出 调试叠加层 ，因此无需调用 show_debug_overlay。

在对象的 Draw 事件中，使用每个变量的 draw_text 显示一行文本。每行显示描述性文本和括号之间的值类型，后跟值本身。文本输入中所做的任何更改都将显示在绘制的文本中。

请注意，一旦您在其文本输入控件中进行更改，第一个变量的类型就会立即从 "number" 更改为 "int64"。