历史版本11 :全局接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

版本编辑

版本功能变动
11.0

和 10.0 区别：

  • 新增 getPreviewType、getParameterContainer 接口

  • 原 10.0 上  contentPane 废弃，其上的方法大部分已转移到 _g()（其中 contentPane.curLGP 对象上的方法暂未兼容）



全局接口，是可以操作整张报表的接口，报表中其他元素的方法和属性都继承在全局接口上。如果要获取报表中其他元素并对其进行操作，就必须先使用全局接口获取到报表对象。

_g()编辑

方法_g()

获取报表对象，获取后结合报表对象的方法和属性使用

     参数--
   返回值object报表对象
     示例

示例1：获取报表对象后，再使用报表对象的方法获取参数面板对象

_g().getParameterContainer();

示例2：获取报表对象后，再使用报表对象的方法获取 report0 报表块对象

_g().getWidgetByName('report0');

示例3：获取报表对象后，使用报表对象的 parameterCommit 方法提交参数重新查询

_g().parameterCommit();
  应用示例

参数面板中下拉框选择值后不点击查询按钮即可查询，如下图所示：

详细实现方法可参考：JS实现无需点击查询按钮即可自动查询

2021-09-02_11-14-43.gif

   移动端支持移动端

getParameterContainer编辑

方法getParameterContainer()获取报表中参数面板对象，获取后结合 参数面板接口 使用
     参数--
   返回值object参数面板对象
     示例

示例1：若获取到的报表对象定义为 report，获取报表中参数面板对象

report.getParameterContainer();

示例2：获取报表对象后，再获取参数面板对象

_g().getParameterContainer();

示例3：获取到参数面板对象后，再使用其方法获取参数面板上「下拉框」控件 comboBox0

_g().getParameterContainer().getWidgetByName("comboBox0");
  应用示例

给参数面板上的控件赋值，如下图所示：

点击可下载模板：给参数面板上控件赋值.cpt

2021-09-03_10-34-00.gif

   移动端支持移动端

parameterCommit编辑

方法parameterCommit()

提交参数后重新查询，刷新报表

     参数--
   返回值void
     示例

示例1：若获取到的报表对象定义为 report，提交参数重新查询

report.parameterCommit();

示例2：获取报表对象后，提交参数重新查询

_g().parameterCommit();
  应用示例

参数面板中下拉框选择值后不点击查询按钮即可查询，如下图所示：

详细实现方法可参考：JS实现无需点击查询按钮即可自动查询

2021-09-02_11-14-43.gif


   移动端支持移动端

loadContentPane编辑

方法loadContentPane()

重新加载，刷新报表

     参数--
   返回值void
     示例

示例1：若获取到的报表对象定义为 report，刷新报表

report.loadContentPane();

示例2：获取报表对象后，刷新报表

_g().loadContentPane();
  应用示例

点击按钮重新加载报表，如下图所示：

点击可下载模板：点击按钮重新加载报表.cpt

2021-10-19_14-55-02.gif


   移动端支持移动端

getPreviewType编辑

方法getPreviewType()

获取报表当前所在的预览模式

     参数--
   返回值string

字符串，当前所在的预览模式：

  • preview: cpt 分页预览 / frm 非移动端预览

  • view: 数据分析

  • write: 填报预览

  • mobile-preview: 移动端预览

  • mobile-write: 移动端填报

     示例

示例1：若获取到的报表对象定义为 report，返回报表当前所在的预览模式

report.getPreviewType();

示例2：返回报表对象当前的预览模式

_g().getPreviewType();
  应用示例

设计的某些报表功能不支持「数据分析」预览方式时，弹窗提醒：

点击可下载模板：报表预览模式.cpt

   移动端支持移动端