系列文章

????使用、工程、模塊介紹
????JSA語法
????JSA語法練習題
????Excel常用Api
????Excel實戰
????后續常見問題、顏色附錄，持續更新中…

4、Excel常用Api

4.1、判斷是否是目標工作excel

let activeWorkbook = Application.ActiveWorkbook;
console.log(activeWorkbook.Name)
if(activeWorkbook.Name !== 'excel名字.xlsx'){console.log('文件選擇錯誤	')return
}
// 下面寫工作代碼

4.2、獲取源工作表和目標工作表的引用

let sourceSheet = Sheets.Item("Sheet2");
let targetSheet = Sheets.Item("Sheet3");

4.3、獲取單元格的值

//方法一：
let sourceSheet = Sheets.Item("Sheet2");
let sourceCellValue = sourceSheet.Range("B4").Value2;
//方法二：
let sourceSheet = Sheets.Item("Sheet2");
let sourceCellValue = sourceSheet.Cells(4, 2).Value2;
//方法三（Value2替換為Text）：
//上訴兩種方法在獲取日期格式單元格值時，value2獲取值為距離1990年的天數而非yyyy/mm/dd格式的數據。
let sourceCellValue = sourceSheet.Range("B4").Text;
let sourceCellValue = sourceSheet.Cells(4, 2).Text;
//"B4"相當于第4行第2列。
//合并單元格的值由該單元格的第一個坐標定義。
//實戰中一般使用方法二。

4.4、設置單元格的值

//方法一：
let targetSheet = Sheets.Item("Sheet3");
targetSheet.Range("B4").Value2 = ‘單元格的值’ 
//方法二：
let targetSheet = Sheets.Item("Sheet3");
targetSheet.Cells(4, 2).Value2 =‘單元格的值’
//實戰中一般使用方法二。

4.5、合并單元格

//方法一：
let sourceSheet = Sheets.Item("Sheet2");
let rangeToMerge = sourceSheet.Range("B2:D2");
rangeToMerge.Merge();
//方法二：
let sourceSheet = Sheets.Item("Sheet2");
let startCell = sourceSheet.Cells(2, 2);
let mergeRange = startCell.Resize(1, 3);
mergeRange.Merge();
//從"B2"開始相當于第2行第2列開始。到"D2"結束相當于合并高度為1，寬度為3范圍內的單元格。
//實戰中一般使用方法二。

4.6、獲取源范圍

// 從第3行開始到第26行結束
let sourceRange = sourceSheet.Range("B3:G26");

4.7、獲取源范圍行數

let Count = sourceRange.Rows.Count; // 26-3+1 = 24行

4.8、通過源來獲取單元格的值

var sourceRange = sourceSheet.Range("B4:H26");
let sourceCellValue = sourceRange.Cells(1, 1).Value2;
//"B4"相當于源的第1行第1列

4.9、設置單元格的背景顏色

let targetSheet = Sheets.Item("Sheet1");
targetSheet.Range("B4").Interior.ColorIndex = 3;
// 顏色序列詳見附錄一

4.10、設置單元格的文字顏色

let targetSheet = Sheets.Item("Sheet1");
targetSheet.Range("B4").Font.ColorIndex = 3;
//顏色序列詳見附錄一