滑鼠點選/懸浮時修改儲存格背景API

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

注：該API不支援和自訂捲軸插件同時使用。

以下內容為API範例，分儲存格所在行變色、儲存格所在列變色、儲存格所在行列變色、儲存格變色，分別對應 type 參數的四個值。

儲存格所在行變色

addEffect 第一個參數 type 值為 highlightRow 時，滑鼠點選或者懸浮儲存格，儲存格所在行背景顏色發生改變。

程式碼範例

範例1：若獲取到的報表物件定義為 report ，滑鼠懸浮儲存格時所在行背景顯示為紅色，離開時恢復

report.addEffect('highlightRow',{
	color: 'red',
	trigger: 'mouseover',
});

範例2：若獲取到的報表物件定義為 report ，滑鼠點選儲存格時所在行背景顯示為紅色，再次點選恢復

report.addEffect('highlightRow',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例3：普通報表中，滑鼠懸浮儲存格時，所在行背景顯示為紅色，離開時恢復

_g().addEffect('highlightRow', {
	color: 'red',
	trigger: 'mouseover',
});

範例4：普通報表中，滑鼠點選儲存格時，所在行背景顯示為紅色，再次點選恢復

_g().addEffect('highlightRow',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例5：決策報表中，滑鼠懸浮 report0 報表塊儲存格時，所在行背景顯示為紅色，離開時恢復

_g().getWidgetByName('report0').addEffect('highlightRow', {
	color: 'red',
	trigger: 'mouseover',
});

範例6：決策報表中，滑鼠點選 report0 報表塊儲存格時，所在行背景顯示為紅色，再次點選恢復

_g().getWidgetByName('report0').addEffect('highlightRow', {
	color: 'red',
	trigger: 'mousedown',
	single: false
});

範例7：在FVS中，滑鼠點選表格1儲存格時，所在行背景顯示為紅色，再次點選恢復

duchamp.getWidgetByName("表格1").addEffect('highlightRow', {
	color: 'red',
	trigger: 'mousedown',
       single:false
});

應用範例

範例1：滑鼠懸浮儲存格時，所在行背景顏色顯示為紅色，離開時恢復

點選下載範本：单元格所在行变色.cpt

範例2：滑鼠點選儲存格時，所在行背景顏色顯示為紅色，再次點選恢復

點選下載範本：单元格所在行变色鼠标点击恢复.cpt

儲存格所在列變色

addEffect 第一個參數 type 值為 highlightCross 時，滑鼠點選或者懸浮儲存格，儲存格所在的列背景顏色發生改變。

程式碼範例

範例1：若獲取到的報表物件定義為 report ，滑鼠懸浮儲存格時所在列背景顏色顯示為紅色，離開時恢復

report.addEffect('highlightCol',{
	color: 'red',
	trigger: 'mouseover',
});

範例2：若獲取到的報表物件定義為 report ，滑鼠點選儲存格時所在列背景顏色顯示為紅色，再次點選恢復

report.addEffect('highlightCol',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例3：普通報表中，滑鼠懸浮儲存格時，所在列背景顏色顯示為紅色，離開時恢復

_g().addEffect('highlightCol', {
	color: 'red',
	trigger: 'mouseover',
});

範例4：普通報表中，滑鼠點選儲存格時，所在列背景顏色顯示為紅色，再次點選恢復

_g().addEffect('highlightCol',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例5：決策報表中，滑鼠懸浮 report0 報表塊儲存格時，所在列背景顏色顯示為紅色，離開時恢復

_g().getWidgetByName('report0').addEffect('highlightCol', {
	color: 'red',
	trigger: 'mouseover',
});

範例6：決策報表中，滑鼠點選 report0 報表塊儲存格時，所在列背景顏色顯示為紅色，再次點選恢復

_g().getWidgetByName('report0').addEffect('highlightCol', {
	color: 'red',
	trigger: 'mousedown',
	single: false
});

範例7：在 FVS 中，滑鼠點選表格1儲存格時，所在列背景顯示為紅色，再次點選恢復

duchamp.getWidgetByName("表格1").addEffect('highlightCol', {
	color: 'red',
	trigger: 'mousedown',
       single:false
});

應用範例

範例1：滑鼠懸浮儲存格時，所在列背景顏色顯示為紅色，離開時恢復

點選下載範本：单元格所在列变色.cpt

範例2：滑鼠點選儲存格時，所在列背景顏色顯示為紅色，再次點選恢復

點選下載範本：单元格所在列变色鼠标点击恢复.cpt

儲存格所在行列變色

addEffect 第一個參數 type 值為 highlightCol 時，滑鼠點選或者懸浮儲存格，儲存格所在的行列背景顏色發生改變。

程式碼範例

範例1：若獲取到的報表物件定義為 report ，滑鼠懸浮儲存格時所在行列背景顏色顯示為紅色，離開時恢復

report.addEffect('highlightCross',{
	color: 'red',
	trigger: 'mouseover',
});

範例2：若獲取到的報表物件定義為 report ，滑鼠點選儲存格時所在行列背景顏色顯示為紅色，再次點選恢復

report.addEffect('highlightCross',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例3：普通報表中，滑鼠懸浮儲存格時，所在行列背景顏色顯示為紅色，離開時恢復

_g().addEffect('highlightCross', {
	color: 'red',
	trigger: 'mouseover',
});

範例4：普通報表中，滑鼠點選儲存格時，所在行列背景顏色顯示為紅色，再次點選恢復

_g().addEffect('highlightCross',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例5：決策報表中，滑鼠懸浮 report0 報表塊儲存格時，所在行列背景顏色顯示為紅色，離開時恢復

_g().getWidgetByName('report0').addEffect('highlightCross', {
	color: 'red',
	trigger: 'mouseover',
});

範例6：決策報表中，滑鼠點選 report0 報表塊儲存格時，所在行列背景顏色顯示為紅色，再次點選恢復

_g().getWidgetByName('report0').addEffect('highlightCross', {
	color: 'red',
	trigger: 'mousedown',
	single: false
});

範例7：在FVS中，滑鼠點選表格1儲存格時，所在行列背景顏色顯示為紅色，再次點選恢復

duchamp.getWidgetByName("表格1").addEffect('highlightCross', {
	color: 'red',
	trigger: 'mousedown',
       single:false
});

應用範例

範例1：滑鼠懸浮儲存格時，所在行列背景顏色顯示為紅色，離開時恢復

點選下載範本：单元格所在行列变色.cpt

範例2：滑鼠點選儲存格時，所在行列背景顏色顯示為紅色，再次點選恢復

點選下載範本：单元格所在行列变色鼠标点击恢复.cpt

儲存格變色

addEffect 第一個參數 type 值為 highlightCell 時，滑鼠點選或者懸浮儲存格，儲存格背景顏色發生改變。

程式碼範例

範例1：若獲取到的報表物件定義為 report ，滑鼠懸浮儲存格時儲存格背景顏色顯示為紅色，離開時恢復

report.addEffect('highlightCell',{
	color: 'red',
	trigger: 'mouseover',
});

範例2：若獲取到的報表物件定義為 report ，滑鼠點選儲存格時儲存格背景顏色顯示為紅色，再次點選恢復

report.addEffect('highlightCell',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例3：普通報表中，滑鼠懸浮儲存格時儲存格背景顏色顯示為紅色，離開時恢復

_g().addEffect('highlightCell', {
	color: 'red',
	trigger: 'mouseover',
});

範例4：普通報表中，滑鼠點選儲存格時儲存格背景顏色顯示為紅色，再次點選恢復

_g().addEffect('highlightCell',{
	color: 'red',
	trigger: 'mousedown',
	single:false
});

範例5：決策報表中，滑鼠懸浮 report0 報表塊儲存格時儲存格背景顏色顯示為紅色，離開時恢復

_g().getWidgetByName('report0').addEffect('highlightCell', {
	color: 'red',
	trigger: 'mouseover',
});

範例6：決策報表中，滑鼠點選 report0 報表塊儲存格時儲存格背景顏色顯示為紅色，再次點選恢復

_g().getWidgetByName('report0').addEffect('highlightCell', {
	color: 'red',
	trigger: 'mousedown',
	single: false
});

範例7：在FVS中，滑鼠點選表格1儲存格時儲存格背景顏色顯示為紅色，再次點選恢復

duchamp.getWidgetByName("表格1").addEffect('highlightCell', {
	color: 'red',
	trigger: 'mousedown',
       single:false
});

應用範例

範例1：滑鼠懸浮儲存格時儲存格背景顏色顯示為紅色，離開時恢復：

點選下載範本：单元格变色鼠标离开恢复.cpt

範例2：滑鼠點選儲存格時儲存格背景顏色顯示為紅色，再次點選恢復

點選下載範本：单元格变色鼠标点击恢复.cpt

1）當報表中設定了儲存格所在行變色，同時設定了凍結列，凍結列會將一行分割成A、B兩部分，API對A、B兩部分分別生效，如下圖所示：

2）當報表中設定了儲存格所在列變色，同時設定了凍結行，凍結行會將一行分割成A、B兩部分，API對A、B兩部分分別生效，與第1）節原理相同。

3）當開啟新計算引擎時，API不受凍結行或凍結列影響。