FR的事件

Bertha 。 2021-12-12 03:21 281阅读 0赞

## 1. 事件分类编辑 ##

根据事件的位置不同，FineReport报表中有以下几种事件：

*  **控件事件**：是指在控件里面添加的事件，控件包括填报控件和参数(报表)控件，控件介绍请查看 [控件类型][Link 1]；
 *  **Web 页面事件**：是指在模板>模板 Web 属性>分页预览设置/填报页面设置/数据分析设置中添加的事件，请参照 [模板 Web 属性][Web]；
 *  **按钮自定义事件**：是指报表工具栏上添加自定义按钮时，在按钮上添加的事件；
 *  **填报提交事件**：是指在模板>报表填报属性中添加的事件。

### 1.1 控件事件 ###

如下图，在填报页面添加一个文本控件，切换到事件编辑页签，点击添加按钮，即可看到该控件可添加的控件事件：  
![1533630797iBOTxC9V.png][]

控件事件的详细介绍请查看 [控件事件][Link 2]。

### 1.2 Web 页面事件 ###

如下图，选择模板>模板 Web 属性>分页预览设置，下拉框选择为该模板单独设置，点击下方的添加按钮，即可看到分页预览设置里面能添加的所有 Web 页面事件：

Web 页面事件的详细介绍请查看 [Web 页面事件][Web 1]。

### 1.3 按钮自定义事件 ###

如下图，在分页预览设置页面的工具栏上添加一个自定义按钮，双击添加的按钮，进入按钮编辑界面，选中自定义按钮：  
![1533630904rIlVHN4f.png][]

按钮自定义事件与控件事件的事件执行方式是一致的，所有适用于控件事件的方法均适用于按钮自定义事件。

### 1.4 填报提交事件 ###

填报提交事件包括 [填报自定义提交][Link 3] 和设置提交事件，自定义提交这里就不再讲述，只介绍提交事件。

如下图，在模板>报表填报属性中添加一个内置 SQL，即可添加提交事件：

![1533630970A2uU6ck9.png][]

填报提交事件是在上面的入库 SQL 语句执行一句就触发一次，即提交一条记录就触发一次。

注：填报提交事件设置界面与报表填报属性界面一致，即表示提交事件的设置方式与填报属性设置方式一致，详情请参照[报表填报属性][Link 4]。

## 2. 事件响应方式编辑 ##

不论是哪种事件，都需要有事件的响应方式来执行事件，FineReport 不同的事件有不同的事件响应方式，下面一一介绍其对应关系：

<table style="width:600px;"> 
 <tbody> 
  <tr> 
   <th>&nbsp;&nbsp;</th> 
   <th>控件事件&nbsp;&nbsp;</th> 
   <th>Web 页面事件&nbsp;&nbsp;</th> 
   <th>&nbsp; 按钮自定义事件</th> 
   <th>填报提交事件&nbsp;&nbsp;</th> 
  </tr> 
  <tr> 
   <td>&nbsp; JavaScript</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 提交入库</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 自定义提交</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp; √</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 发送邮件</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp; √</td> 
   <td>&nbsp;&nbsp;</td> 
  </tr> 
  <tr> 
   <td>&nbsp; 内置SQL</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp;&nbsp;</td> 
   <td>&nbsp; √</td> 
  </tr> 
 </tbody> 
</table>

详情请参照[事件响应方式][Link 5]。

--------------------

索引:

[JS 实现局部刷新 cpt][JS _ cpt]

[自定义 JS 事件中快速选择指定 DOM][JS _ DOM]

[控件事件][Link 2]

[Web 页面事件][Web 1]

[事件响应方式][Link 5]

[Link 1]: https://help.finereport.com/doc-view-1170.html
[Web]: https://help.finereport.com/doc-view-1228.html
[1533630797iBOTxC9V.png]: /images/20211211/2580088046fd426faafa2cfae8ea829f.png
[Link 2]: https://help.finereport.com/doc-view-1176.html
[Web 1]: https://help.finereport.com/doc-view-1178.html
[1533630904rIlVHN4f.png]: /images/20211211/59494a06efb64387a741e5b244ac7595.png
[Link 3]: https://help.finereport.com/doc-view-598.html
[1533630970A2uU6ck9.png]: /images/20211211/e7e15798132f48e49eeed1c673971a43.png
[Link 4]: https://help.finereport.com/doc-view-322.html
[Link 5]: https://help.finereport.com/doc-view-1180.html
[JS _ cpt]: https://help.finereport.com/doc-view-2421
[JS _ DOM]: https://help.finereport.com/doc-view-2469