方法
Cell.bind(type, data, fn)
描述
为被选单元格添加一个或多个事件处理程序,并规定事件发生时运行的函数。
参数说明
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
type | string | 是 | 表示事件类型的字符串。单元格支持的事件请参考 CellEvents类 。 |
data | any | 否 | 可选参数,如果不忽略表示给事件处理函数传递的自定义参数。 |
fn | function | 是 | 事件处理函数。 |
返回值
无
示例
下面的示例代码中,通过bind方法,给按钮添加点击事件,当单击按钮时,弹出一个警告框。
示例一:
//给按钮绑定点击事件处理函数 var onClick = function(arg) { alert("活字格"); } //获取当前页面 var page = Forguncy.Page; //获取当前页面上名称为button的按钮 var cell = page.getCell("button"); //绑定单元格的事件 cell.bind("click", onClick);
示例二:
//需要给事件处理函数传递自定义参数: //定义参数 var text = "活字格"; //获取当前页面 var page = Forguncy.Page; //获取当前页面上名称为button的按钮 var cell = page.getCell("button"); //绑定单元格的事件 cell.bind("click", text, function (arg) { alert(arg.data); });
操作步骤
在设计器的页面中,选择一个单元格区域,设置其单元格类型为按钮,并命名为“button”。
在页面设置中,编辑页面加载时命令为“JavaScript命令”,并输入JavaScript代码。
编辑完成后,单击“确定”关闭对话框。
运行页面,在页面中单击按钮后,就会弹出警告框,警告框中内容为给事件处理函数传递的自定义参数。