Excel.Interfaces.NamedItemData interface

  • 参考
包:
excel

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

属性

arrayValues

返回包含已命名项目的值和类型的对象。
comment

指定与此名称关联的注释。
formula

命名项的公式。 公式始终以等号 (“=”) 开头。
name

对象的名称。
scope

指定名称的范围是工作簿还是特定工作表。 可能的值为：Worksheet、Workbook。
type

指定名称公式返回的值的类型。 有关详细信息，请参阅 Excel.NamedItemType。
value

表示 name 公式计算出的值。 对于命名区域，它将返回范围地址。 此 API 返回 #VALUE！ 如果 Excel UI 引用用户定义的函数，则为错误。
valueAsJson

此命名项中值的 JSON 表示形式。 与 不同 NamedItem.value， NamedItem.valueAsJson 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像，以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与 en-US 区域设置一致。 若要检索用户的显示区域设置中的数据，请使用 NamedItem.valueAsJsonLocal。
valueAsJsonLocal

此命名项中值的 JSON 表示形式。 与 不同 NamedItem.value， NamedItem.valueAsJsonLocal 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像，以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与用户的显示区域设置保持一致。 若要检索独立于区域设置的数据，请使用 NamedItem.valueAsJson。
visible

指定对象是否可见。

属性详细信息

arrayValues

返回包含已命名项目的值和类型的对象。

arrayValues?: Excel.Interfaces.NamedItemArrayValuesData;

属性值

Excel.Interfaces.NamedItemArrayValuesData

注解

[ API 集：ExcelApi 1.7 ]

comment

指定与此名称关联的注释。

comment?: string;

属性值

string

注解

[ API 集：ExcelApi 1.4 ]

formula

命名项的公式。 公式始终以等号 (“=”) 开头。

formula?: any;

属性值

any

注解

[ API 集：ExcelApi 1.7 ]

name

对象的名称。

name?: string;

属性值

string

注解

[ API 集：ExcelApi 1.1 ]

scope

指定名称的范围是工作簿还是特定工作表。 可能的值为：Worksheet、Workbook。

scope?: Excel.NamedItemScope | "Worksheet" | "Workbook";

属性值

Excel.NamedItemScope | "Worksheet" | "Workbook"

注解

[ API 集：ExcelApi 1.4 ]

type

指定名称公式返回的值的类型。 有关详细信息，请参阅 Excel.NamedItemType。

type?: Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array";

属性值

Excel.NamedItemType | "String" | "Integer" | "Double" | "Boolean" | "Range" | "Error" | "Array"

注解

[ API 集：ExcelApi 1.1 for String，Integer，Double，Boolean，Range，Error;1.7 for Array ]

value

表示 name 公式计算出的值。 对于命名区域，它将返回范围地址。 此 API 返回 #VALUE！ 如果 Excel UI 引用用户定义的函数，则为错误。

value?: any;

属性值

any

注解

[ API 集：ExcelApi 1.1 ]

valueAsJson

此命名项中值的 JSON 表示形式。 与 不同 NamedItem.value， NamedItem.valueAsJson 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像，以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与 en-US 区域设置一致。 若要检索用户的显示区域设置中的数据，请使用 NamedItem.valueAsJsonLocal。

valueAsJson?: CellValue | string;

属性值

Excel.CellValue | string

注解

[ API 集：ExcelApi 1.16 ]

valueAsJsonLocal

此命名项中值的 JSON 表示形式。 与 不同 NamedItem.value， NamedItem.valueAsJsonLocal 支持可在单元格中的所有数据类型。 示例包括格式化的数字值和 Web 图像，以及标准布尔值、数字值和字符串值。 从此 API 返回的数据始终与用户的显示区域设置保持一致。 若要检索独立于区域设置的数据，请使用 NamedItem.valueAsJson。

valueAsJsonLocal?: CellValue | string;

属性值

Excel.CellValue | string

注解

[ API 集：ExcelApi 1.16 ]

visible

指定对象是否可见。

visible?: boolean;

属性值

boolean

注解

[ API 集：ExcelApi 1.1 ]