WPS宏开发手册——Excel常用Api

系列文章

    使用、工程、模块介绍
    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;
//颜色序列详见附录一