获取指定单元格的范围。

当前选中单元格

getCurrentCell()

获取表格内选中的其中一个单元格,即使选择多个单元格,也只返回左上角的第一个单元格。代码示例:

SpreadsheetApp.getActiveSheet().getCurrentCell()

例如下图,选中 B4 到 D10,但是只会返回 B4 单元格的范围。

当前选中范围

getActiveRange()

获取表格内选中的范围。代码示例:

SpreadsheetApp.getActiveSheet().getActiveRange()

例如下图,选中 B3 到 C5 这个范围,那么就会返回这部分单元格的范围。

当前数据存在范围

getDataRange()

从 A1 为起始点获取当前数据存在的范围。代码示例:

SpreadsheetApp.getActiveSheet().getDataRange()

例如下图,数据存放在 B2 到 D8 的范围,那么会返回从 A1 到 D8 单元格的范围。

获取指定范围

方法一

getRange(a1Notation)

a1Notation 放入 A1 表示法引用单元格范围。代码示例:

SpreadsheetApp.getActiveSheet().getRange('C2:C7')

那么会获取 C2 到 C7 范围的单元格。

方法二

getRange(row, column, numRows, numColumns)

row 设置起始行;column 设置起始列;numRows 设置行数,非必填参数,默认为 1;numColumns 设置列数,非必填参数,默认为 1。
代码示例:

SpreadsheetApp.getActiveSheet().getRange(4, 2, 3, 2)

从第 3 行,第 2 列开始计算,也就是下图中 B4 的位置,然后再获取 3 行 和 2 列的内容。同等于 B4:C6 范围。