Excel.Interfaces.RangeUpdateData interface
用于更新对象上 Range 的数据的接口，用于 range.set({ ... }).
属性
| column |
表示是否隐藏当前区域中的所有列。 值为 |
| control | 访问应用于此区域的单元格控件。 如果区域有多个单元格控件，则返回 |
| data |
返回数据有效性对象。 |
| format | 返回一个格式对象，其中封装了区域的字体、填充、边框、对齐方式和其他属性。 |
| formula |
指定范围的数组公式。 如果指定区域不包含数组公式，则此属性返回 |
| formulas | 表示采用 A1 表示法的公式。 如果单元格没有公式，则改为返回其值。 |
| formulas |
表示采用 A1 样式表示法的公式，使用用户的语言和数字格式区域设置。 例如，英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。 如果单元格没有公式，则改为返回其值。 |
| formulasR1C1 | 表示采用 R1C1 样式表示法的公式。 如果单元格没有公式，则改为返回其值。 |
| hyperlink | 表示当前范围的超链接。 |
| number |
表示给定范围的 Excel 的数字格式代码。 有关 Excel 数字格式的详细信息，请参阅数字格式代码。 |
| number |
表示基于用户语言设置的给定范围的 Excel 数字格式代码。 Excel 在获取或设置属性时不 |
| row |
表示是否隐藏当前区域中的所有行。 值为 |
| style | 表示当前区域的样式。 如果单元格的样式不一致， |
| values | 表示指定区域的原始值。 返回的数据可以是字符串、数字或布尔值。 包含错误的单元格将返回错误字符串。 如果返回的值以加号 (“+”) 开头、减号 (“-”) 或等号 (“=”) ，Excel 会将此值解释为公式。 |
| values |
此区域中单元格值的 JSON 表示形式。 与 不同， |
| values |
此区域中单元格值的 JSON 表示形式。 与 不同， |
属性详细信息
columnHidden
表示是否隐藏当前区域中的所有列。 值为 true 隐藏某个区域中的所有列的情况。 值为 false 隐藏范围内任何列的情况。 值是指 null 隐藏某个区域中的某些列，而同一区域中的其他列未隐藏。
columnHidden?: boolean;属性值
boolean
注解
control
访问应用于此区域的单元格控件。 如果区域有多个单元格控件，则返回 EmptyCellControl。
control?: CellControl;属性值
注解
dataValidation
返回数据有效性对象。
dataValidation?: Excel.Interfaces.DataValidationUpdateData;属性值
注解
format
返回一个格式对象，其中封装了区域的字体、填充、边框、对齐方式和其他属性。
format?: Excel.Interfaces.RangeFormatUpdateData;属性值
注解
formulaArray
指定范围的数组公式。 如果指定区域不包含数组公式，则此属性返回 null。
formulaArray?: string;属性值
string
注解
formulas
formulasLocal
表示采用 A1 样式表示法的公式，使用用户的语言和数字格式区域设置。 例如，英语中的公式 "=SUM(A1, 1.5)" 在德语中将变为 "=SUMME(A1; 1,5)"。 如果单元格没有公式，则改为返回其值。
formulasLocal?: any[][];属性值
any[][]
注解
formulasR1C1
hyperlink
numberFormat
numberFormatLocal
表示基于用户语言设置的给定范围的 Excel 数字格式代码。 Excel 在获取或设置属性时不 numberFormatLocal 执行任何语言或格式强制。 任何返回的文本都将根据系统设置中指定的语言使用本地格式化的字符串。
numberFormatLocal?: any[][];属性值
any[][]
注解
rowHidden
表示是否隐藏当前区域中的所有行。 值为 true 隐藏区域中的所有行的情况。 值为 false 范围内没有隐藏行的情况。 值表示 null 隐藏某个区域中的某些行，而同一区域中的其他行不隐藏。
rowHidden?: boolean;属性值
boolean
注解
style
表示当前区域的样式。 如果单元格的样式不一致， null 将返回。 对于自定义样式，将返回样式名称。 对于内置样式，将返回表示枚举中 BuiltInStyle 值的字符串。
style?: string;属性值
string
注解
values
表示指定区域的原始值。 返回的数据可以是字符串、数字或布尔值。 包含错误的单元格将返回错误字符串。 如果返回的值以加号 (“+”) 开头、减号 (“-”) 或等号 (“=”) ，Excel 会将此值解释为公式。
values?: any[][];属性值
any[][]
注解
valuesAsJson
此区域中单元格值的 JSON 表示形式。 与 不同， Range.values支持 Range.valuesAsJson 可以在单元格中的所有数据类型。 示例包括格式化数字值和 Web 图像，以及标准布尔值、数字和字符串值。 从此 API 返回的数据始终与 en-US 区域设置一致。 要检索用户显示区域设置中的数据，请使用 Range.valuesAsJsonLocal。
valuesAsJson?: CellValue[][];属性值
Excel.CellValue[][]
注解
valuesAsJsonLocal
此区域中单元格值的 JSON 表示形式。 与 不同， Range.values支持 Range.valuesAsJsonLocal 可以在单元格中的所有数据类型。 示例包括格式化数字值和 Web 图像，以及标准布尔值、数字和字符串值。 从此 API 返回的数据始终与用户的显示区域设置一致。 要检索独立于区域设置的数据，请使用 Range.valuesAsJson。
valuesAsJsonLocal?: CellValue[][];属性值
Excel.CellValue[][]