formContext.getControl (客户端 API 参考)

获取窗体上的控件。

注释

getControl 仅适用于窗体正文和标题中的控件。 即使控件引用同一列,页面上其他位置也不支持它。

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));

formContext