反饋已提交

網絡繁忙

表格列欄物件API


版本

報表伺服器版本行動端版本功能變動
11.0.1011.0.70普通報表支援setHeight、getHeight、getCell、setWidth、getWidth、getCell、getIndex、setStyle、showToolTip API。
11.0.7-安裝了「FineVis資料視覺化」插件 V1.8.0 及之後版本,FVS 視覺化看板支援 setHeight、getHeight、getCell、setWidth、getWidth、getIndex、setStyle、showToolTip API。
11.0.7-決策報表新增 setHeight、getHeight、getCell、setWidth、getWidth、getCell、getIndex、setStyle、showToolTip API。
11.0
-

和 10.0 差別:

10.0 無此類API

在使用API前,請務必先仔細閱讀 JS API 相容說明,API預設支援普通報表和決策報表(新版)。

setHeight

方法setHeight(height)

設定儲存格行高,需要先透過 getRow(index) 方法獲取到儲存格行。

     參數

height: number

height:  行高

   回傳值void
     範例

範例1:若獲取到的表格行物件定義為 row ,將該行行高設定為 25

row.setHeight(25);

範例2:決策報表中將 report0 報表塊第 3 行的行高設定為 25

_g().getWidgetByName('report0').getRow(3).setHeight(25);

範例3:普通報表中將第3行的行高設定為 25

_g().getRow(3).setHeight(25);

範例4:將 FVS 視覺化看板中的「表格1」組件第 1 行的行高設定為 40:

duchamp.getWidgetByName("表格1").getRow(1).setHeight(40);

範例5:決策報表將 report0 報表塊第 1 行的行高設定為 45

_g().getWidgetByName('report0').getRow(1).setHeight(45);
  應用範例

點選按鈕,將第 1 行的行高設定為 45:

點選下載範本:点击修改单元格行高.frm

FVS 視覺化看板:点击修改单元格行高.fvs

1.gif

注:該API不支援凍結列的情況

   行動端不支援行動端

getHeight

方法getHeight()

獲取儲存格行高,需要先透過 getRow(index) 方法獲取到儲存格行。

     參數

-

-

   回傳值number行高,數字
     範例

範例1:若獲取到的表格行物件定義為 row ,獲取該行的行高

row.getHeight();

範例2:獲取決策報表中將 report0 報表塊第 3 行的行高

_g().getWidgetByName('report0').getRow(3).getHeight();

範例3:獲取普通報表中第 3 行的行高:

_g().getRow(3).getHeight();

範例4:獲取 FVS 視覺化看板中的「表格1」組件第 3 行的行高

duchamp.getWidgetByName("表格1").getRow(3).getHeight();

範例5:獲取決策報表 report0 報表塊第 1 行的行高後彈窗顯示

var a=_g().getWidgetByName('report0').getRow(1).getHeight();
FR.Msg.alert("提示","第一行的行高是"+a );
  應用範例

點選按鈕,獲取決策報表 report0 報表塊第 1 行的行高後彈窗顯示:

點選可下載範本:获取第一行单元格行高.frm

FVS 視覺化看板:点击获取单元格行高.fvs

2.gif

   行動端支援行動端

setWidth

方法setWidth(width)

設定儲存格列寬,需要先透過 getColumn(index) 方法獲取到儲存格列。

     參數

width: number

width:  列寬度

   回傳值void
     範例

範例1:若獲取到的表格列物件定義為 col ,將該列列寬設定為 25

col.setWidth(25);

範例2:決策報表中將 report0 報表塊第 3 列的列寬設定為 25

_g().getWidgetByName('report0').getColumn(3).setWidth(25);

範例3:將普通報表中第 3 列的列寬設定為 25

_g().getColumn(3).setWidth(25);

範例4: FVS 視覺化看板中的「表格1」組件第 3 列的列寬設定為 45

duchamp.getWidgetByName("表格1").getColumn(3).setWidth(45);

範例5:決策報表將 report0 報表塊第 1 列的列寬設定為 45

_g().getWidgetByName('report0').getColumn(1).setWidth(45);
  應用範例

點選按鈕,將第 1 列的列寬設定為 45:

點選下載範本:点击修改单元格列宽.frm

FVS 視覺化看板:点击修改单元格列宽.fvs

3.gif

注:該API不支援凍結行的情況

   行動端不支援行動端

getWidth

方法getWidth()

獲取儲存格列寬,需要先透過 getColumn(index) 方法獲取到儲存格列。

     參數

-

-

   回傳值number列寬,數字
     範例

範例1:若獲取到的表格列物件定義為 col ,獲取該列的列寬

row.getWidth();

範例2:獲取決策報表中將 report0 報表塊第 3 列的列寬

_g().getWidgetByName('report0').getColumn(3).getWidth();

範例3:獲取普通報表第 3 列的列寬

_g().getColumn(3).getWidth();

範例4:獲取 FVS 視覺化看板中的「表格1」組件第 3 列的列寬

duchamp.getWidgetByName("表格1").getColumn(3).getWidth();

範例5:獲取決策報表 report0 報表塊第 1 列的列寬後彈窗顯示

var a=_g().getWidgetByName('report0').getColumn(1).getWidth();
FR.Msg.alert("提示","第一欄的列寬是"+a );
  應用範例

點選按鈕,獲取決策報表 report0 報表塊第 3 列的列寬後彈窗顯示:

點選可下載範本:获取第一列单元格列宽.frm

FVS 視覺化看板:获取单元格列宽.fvs

4.gif

   行動端支援行動端

getCell

方法

getCell(row/col)

獲取儲存格某一欄上第 row 行的儲存格物件/某一行上第 col 列的儲存格物件,需要先透過 getColumn(index)/getRow(index)方法獲取到儲存格列/行,其中參數為儲存格擴展後的位置

     參數

row:number

col:number

row:行號,數字,從 1 開始

col:列號,數字,從 1 開始

   回傳值

object

object :儲存格 cell 物件
     範例

範例1:若獲取到的表格列物件定義為 col ,獲取該列上第 1 行的儲存格

col.getCell(1);

範例2:若獲取到的表格行物件定義為 row ,獲取該行上第 1 列的儲存格

row.getCell(1);

範例3:獲取決策報表中 report0 報表塊第 1 行第 1 列的儲存格

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

或者:

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

範例4:獲取普通報表中第 1 行第 1 列的儲存格

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

或者:

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

範例5:將 FVS 範本中「表格組件」第 2 列第 1 行的儲存格的字體設定為紅色、14 號

duchamp.getWidgetByName("表格組件").getColumn(2).getCell(1).setStyle({
fontSize: 14,
color: 'red'
});

範例6:將決策報表中 report0 報表塊第 1 列第 1 行的儲存格的字體設定為紅色、14 號

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


  應用範例

點選按鈕,將決策報表中 report0 報表塊 A1 儲存格的字體設定為紅色、14 號:

點選可下載範本:获取列再定位到行后修改单元格样式.frm

點選下載 FVS 範本:获取列再定位到行后修改单元格样式.fvs

表格对象接口.gif

   行動端支援行動端

getIndex

方法

getIndex()

獲取儲存格行物件/儲存格列物件的位置索引,如擴展後儲存格在第 4 行,則行索引為 4

     參數

-

-

   回傳值

object

行索引/列索引,數字,為擴展後的行列
     範例

範例1:若獲取到的表格行物件定義為 row ,傳回該行索引

row.getIndex();

範例2:若獲取到的表格列物件定義為 col ,獲取該列的列索引

col.getIndex();

範例3:獲取普通報表中第 1 行的行索引

_g().getRow(1).getIndex();

範例4:獲取 FVS 視覺化看板中的「表格1」組件第 1 行的行索引

duchamp.getWidgetByName("表格1").getRow(1).getIndex();

範例5:獲取決策報表中 report0 報表塊第 1 行的行索引

var a=_g().getWidgetByName('report0').getRow(1).getIndex();
FR.Msg.alert("提示","第一欄的行索引是"+a );
  應用範例

點選按鈕,獲取決策報表中將 report0 報表塊第 1 行的行索引

點選可下載範本:返回行列索引.frm

FVS 視覺化看板:获取表格行索引.fvs

5.gif

   行動端支援行動端

setStyle

方法

setStyle(opts)

設定儲存格行/列物件的樣式。在行列物件上使用時,需要先透過 getRow(index)/getColumn(index) 方法獲取到儲存格行/列。

     參數

opts: Object

{

    fontFamily: String

    fontSize: number

    fontWeight: String

    color: String

  ........

}

opts: 儲存格式屬性,如邊框、背景、字體顏色等,詳細可查看:樣式屬性style

   回傳值

-

-
     範例

範例1:若獲取到的儲存格行物件定義為 row ,設定該儲存格的樣式為字體顏色紅色、字號14 號

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

範例2:將決策報表中 report0 報表塊第一行儲存格的樣式設定為字體顏色紅色、字號14 號

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

範例3:將普通報表第一行儲存格的樣式設定為字體顏色紅色、字號14 號

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

範例4: FVS 視覺化看板中的「表格1」組件第一欄儲存格的樣式設定為字體顏色紅色、字號 20 號

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

範例5:將決策報表中 report0 報表塊第一欄儲存格的樣式設定為字體顏色紅色、字號14 號

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

點選按鈕,將決策報表中 report0 報表塊的第一欄儲存格的字體都設定為紅色、14 號:

點選可下載範本:获取列后修改列单元格样式.frm

FVS 視覺化看板:修改列单元格样式.fvs

6.gif

   行動端支援行動端

showToolTip

方法

showToolTip(opts)

給報表塊儲存格行/列新增提示。在行列物件上使用時,需要先透過 getRow(index)/getColumn(index) 方法獲取到儲存格行/列。

     參數

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:將獲取到的報表塊行物件定義為 row,為行物件設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框: 

row.showToolTip({
show: true, // 是否會出現彈窗
content: { // 可選欄位,不指定即為顯示文字
text: "地區銷售資料", // 文字
header: "提示" // 標題
},
style: { // 可選欄位,不指定為預設樣式,支援css標準樣式的欄位
color: "#DC143C"
//符合css規則
}
});

範例2:給決策報表中 report0 報表塊的第 1 行儲存格設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框: 

_g().getWidgetByName('report0').getRow(1).showToolTip({
show: true, // 是否會出現彈窗
content: { // 可選欄位,不指定即為顯示文字,內容為cell.getValue();
text: "地區銷售資料", // 文字
header: "提示" // 標題
},
style: { // 可選欄位,不指定為預設樣式,支援css標準樣式的欄位
color: "#DC143C"
//符合css規則
}
});

範例3:給決策報表中 report0 報表塊第 1 列儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框: 

_g().getWidgetByName('report0').getColumn(1).showToolTip({
show: true, // 是否會出現彈窗
content: { // 可選欄位,不指定即為顯示文字,內容為cell.getValue();
image: "https://www.fanruan.com/images/logo-fanruan.png",
header: "提示" // 標題
}
});

範例4:給普通報表第一欄儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框: 

_g().getColumn(1).showToolTip({
show: true, // 是否會出現彈窗
content: { // 可選欄位,不指定即為顯示文字,內容為cell.getValue();
image: "https://www.fanruan.com/images/logo-fanruan.png",
header: "提示" // 標題
}
});

範例5:給 FVS 視覺化看板中的「表格1」組件第 1 列儲存格設定一個標題為“提示”,內容為網頁圖片帆軟 LOG 的提示框

duchamp.getWidgetByName("表格1").getColumn(1).showToolTip({
show: true, // 是否會出現彈窗
content: { // 可選欄位,不指定即為顯示文字,內容為cell.getValue();
image: "https://www.fanruan.com/images/logo-fanruan.png",
header: "提示" // 標題
}
});
  應用範例

給決策報表中 report0 報表塊第一行設定一個標題為“提示”,內容為紅色“地區銷售資料”字樣的提示框: 

點選可下載範本:鼠标悬浮单元格行文字提示.frm

FVS 視覺化看板:鼠标悬浮单元格行文字提示.fvs

表格对象接口10.gif

   行動端不支援行動端


附件列表


主題: 二次開發
已經是第一篇
已經是最後一篇
  • 有幫助
  • 沒幫助
  • 只是瀏覽
  • 圖片不清晰
  • 用語看不懂
  • 功能說明看不懂
  • 操作說明太簡單
  • 內容有錯誤
中文(繁體)

文 檔回 饋

滑鼠選中內容,快速回饋問題

滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

不再提示

10s後關閉