区域资源类型

区域表示一个或多个相邻的单元格,例如单元格、行、列、单元格块等。

方法

方法 返回类型 说明
获取区域 区域 读取 range 对象的属性和关系。
更新 区域 更新 Range 对象。
Boundingrect 区域 获取包含指定区域的最小 range 对象。例如,“B2:C5”和“D10:E15”的 GetBoundingRect 为“B2:E16”。
单元格 区域 根据行和列编号获取包含单个单元格的 range 对象。单元格可以位于父区域外部,只要其保持在工作表网格内即可。返回的单元格位于相对于区域左上角的单元格的位置。
区域 获取范围中包含的列。
Columnsafter workbookRangeView 获取给定范围右侧的一定数量的列。
Columnsbefore workbookRangeView 获取给定范围左侧的一定数量的列。
Entirecolumn 区域 获取表示区域整列的对象。
Entirerow 区域 获取表示区域整行的对象。
Intersection 区域 获取表示指定区域的矩形交集的 range 对象。
Lastcell 区域 获取区域内的最后一个单元格。例如,“B2:D5”的最后一个单元格是“D5”。
Lastcolumn 区域 获取区域内的最后一列。例如,“B2:D5”的最后一列是“D2:D5”。
Lastrow 区域 获取区域内的最后一行。例如,“B2:D5”的最后一行是“B5:D5”。
Offsetrange 区域 获取表示与指定区域偏移的区域的对象。返回的区域的尺寸将与该区域匹配。如果强制使生成的区域位于工作表网格的边界之外,则会引发异常。
区域 获取范围中包含的行。
Rowsabove workbookRangeView 获取给定范围上方的一定数量的行。
Rowsbelow workbookRangeView 获取给定范围下方的一定数量的行。
Usedrange 区域 返回指定 range 对象的所用区域。
清除 None 清除区域值、格式、填充、边框等。
删除 None 删除与区域相关的单元格。
插入 区域 将单个单元格或一系列单元格插入到工作表中取代此区域,并移动其他单元格以留出空间。在现在空白的空间返回新的 Range 对象。
合并 None 将范围单元格合并到工作表的一个区域内。
Resizedrange workbookRangeView 获取与当前范围对象类似的范围对象,但其右下角可通过一定数量的行和列进行展开(或合拢)。
Unmerge None 将范围单元格取消合并为各个单元格。
Visibleview workbookRangeView 获取筛选的范围中的可见范围。

属性

属性 类型 说明
address string 表示 A1 样式的区域引用。地址值将包含工作表引用(如 Sheet1!A1:B4)。只读。
addressLocal string 以用户语言表示对指定区域的区域引用。只读。
cellCount int 区域中的单元格数目。只读。
columnCount int 表示区域中的列总数。只读。
columnHidden boolean 表示当前区域中的所有列是否隐藏。
columnIndex int 表示区域中第一个单元格的列编号。从零开始编制索引。只读。
formulas json 表示采用 A1 样式表示法的公式。
formulasLocal json 表示采用 A1 样式表示法的公式,使用用户的语言和数字格式区域设置。例如,英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。
formulasR1C1 json 表示采用 R1C1 样式表示法的公式。
hidden boolean 表示当前区域中的所有单元格是否隐藏。只读。
numberFormat json 表示 Excel 中指定单元格的数字格式代码。
rowCount int 返回区域中的总行数。只读。
rowHidden boolean 表示当前区域中的所有行是否隐藏。
rowIndex int 返回区域中第一个单元格的行编号。从零开始编制索引。只读。
text json 指定区域的文本值。文本值与单元格宽度无关。在 Excel UI 中替代 # 符号不会影响 API 返回的文本值。只读。
valueTypes string 表示每个单元格的数据类型。可能的值是:UnknownEmptyStringIntegerDoubleBooleanError。只读。
json 表示指定区域的原始值。返回的数据类型可能是字符串、数字或布尔值。包含一个将返回错误字符串的错误的单元格。

关系

关系 类型 说明
format RangeFormat 返回一个格式对象,其中封装了区域的字体、填充、边框、对齐方式和其他属性。只读。
sort RangeSort 包含当前区域的工作表。只读。
工作表 Worksheet 包含当前区域的工作表。只读。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "address": "string",
  "addressLocal": "string",
  "cellCount": 1024,
  "columnCount": 1024,
  "columnHidden": true,
  "columnIndex": 1024,
  "formulas": "json",
  "formulasLocal": "json",
  "formulasR1C1": "json",
  "hidden": true,
  "numberFormat": "json",
  "rowCount": 1024,
  "rowHidden": true,
  "rowIndex": 1024,
  "text": "json",
  "valueTypes": "string",
  "values": "json"
}