儲存格物件API

和 10.0 差別：

10.0 無此類API

-

-

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