区域资源类型

命名空间:microsoft.graph

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

方法

方法 返回类型 说明
获取区域 区域 读取 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 布尔 表示当前区域中的所有单元格是否隐藏。 只读。
numberFormat Json 表示 Excel 中指定单元格的数字格式代码。
rowCount int 返回区域中的总行数。 只读。
rowHidden boolean 表示当前区域中的所有行是否隐藏。
rowIndex int 返回区域中第一个单元格的行编号。 从零开始编制索引。 只读。
text Json 指定区域的文本值。 Text 值不依赖于单元格宽度。 Excel UI 中发生的 # 符号替换不会影响 API 返回的文本值。 只读。
valueTypes Json 表示每个单元格的数据类型。 可取值包括:UnknownEmptyStringIntegerDoubleBooleanError。 只读。
values Json 表示指定区域的原始值。 返回的数据可能是字符串、数字,也可能是布尔值。 包含错误的单元格返回错误字符串。

关系

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

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"
}