Excel.Interfaces.RangeCollectionLoadOptions interface

注解

[ API 集:ExcelApi 1.9 ]

属性

$all

$all为加载选项指定将加载所有标量属性 ((例如Range.address) ,但不加载导航属性 (如 Range.format.fill.color) )。

address

对于集合中的每个项:指定 A1 样式中的范围引用。 地址值包含工作表引用 (例如“Sheet1!A1:B4“) 。

addressLocal

对于集合中的每个项:表示用户语言中指定区域的区域引用。

cellCount

对于集合中的每个项:指定区域中的单元格数。 如果单元格数超过 2^31-1 (2,147,483,647),此 API 返回 -1。

columnCount

对于集合中的每个项:指定区域中的列总数。

columnHidden

对于集合中的每个项:表示当前范围中的所有列是否处于隐藏状态。 true当一个区域中的所有列都隐藏时,值。 false当区域中没有列处于隐藏状态时,该值为 。 null当某个区域中的某些列处于隐藏状态且不隐藏同一范围中的其他列时,该值表示。

columnIndex

对于集合中的每个项:指定区域中第一个单元格的列号。 从零开始编制索引。

control

对于集合中的每个项:访问应用于此区域的单元格控件。 如果区域有多个单元格控件,则返回 EmptyCellControl

dataValidation

对于集合中的每个项:返回一个数据验证对象。

format

对于集合中的每个项:返回一个格式对象,该对象封装区域的字体、填充、边框、对齐方式和其他属性。

formulas

对于集合中的每个项:表示 A1 样式表示法中的公式。 如果单元格没有公式,则返回其值。

formulasLocal

对于集合中的每个项:表示 A1 样式表示法、用户语言和数字格式区域设置中的公式。 例如,英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。 如果单元格没有公式,则返回其值。

formulasR1C1

对于集合中的每个项:表示 R1C1 样式表示法中的公式。 如果单元格没有公式,则返回其值。

hasSpill

对于集合中的每个项:表示是否所有单元格都具有溢出边框。 true如果所有单元格都有溢出边框,或者false所有单元格都没有溢出边框,则返回 。 null如果区域中有和没有溢出边框的单元格,则返回 。

height

对于集合中的每个项:返回从范围上边缘到范围下边缘的 100% 缩放的距离(以磅为单位)。

hidden

对于集合中的每个项:表示当前区域中的所有单元格是否都处于隐藏状态。 值是 true 隐藏区域中的所有单元格时。 false当区域中没有单元格被隐藏时,值。 null当某个区域中的某些单元格处于隐藏状态,而同一区域中的其他单元格未隐藏时,值表示。

hyperlink

对于集合中的每个项:表示当前范围的超链接。

isEntireColumn

对于集合中的每个项:表示当前范围是否为整列。

isEntireRow

对于集合中的每个项:表示当前范围是否为整行。

left

对于集合中的每个项:返回从工作表的左边缘到区域左边缘的距离(以磅为单位)。缩放比例为 100%。

linkedDataTypeState

对于集合中的每个项:表示每个单元格的数据类型状态。

numberFormat

对于集合中的每个项目:表示给定区域的 Excel 数字格式代码。 有关 Excel 数字格式的详细信息,请参阅 数字格式代码

numberFormatCategories

对于集合中的每个项:表示每个单元格的数字格式的类别。

numberFormatLocal

对于集合中的每个项目:表示基于用户语言设置的给定范围的 Excel 数字格式代码。 获取或设置 numberFormatLocal 属性时,Excel 不执行任何语言或格式强制。 任何返回的文本都根据系统设置中指定的语言使用本地格式的字符串。

rowCount

对于集合中的每个项:返回区域中的行总数。

rowHidden

对于集合中的每个项:表示当前范围中的所有行是否隐藏。 值是 true 隐藏范围中的所有行时。 false当区域中没有隐藏行时,值。 null当某个区域中的某些行处于隐藏状态且同一区域中的其他行未隐藏时,该值表示。

rowIndex

对于集合中的每个项:返回区域中第一个单元格的行号。 从零开始编制索引。

savedAsArray

对于集合中的每个项:表示是否将所有单元格另存为数组公式。 true如果所有单元格都另存为数组公式,或者false所有单元格不另存为数组公式,则返回 。 null如果某些单元格将保存为数组公式,而有些单元格则不保存,则返回 。

style

对于集合中的每个项:表示当前区域的样式。 如果单元格的样式不一致, null 将返回 。 对于自定义样式,将返回样式名称。 对于内置样式,将返回表示枚举中的 BuiltInStyle 值的字符串。

text

对于集合中的每个项:指定范围的文本值。 文本值与单元格宽度无关。 Excel UI 中发生的数字符号 (#) 替换不会影响 API 返回的文本值。

top

对于集合中的每个项:返回从工作表上边缘到区域上边缘的 100% 缩放的距离(以磅为单位)。

values

对于集合中的每个项:表示指定区域的原始值。 返回的数据可以是字符串、数字或布尔值。 包含错误的单元格将返回错误字符串。 如果返回的值以加号 (“+”) 、减 (“-”) 或等号 (“=”) 开头,Excel 会将此值解释为公式。

valuesAsJson

对于集合中的每个项:此区域中单元格中值的 JSON 表示形式。 与 不同 Range.valuesRange.valuesAsJson 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像,以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与 en-US 区域设置一致。 若要检索用户的显示区域设置中的数据,请使用 Range.valuesAsJsonLocal

valuesAsJsonLocal

对于集合中的每个项:此区域中单元格中值的 JSON 表示形式。 与 不同 Range.valuesRange.valuesAsJsonLocal 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像,以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与用户的显示区域设置保持一致。 若要检索独立于区域设置的数据,请使用 Range.valuesAsJson

valueTypes

对于集合中的每个项:指定每个单元格中的数据类型。

width

对于集合中的每个项:返回从范围左边缘到区域右边缘的距离(以磅为单位),以便 100% 缩放。

worksheet

对于集合中的每个项:包含当前区域的工作表。

属性详细信息

$all

$all为加载选项指定将加载所有标量属性 ((例如Range.address) ,但不加载导航属性 (如 Range.format.fill.color) )。

$all?: boolean;

属性值

boolean

address

对于集合中的每个项:指定 A1 样式中的范围引用。 地址值包含工作表引用 (例如“Sheet1!A1:B4“) 。

address?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

addressLocal

对于集合中的每个项:表示用户语言中指定区域的区域引用。

addressLocal?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

cellCount

对于集合中的每个项:指定区域中的单元格数。 如果单元格数超过 2^31-1 (2,147,483,647),此 API 返回 -1。

cellCount?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

columnCount

对于集合中的每个项:指定区域中的列总数。

columnCount?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

columnHidden

对于集合中的每个项:表示当前范围中的所有列是否处于隐藏状态。 true当一个区域中的所有列都隐藏时,值。 false当区域中没有列处于隐藏状态时,该值为 。 null当某个区域中的某些列处于隐藏状态且不隐藏同一范围中的其他列时,该值表示。

columnHidden?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.2 ]

columnIndex

对于集合中的每个项:指定区域中第一个单元格的列号。 从零开始编制索引。

columnIndex?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

control

注意

此 API 以预览状态提供给开发者,可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

对于集合中的每个项:访问应用于此区域的单元格控件。 如果区域有多个单元格控件,则返回 EmptyCellControl

control?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi BETA (仅预览版) ]

dataValidation

对于集合中的每个项:返回一个数据验证对象。

dataValidation?: Excel.Interfaces.DataValidationLoadOptions;

属性值

注解

[ API 集:ExcelApi 1.9 ]

format

对于集合中的每个项:返回一个格式对象,该对象封装区域的字体、填充、边框、对齐方式和其他属性。

format?: Excel.Interfaces.RangeFormatLoadOptions;

属性值

注解

[ API 集:ExcelApi 1.9 ]

formulas

对于集合中的每个项:表示 A1 样式表示法中的公式。 如果单元格没有公式,则返回其值。

formulas?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

formulasLocal

对于集合中的每个项:表示 A1 样式表示法、用户语言和数字格式区域设置中的公式。 例如,英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。 如果单元格没有公式,则返回其值。

formulasLocal?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

formulasR1C1

对于集合中的每个项:表示 R1C1 样式表示法中的公式。 如果单元格没有公式,则返回其值。

formulasR1C1?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.2 ]

hasSpill

对于集合中的每个项:表示是否所有单元格都具有溢出边框。 true如果所有单元格都有溢出边框,或者false所有单元格都没有溢出边框,则返回 。 null如果区域中有和没有溢出边框的单元格,则返回 。

hasSpill?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.12 ]

height

对于集合中的每个项:返回从范围上边缘到范围下边缘的 100% 缩放的距离(以磅为单位)。

height?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.10 ]

hidden

对于集合中的每个项:表示当前区域中的所有单元格是否都处于隐藏状态。 值是 true 隐藏区域中的所有单元格时。 false当区域中没有单元格被隐藏时,值。 null当某个区域中的某些单元格处于隐藏状态,而同一区域中的其他单元格未隐藏时,值表示。

hidden?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.2 ]

对于集合中的每个项:表示当前范围的超链接。

hyperlink?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.7 ]

isEntireColumn

对于集合中的每个项:表示当前范围是否为整列。

isEntireColumn?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.7 ]

isEntireRow

对于集合中的每个项:表示当前范围是否为整行。

isEntireRow?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.7 ]

left

对于集合中的每个项:返回从工作表的左边缘到区域左边缘的距离(以磅为单位)。缩放比例为 100%。

left?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.10 ]

linkedDataTypeState

对于集合中的每个项:表示每个单元格的数据类型状态。

linkedDataTypeState?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.9 ]

numberFormat

对于集合中的每个项目:表示给定区域的 Excel 数字格式代码。 有关 Excel 数字格式的详细信息,请参阅 数字格式代码

numberFormat?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

numberFormatCategories

对于集合中的每个项:表示每个单元格的数字格式的类别。

numberFormatCategories?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.12 ]

numberFormatLocal

对于集合中的每个项目:表示基于用户语言设置的给定范围的 Excel 数字格式代码。 获取或设置 numberFormatLocal 属性时,Excel 不执行任何语言或格式强制。 任何返回的文本都根据系统设置中指定的语言使用本地格式的字符串。

numberFormatLocal?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.7 ]

rowCount

对于集合中的每个项:返回区域中的行总数。

rowCount?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

rowHidden

对于集合中的每个项:表示当前范围中的所有行是否隐藏。 值是 true 隐藏范围中的所有行时。 false当区域中没有隐藏行时,值。 null当某个区域中的某些行处于隐藏状态且同一区域中的其他行未隐藏时,该值表示。

rowHidden?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.2 ]

rowIndex

对于集合中的每个项:返回区域中第一个单元格的行号。 从零开始编制索引。

rowIndex?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

savedAsArray

对于集合中的每个项:表示是否将所有单元格另存为数组公式。 true如果所有单元格都另存为数组公式,或者false所有单元格不另存为数组公式,则返回 。 null如果某些单元格将保存为数组公式,而有些单元格则不保存,则返回 。

savedAsArray?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.12 ]

style

对于集合中的每个项:表示当前区域的样式。 如果单元格的样式不一致, null 将返回 。 对于自定义样式,将返回样式名称。 对于内置样式,将返回表示枚举中的 BuiltInStyle 值的字符串。

style?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.7 ]

text

对于集合中的每个项:指定范围的文本值。 文本值与单元格宽度无关。 Excel UI 中发生的数字符号 (#) 替换不会影响 API 返回的文本值。

text?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

top

对于集合中的每个项:返回从工作表上边缘到区域上边缘的 100% 缩放的距离(以磅为单位)。

top?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.10 ]

values

对于集合中的每个项:表示指定区域的原始值。 返回的数据可以是字符串、数字或布尔值。 包含错误的单元格将返回错误字符串。 如果返回的值以加号 (“+”) 、减 (“-”) 或等号 (“=”) 开头,Excel 会将此值解释为公式。

values?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

valuesAsJson

对于集合中的每个项:此区域中单元格中值的 JSON 表示形式。 与 不同 Range.valuesRange.valuesAsJson 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像,以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与 en-US 区域设置一致。 若要检索用户的显示区域设置中的数据,请使用 Range.valuesAsJsonLocal

valuesAsJson?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.16 ]

valuesAsJsonLocal

对于集合中的每个项:此区域中单元格中值的 JSON 表示形式。 与 不同 Range.valuesRange.valuesAsJsonLocal 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像,以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与用户的显示区域设置保持一致。 若要检索独立于区域设置的数据,请使用 Range.valuesAsJson

valuesAsJsonLocal?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.16 ]

valueTypes

对于集合中的每个项:指定每个单元格中的数据类型。

valueTypes?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.1 ]

width

对于集合中的每个项:返回从范围左边缘到区域右边缘的距离(以磅为单位),以便 100% 缩放。

width?: boolean;

属性值

boolean

注解

[ API 集:ExcelApi 1.10 ]

worksheet

对于集合中的每个项:包含当前区域的工作表。

worksheet?: Excel.Interfaces.WorksheetLoadOptions;

属性值

注解

[ API 集:ExcelApi 1.9 ]