获取窗体上的控件。
注释
getControl 仅适用于窗体正文和标题中的控件。 即使控件引用同一列,页面上其他位置也不支持它。
- 有关 业务流程内的控件,请使用前缀
header_process_引用它们。 - 不支持其他控件(如 子网格 和 时间线控件 )中的控件。
Syntax
formContext.getControl(arg);
formContext.getControl(arg) 方法是用于访问 formContext.ui.controls.get 的快捷方式方法。
参数
arg:可选。 可以通过将参数作为窗体上控件 的名称 或 索引值 传递来访问窗体上的控件。 例如:formContext.getControl("firstname") 或 formContext.getControl(0)。
arg如果名称拼写错误且不在窗体上,则返回 null 值。
arg如果未提供该值,它将返回窗体上所有控件的数组。
返回值
类型:对象集合、对象或 null。
说明:如果使用方法而不使用任何参数,则对象集合。 如果将方法与参数一起使用,则为对象或 null。 如果使用 名称 作为参数,并且同一列有多个控件,则只返回第一个控件。
小窍门
如果要修改绑定到窗体上列的所有控件,请使用列类型内的控件集合。
例如,若要向绑定到 name 列的每个控件添加通知,可以执行以下作:
const notification = {
messages: ['Sample Notification on Name Controls'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));