反馈已提交

网络繁忙

单元格对象接口

  • 文档创建者:RosieY
  • 编辑次数:11次
  • 最近更新:RosieY 于 2022-11-30
  • 版本

    版本功能变动
    11.0.10普通报表支持 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。
    11.0.7安装了「FVS大屏编辑模式」插件 V1.8.0 及之后版本,FVS大屏模板支持 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。
    11.0.7决策报表新增 getPosition、getRow、getColumn、getValue、showToolTip、setStyle 接口。
    11.0

    和 10.0 区别:

    10.0 无此类接口

    注:FVS 大屏编辑模式插件不支持移动端 ,以下 API 若标注支持移动端则只针对普通报表和决策报表。

    getPosition

    方法getPosition()

    获取当前单元格位置信息,使用时需要先获取到单元格对象

         参数

    -

    -

       返回值Position:Array单元格的位置,数组类型,下标从 0 开始,0 表示行,1 表示列
         示例

    示例1:若获取到的单元格对象定义为 cell ,返回当前单元格的位置、行位置、列位置

    cell.getPosition();//cell单元格对象的位置信息
    cell.getPosition()[0];//cell单元格对象的行位置
    cell.getPosition()[1];//cell单元格对象的列位置

    示例2:返回决策报表中 report0 报表块中 A1 单元格的位置信息

    _g().getWidgetByName('report0').getCell(1,1).getPosition();

    示例3:返回普通报表中 A1 单元格的位置信息

    _g().getCell(1,1).getPosition();

    示例4:返回 FVS 大屏模板中「表格1」组件 A1 单元格的位置信息

    duchamp.getWidgetByName("表格1").getCell(1,1).getPosition();

    示例5:弹窗提示决策报表中 report0 报表块中 A1 单元格的行列信息

    var row=_g().getWidgetByName('report0').getCell(1,1).getPosition()[0];
    var col=_g().getWidgetByName('report0').getCell(1,1).getPosition()[1];
    FR.Msg.alert("提示","A1单元格的行位置是"+row+"列位置是"+col);
      应用示例

    点击按钮,弹窗提示决策报表中 report0 报表块中 A1 单元格的行列信息

    点击下载模板:获取单元格对象的位置.frm

    FVS 大屏模板:获取单元格对象的位置.fvs

    2022-08-26_14-38-50.gif

       移动端支持移动端

    getRow

    方法getRow()

    获取当前单元格所在的行单元格对象,返回的行对象可调用 行对象上的方法

         参数

    -

    -

       返回值

    Object

    行单元格对象,json 格式。当单元格合并时,返回单元格行对象组,假设将A1、A2单元格合并,则返回 第 1 行对象, 第 2 行对象。

         示例

    示例1:若获取到的单元格对象定义为 cell ,返回当前单元格所在的行单元格对象

    cell.getRow();

    示例2:获取决策报表中 report0 报表块中 A1 单元格所在的行单元格对象

    _g().getWidgetByName('report0').getCell(1,1).getRow();

    示例3:获取普通报表中 A1 单元格所在的行单元格对象:

    _g().getCell(1, 1).getRow();

    示例4:获取 FVS 大屏模板中「表格1」组件 A1 单元格所在的行单元格对象

    duchamp.getWidgetByName("表格1").getCell(1,1).getRow();

    示例5:修改决策报表中 report0 报表块中 A1 单元格所在的行单元格内容字体为红色、14号

    _g().getWidgetByName('report0').getCell(1, 1).getRow().setStyle({
    fontSize: 14,
    color: 'red'
    });
      应用示例

    修改决策报表中 report0 报表块中 A1 单元格所在的行单元格内容字体为红色、14号

    点击下载模板:修改单元格所在行的样式.frm

    FVS 大屏模板:修改单元格所在行的样式.fvs

    2022-08-26_15-23-32.gif

       移动端支持移动端

    getColumn

    方法getColumn()

    获取当前单元格所在的列单元格对象,返回的列对象可调用 列对象上的方法

         参数

    -

    -

       返回值

    Object

    列单元格对象,JSON 格式。当单元格合并时,返回单元格列对象组,假设将A1、B1单元格合并,则返回第 1 列对象, 第 2 列对象。

         示例

    示例1:若获取到的单元格对象定义为 cell ,返回当前单元格所在的列单元格对象

    cell.getColumn();

    示例2:获取决策报表中 report0 报表块中 A1 单元格所在的列单元格对象

    _g().getWidgetByName('report0').getCell(1,1).getColumn();

    示例3:获取普通报表中 A1 单元格所在的列单元格对象:

    _g().getCell(1,1).getColumn();

    示例4:获取 FVS 大屏模板中「表格1」组件 A1 单元格所在的列单元格对象

    duchamp.getWidgetByName("表格1").getCell(1,1).getColumn();

    示例5:修改决策报表中 report0 报表块中 A1 单元格所在的列单元格内容字体为红色、14号

    _g().getWidgetByName('report0').getCell(1,1).getColumn().setStyle({
    fontSize: 14,
    color: 'red'
    });
      应用示例

    修改决策报表中 report0 报表块中 A1 单元格所在的列单元格内容字体为红色、14号

    点击下载模板:修改单元格所在列的样式.frm

    FVS 大屏模板:修改单元格所在列的样式.fvs

    2022-08-26_15-40-39.gif

       移动端支持移动端

    getValue

    方法getValue()

    获取单元格的值

         参数

    -

    -

       返回值

    string

    单元格值

         示例

    示例1:若获取到的单元格对象定义为 cell ,返回当前单元格的值

    cell.getValue();

    示例2:获取决策报表中 report0 报表块中 A1 单元格的值

    _g().getWidgetByName('report0').getCell(1,1).getValue();

    示例3:获取普通报表 A1 单元格的值

    _g().getCell(1,1).getValue();

    示例4:获取 FVS 大屏模板中「表格1」组件 A1 单元格的值

    duchamp.getWidgetByName("表格1").getCell(1,1).getValue();

    示例5:弹窗打印决策报表中 report0 报表块中 A1 单元格的值

    var a=_g().getWidgetByName('report0').getCell(1,1).getValue();
    FR.Msg.alert("提示","A1单元格的值是"+a);
      应用示例

    弹窗打印决策报表中 report0 报表块中 A1 单元格的值

    点击下载模板:点击显示单元格的值.frm

    FVS 大屏模板:获取单元格值.fvs

       移动端支持移动端

    showToolTip

    方法

    showToolTip(opts)

    给报单元格添加提示

         参数

    opts: Object

    {

        show: boolean,

        content: { 

            text: string, // 文字

            image: string, // 图片

            header: string // 标题

        }

        style: { 

        }

    }

    opts: 弹窗选项,是个对象

    1)show:是否会出现弹窗,布尔型,true 为出现,false 为不出现

    2)content:可选字段,不指定即为显示文字,内容为单元格中的值

    • text: 提示的内容,字符串

    • image: 图片 URL 路径,字符串,图片格式支持 pn   g、jpg。图片来源可以为网页图片,如:

    https://www.fanruan.com/images/logo-fanruan.png

    也可以将图片放置在报表工程目录 %FR_HOME%\webapps\webroot 下,通过URL 访问。如:

    http://localhost:8075/webroot/11.jpg
    • header: 标题

    3)style: 可选字段,不指定则为默认样式,支持的样式可参考:单元格样式属性style

       返回值

    -

    -

         示例

    示例1:将获取到的单元格对象定义为 cell,给单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

    cell.showToolTip({
    show: true// 是否会出现弹窗
    content: { // 可选字段,不指定即为显示文字
    text: "地区销售数据"// 文字
    header: "提示" // 标题
    },
    style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
    color: "#DC143C"
    //符合css规则
    }
    });

    示例2:给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

    _g().getWidgetByName('report0').getCell(1,1).showToolTip({
    show: true// 是否会出现弹窗
    content: { // 可选字段,不指定即为显示文字,内容为cell.getValue();
    text: "地区销售数据"// 文字
    header: "提示" // 标题
    },
    style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
    color: "#DC143C"
    //符合css规则
    }
    });

    示例3:给普通报表 A1 单元格设置一个标题为“提示”,内容为红色“地区销售数据”字样的提示框: 

    _g().getCell(1,1).showToolTip({
    show: true, // 是否会出现弹窗
    content: { // 可选字段,不指定即为显示文字,内容为cell.getValue();
    text: "地区销售数据", // 文字
    header: "提示" // 标题
    },
    style: { // 可选字段,不指定为默认样式,支持css标准样式的字段
    color: "#DC143C"
    //符合css规则
    }
    });

    示例4:给 FVS 大屏模板中「表格1」组件 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框

    duchamp.getWidgetByName("表格1").getCell(1,1).showToolTip({
    show: true, // 是否会出现弹窗
    content: { // 可选字段,不指定即为显示文字
    header: "提示" // 标题
    }
    });

    示例5:给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框: 

    _g().getWidgetByName('report0').getCell(1,1).showToolTip({
    show: true, // 是否会出现弹窗
    content: { // 可选字段,不指定即为显示文字
    header: "提示" // 标题
    }
    });
      应用示例

    给决策报表中 report0 报表块 A1 单元格设置一个标题为“提示”,内容为单元格值的提示框: 

    点击可下载模板:鼠标悬浮单元格文字提示.frm

    FVS 大屏模板:鼠标悬浮单元格文字提示.fvs


       移动端不支持移动端

    setStyle

    方法

    setStyle(opts)

    设置单元格对象的样式

         参数

    opts: Object

    {

        fontFamily: String

        fontSize: number

        fontWeight: String

        color: String

      ........

    }

    opts: 单元格格式属性,如边框、背景、字体颜色等,支持的属性可查看:单元格样式属性style

       返回值

    -

    -
         示例

    示例1:若获取到的单元格对象为 cell ,设置该单元格的样式为字体颜色红色、字号14 号

    cell.setStyle({
    fontSize: 14,
    color: 'red'
    });

    示例2:给普通报表 A1 单元格的样式设置为字体颜色红色、字号14 号

    _g().getCell(1,1).setStyle({
    fontSize: 14,
    color: 'red'
    });

    示例4:将 FVS 大屏模板中「表格1」组件 A1 单元格的样式设置为字体颜色红色、字号 20 号

    duchamp.getWidgetByName("表格1").getCell(1,1).setStyle({
    fontSize: 20,
    color: 'red'
    });

    示例5:将决策报表中将 report0 报表块 A1 单元格的样式设置为字体颜色红色、字号14 号

    _g().getWidgetByName('report0').getCell(1,1).setStyle({
    fontSize: 14,
    color: 'red'
    });
      应用示例

    点击按钮,将决策报表中 report0 报表块 A1 单元格的字体设置为红色、加粗、14 号:

    点击可下载模板:获取单元格后修改单元格样式.frm

    FVS 大屏模板:获取单元格后修改单元格样式.fvs

    2022-08-16_19-47-08.gif

       移动端支持移动端


    附件列表


    主题: 二次开发
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    7*24h

    智 能客 服