用户输入

用户输入元素(也称为网页控件)用于将交互式 HMI 元素插入网页。这些元素可用于与电子表格中的控件函数进行交互。

注意

所有的控件元素都有以下事件处理程序脚本点(一些控件元素有附加的事件处理程序脚本点,这些会在它们的说明中列出):

  • On Mouse Enter(鼠标移入时)
  • On Mouse Leave(鼠标移出时)
  • On Mouse Move(鼠标移动时)

有关事件处理程序脚本点的更多信息,请参阅网页元素事件处理程序脚本主题。

元素 说明
按钮

按钮元素用于诸如跳转到另一网页、导致任务运行、与区域图形或电子表格编辑器中的按钮函数交互等操作。

按钮属性包括点击命令属性,该属性提供了一个预定义的与按下按钮动作绑定的可用操作列表。

注意有关详细信息,请参阅按钮点击命令属性主题。

按钮元素有一个附加的事件处理程序脚本点:

  • On Clicked(点击时)
注意 On Clicked 脚本点将在用户每次按下按钮时执行。如果同时设置了点击命令和 On Clicked 脚本点,则点击命令具有优先权,并将在 On Clicked 脚本之前执行。
复选框

复选框元素包含一个交互式复选框和复选框旁的标签。要配置标签的外观和位置,请使用文本部分中的属性文本填充属性确定复选框和文本之间的间距量)。

复选框元素还具有三个附加的事件处理程序脚本点:

  • On Changed(更改时)
  • On Checked(选中时)
  • On Unchecked(取消选中时)
日期时间输入

日期时间输入元素提供了一种显示和/或通过 HMI 输入日期和/或时间的方法。

日期时间输入元素有一个附加的事件处理程序脚本点:

  • On Changed(更改时)
列表框

插入用于显示数据表并与之交互的控件。

列表框元素同样具有三个附加的事件处理程序脚本点:

  • On Selection Changed(选择更改时)
  • On Mouse Up(鼠标上移时)
  • On Mouse Down(鼠标下移时)
多行文本框

插入用于输入多行文本的控件。文本属性可以绑定到标记,然后可以基于作业其他部分(例如用户脚本)更新该标记。

多行文本框元素具有三个附加的事件处理程序脚本点:

  • On Text Change(文本更改时)
  • On Mouse Up(鼠标上移时)
  • On Mouse Down(鼠标下移时)
注意多行文本框元素不支持联机时输入密码。您必须使用文本框 (TextBox) 元素来实现该功能。
数字输入

插入用于输入数值的控件;可以直接输入值,或使用向上和/或向下箭头。

数字输入元素还有一个附加的事件处理程序脚本点:

  • On Value Change(值更改时)
页面控件

插入一个控件以用于访问作业的另一个网页并与之交互。使用页面名称属性的下拉菜单选择该控件元素要显示的网页。

页面控件元素没有任何事件处理程序脚本点。

面板

插入一个可用于将其他 HMI 元素放在其顶部的面板,该面板可用于帮助直观地组织元素并充当多个元素的容器。

注意
  • 如果面板的启用属性被禁用(未选中),则面板上的所有元素也将被禁用。
  • 如果面板的授权属性被启用(选中),则面板上的所有元素也将需要授权(无论单个元素的授权属性设置如何)。有关授权属性的详细信息,请参阅网页元素授权主题。
  • 将具有已发布属性标记的元素放置在面板上时,该元素的路径名称将更改为包含面板的名称。例如,WebPages.WebPageName.PanelName.CheckboxName.Checked
单选按钮

插入一个可以选中或取消选中的交互式双状态按钮并在按钮旁放置标签。要配置标签的外观和位置,请使用文本部分中的属性文本填充属性确定按钮和文本之间的间距量)。

单选按钮元素还具有三个附加的事件处理程序脚本点:

  • On Changed(更改时)
  • On Checked(选中时)
  • On Unchecked(取消选中时)
选择框

插入一个下拉列表控件。

选择框元素还具有三个附加的事件处理程序脚本点:

  • On Selection Changed(选择更改时)
  • On Mouse Up(鼠标上移时)
  • On Mouse Down(鼠标下移时)
滑块

插入一个交互式数值选择器控件,它让用户可通过将控件滑动到所需值来以图形方式选择数值。

滑块元素有一个附加的事件处理程序脚本点:

  • On Value Change(值更改时)
文本框

插入用于输入文本的控件。文本属性可以绑定到标记,然后可以基于作业其他部分(例如用户脚本)更新该标记。

可以启用密码属性以将文本框转换为密码输入文本框,其中的字符将替换为星号。

文本框元素具有三个额外的事件处理程序脚本点:

  • On Text Change(文本更改时)
  • On Mouse Up(鼠标上移时)
  • On Mouse Down(鼠标下移时)