DialogValueEntry() 函数

在屏幕上显示数字小键盘，供用户更改离散、整型或实型标记名的当前值。

类别

其它

语法

[Result=] DialogValueEntry(ValueTag_Text, LowLimit, HighLimit, UserPrompt_Text);

参数

ValueTag_Text

要修改的离散、整型或实型标记的名称。此值是一个字符串值。指定带英文引号括起的标记名，或使用不带英文引号的 .Name 点域。您还可以将消息标记用作指针。

LowLimit

标记的最小值。（这应该是大于等于标记名的最小值、最小原始值或最小工程单位的定义，具体视适用情况而定）。

HighLimit

标记的最大值。（这应该是小于等于标记名的最大值、最大原始值或最大工程单位的定义，具体视适用情况而定）。

UserPrompt_Text

要在数字键盘顶部显示的用户消息。

返回值

返回以下整数值之一：

0 = 已按过“取消”。

1 = 已按过“确定”。

-1 = Highlimit<=Lowlimit.

-2 = 无法启动。

-3 = 未定义标记名。

-4 = 标记名不是“离散”、“整型”或“实型”。

-5 = 写入失败。

附注

此函数主要用在包含触摸屏的应用程序中。

示例

Errmsg=DialogValueEntry(MyIntegerTag.Name, MyIntegerTag.MinEU, MyIntegerTag.MaxEU, "Enter a new value...");

Errmsg=DialogValueEntry("MyIntegerTag", -100, 100, "Enter a new value...");

例如，以下脚本弹出一个数字键盘，在数字键盘顶部显示消息 "Enter a new value..." 期间，允许修改 MyIntegerTag，其最大与最小极限值分别是 -100 与 100：

TagnameX="MyIntegerTag"; {将字符串 MyIntegerTag（ 实际要修改的标记名）分配给内存消息标记名 TagnameX}

Min=-100; {将标记名允许的最小值指定给内存实型/整型标记名 Min}

Max=100; {将标记名允许的最小值指定给内存实型/整型标记名 Max}

MessageDisplay="Enter a new value..."; {将新消息字符串指定给内存消息标记名 MessageDisplay}

Errmsg=DialogValueEntry(TagnameX, Min, Max, MessageDisplay); {不需要引号，因为 TagnameX 被定义为消息标记名。By assigning a Discrete, Integer or Real tagname to TagnameX, the function will modify that assigned tagname}

另请参阅

DialogStringEntry()