Excel.Interfaces.RangeData interface

一个接口,用于描述通过调用 range.toJSON()返回的数据。

属性

address

指定 A1 样式中的区域引用。 地址值包含工作表引用 (例如“Sheet1!A1:B4“) 。

addressLocal

表示用户语言中指定范围的范围引用。

cellCount

指定区域中的单元格数。 如果单元格数超过 2^31-1 (2,147,483,647),此 API 返回 -1。

columnCount

指定区域中的列总数。

columnIndex

指定区域中第一个单元格的列号。 从零开始编制索引。

format

返回一个格式对象,其中封装了区域的字体、填充、边框、对齐方式和其他属性。

formulas

表示采用 A1 表示法的公式。 如果单元格没有公式,则返回其值。

formulasLocal

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

numberFormat

表示给定区域的 Excel 数字格式代码。 有关 Excel 数字格式的详细信息,请参阅 数字格式代码

rowCount

返回区域中的总行数。

rowIndex

返回区域中第一个单元格的行编号。 从零开始编制索引。

text

指定区域的文本值。 文本值与单元格宽度无关。 Excel UI 中发生的数字符号 (#) 替换不会影响 API 返回的文本值。

values

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

valueTypes

指定每个单元格中的数据类型。

属性详细信息

address

指定 A1 样式中的区域引用。 地址值包含工作表引用 (例如“Sheet1!A1:B4“) 。

address?: string;

属性值

string

注解

[ API 集:ExcelApi 1.1 ]

addressLocal

表示用户语言中指定范围的范围引用。

addressLocal?: string;

属性值

string

注解

[ API 集:ExcelApi 1.1 ]

cellCount

指定区域中的单元格数。 如果单元格数超过 2^31-1 (2,147,483,647),此 API 返回 -1。

cellCount?: number;

属性值

number

注解

[ API 集:ExcelApi 1.1 ]

columnCount

指定区域中的列总数。

columnCount?: number;

属性值

number

注解

[ API 集:ExcelApi 1.1 ]

columnIndex

指定区域中第一个单元格的列号。 从零开始编制索引。

columnIndex?: number;

属性值

number

注解

[ API 集:ExcelApi 1.1 ]

format

返回一个格式对象,其中封装了区域的字体、填充、边框、对齐方式和其他属性。

format?: Excel.Interfaces.RangeFormatData;

属性值

注解

[ API 集:ExcelApi 1.1 ]

formulas

表示采用 A1 表示法的公式。 如果单元格没有公式,则返回其值。

formulas?: any[][];

属性值

any[][]

注解

[ API 集:ExcelApi 1.1 ]

formulasLocal

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

formulasLocal?: any[][];

属性值

any[][]

注解

[ API 集:ExcelApi 1.1 ]

numberFormat

表示给定区域的 Excel 数字格式代码。 有关 Excel 数字格式的详细信息,请参阅 数字格式代码

numberFormat?: any[][];

属性值

any[][]

注解

[ API 集:ExcelApi 1.1 ]

rowCount

返回区域中的总行数。

rowCount?: number;

属性值

number

注解

[ API 集:ExcelApi 1.1 ]

rowIndex

返回区域中第一个单元格的行编号。 从零开始编制索引。

rowIndex?: number;

属性值

number

注解

[ API 集:ExcelApi 1.1 ]

text

指定区域的文本值。 文本值与单元格宽度无关。 Excel UI 中发生的数字符号 (#) 替换不会影响 API 返回的文本值。

text?: string[][];

属性值

string[][]

注解

[ API 集:ExcelApi 1.1 ]

values

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

values?: any[][];

属性值

any[][]

注解

[ API 集:ExcelApi 1.1 ]

valueTypes

指定每个单元格中的数据类型。

valueTypes?: Excel.RangeValueType[][];

属性值

注解

[ API 集:ExcelApi 1.1 ]