SetRole

为当前表单设置角色。

语法

expression.SetRole(role);

expression - 表示 ApiComplexForm 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
role	必需	string		将附加到当前表单的角色。

返回值

boolean

示例

此示例展示如何为表单元素设置角色。

const doc = Api.GetDocument();
let paragraph = doc.GetElement(0);

const roles = doc.GetFormRoles();
const rolePr = { "color": "#ffefbf" };
roles.Add("MY_ROLE", rolePr);

const textForm = Api.CreateTextForm({
	"tip": "Enter your first name",
	"required": true,
	"placeholder": "First name",
	"comb": true,
	"maxCharacters": 10,
	"cellWidth": 3,
	"multiLine": false,
	"autoFit": false
});
paragraph.AddElement(textForm);

textForm.SetRole("MY_ROLE");
const role = textForm.GetRole();

paragraph = Api.CreateParagraph();
paragraph.AddText("Form role: " + role);
doc.Push(paragraph);