Offset

返回从当前范围偏移的 Range 对象。

语法

expression.Offset(rowOffset, columnOffset);

expression - 表示 ApiRange 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
rowOffset	必需	number		偏移范围的行数。
columnOffset	必需	number		偏移范围的列数。

返回值

ApiRange | null

示例

在电子表格中将范围按行数和列数偏移到新位置。

// How do I move a selection to a different area by stepping over rows and columns in a spreadsheet?

// Highlight the displaced range with a background color to make its new position visible in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let originalRange = worksheet.GetRange("C3:D4");
originalRange.SetValue("Original");
originalRange.SetFillColor(Api.CreateColorFromRGB(173, 216, 230));

let offsetRange = originalRange.Offset(2, 1);
offsetRange.SetValue("Offset");
offsetRange.SetFillColor(Api.CreateColorFromRGB(255, 213, 191));