单元格对象接口

和 10.0 区别：

10.0 无此类接口

-

-

示例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

-

-

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

-

-

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

-

-

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

支持移动端

但当getCell与getValue联用时，例如：_g().getCell(1,1).getValue();，不支持填报预览

value:any

单元格值，任意格式

void

示例1：FVS 可视化看板中给「表格1」组件 A1 单元格赋值为「其他地区」

duchamp.getWidgetByName("表格1").getCell(1,1).setValue("其他地区");

示例2：决策报表中给报表块 report0 中的 A1 单元格赋值「其他地区」

_g().getWidgetByName("report0").getCell(1,1).setValue("其他地区");

点击下载模板：点击修改单元格值.fvs

opts: Object

{

    show: boolean,

    content: { 

        text: string, // 文字

        image: string, // 图片

        header: string // 标题

    }

    style: { 

    }

}

注：普通报表不支持 header 和 image 参数

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

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

单元格编号

行列索引，json 格式

• col：列索引，从 0 开始

• row：行索引，从 0 开始

示例1：普通报表或决策报表中，返回 A1 单元格的行列信息

FR.cellStr2ColumnRow("A1");

示例2：普通报表或决策报表中，打印 A1 单元格的行号

var a=FR.cellStr2ColumnRow("A1").row+1;
FR.Msg.alert("提示", "A1单元格的行号为"+a);

示例3：FVS 模板中，打印单元格的行列号

var a=duchamp.cellStr2ColumnRow("A3").col+1;
var b=duchamp.cellStr2ColumnRow("A3").row+1;
//alert(a);
duchamp.Msg.alert({
    title: "提示",
    message:  "A3单元格的列号为"+a,
});
duchamp.Msg.alert({
    title: "提示",
    message:  "A3单元格的行号为"+b,
});

普通报表示例：点击按钮，打印  A1 单元格的行号

FVS 模板示例：点击按钮，打印 A3 单元格的行列号

点击下载模板：打印单元格的行列号.fvs

行列索引，json 格式

• col：列索引，从 0 开始

• row：行索引，从 0 开始

单元格编号

示例1：普通报表或决策报表中，返回行索引为 3，列索引为 1 的单元格编号

FR.columnRow2CellStr({col:1, row:3});

示例2：普通报表或决策报表中，打印行索引为 3，列索引为 1 的单元格编号

var a=FR.columnRow2CellStr({col:1, row:3})
FR.Msg.alert("提示", "行索引3，列索引为1的单元格编号为"+a);

示例3：FVS 模板中，打印行索引为 3，列索引为 1 的单元格编号

var a=duchamp.columnRow2CellStr({col:1, row:3})
duchamp.Msg.alert({
    title: "提示",
    message:  "行索引3，列索引为1的单元格编号为"+a,
});

普通报表示例：打印行索引为 3，列索引为 1 的单元格编号

FVS 模板示例：打印行索引为 3，列索引为 1 的单元格编号

点击下载模板：根据行列号获取单元格编号.fvs