Compartilhar via


Excel.Interfaces.NamedItemData interface

Uma interface que descreve os dados devolvidos ao chamar namedItem.toJSON().

Propriedades

arrayValues

Retorna um objeto que contém valores e tipos do item nomeado.

comment

Especifica o comentário associado a este nome.

formula

A fórmula do item com nome. As fórmulas começam sempre com um sinal de igual ("=").

name

O nome do objeto.

scope

Especifica se o nome está no âmbito do livro ou de uma folha de cálculo específica. Os valores possíveis são: Folha de Cálculo, Livro.

type

Especifica o tipo do valor devolvido pela fórmula do nome. Veja Excel.NamedItemType para obter detalhes.

value

Representa o valor calculado pela fórmula do nome. Para um intervalo com nome, irá devolver o endereço do intervalo. Esta API devolve o #VALUE! na IU do Excel, se se referir a uma função definida pelo utilizador.

valueAsJson

Uma representação JSON dos valores neste item com nome. Ao contrário NamedItem.valuede , NamedItem.valueAsJson suporta todos os tipos de dados que podem estar numa célula. Os exemplos incluem valores numéricos formatados e imagens Web, para além dos valores booleanos, numéricos e de cadeia padrão. Os dados devolvidos a partir desta API estão sempre alinhados com a região en-US. Para obter dados na região de apresentação do utilizador, utilize NamedItem.valueAsJsonLocal.

valueAsJsonLocal

Uma representação JSON dos valores neste item com nome. Ao contrário NamedItem.valuede , NamedItem.valueAsJsonLocal suporta todos os tipos de dados que podem estar numa célula. Os exemplos incluem valores numéricos formatados e imagens Web, para além dos valores booleanos, numéricos e de cadeia padrão. Os dados devolvidos a partir desta API estão sempre alinhados com a região de apresentação do utilizador. Para obter dados independentemente da região, utilize NamedItem.valueAsJson.

visible

Especifica se o objeto está visível.

Detalhes da propriedade

arrayValues

Retorna um objeto que contém valores e tipos do item nomeado.

arrayValues?: Excel.Interfaces.NamedItemArrayValuesData;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

comment

Especifica o comentário associado a este nome.

comment?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.4 ]

formula

A fórmula do item com nome. As fórmulas começam sempre com um sinal de igual ("=").

formula?: any;

Valor da propriedade

any

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

name

O nome do objeto.

name?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

scope

Especifica se o nome está no âmbito do livro ou de uma folha de cálculo específica. Os valores possíveis são: Folha de Cálculo, Livro.

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

Valor da propriedade

Excel.NamedItemScope | "Worksheet" | "Workbook"

Comentários

[ Conjunto de API: ExcelApi 1.4 ]

type

Especifica o tipo do valor devolvido pela fórmula do nome. Veja Excel.NamedItemType para obter detalhes.

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

Valor da propriedade

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

Comentários

[ Conjunto de API: ExcelApi 1.1 para Cadeia,Número Inteiro,Duplo,Booleano,Intervalo,Erro; 1,7 para Matriz ]

value

Representa o valor calculado pela fórmula do nome. Para um intervalo com nome, irá devolver o endereço do intervalo. Esta API devolve o #VALUE! na IU do Excel, se se referir a uma função definida pelo utilizador.

value?: any;

Valor da propriedade

any

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

valueAsJson

Uma representação JSON dos valores neste item com nome. Ao contrário NamedItem.valuede , NamedItem.valueAsJson suporta todos os tipos de dados que podem estar numa célula. Os exemplos incluem valores numéricos formatados e imagens Web, para além dos valores booleanos, numéricos e de cadeia padrão. Os dados devolvidos a partir desta API estão sempre alinhados com a região en-US. Para obter dados na região de apresentação do utilizador, utilize NamedItem.valueAsJsonLocal.

valueAsJson?: CellValue | string;

Valor da propriedade

Excel.CellValue | string

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

valueAsJsonLocal

Uma representação JSON dos valores neste item com nome. Ao contrário NamedItem.valuede , NamedItem.valueAsJsonLocal suporta todos os tipos de dados que podem estar numa célula. Os exemplos incluem valores numéricos formatados e imagens Web, para além dos valores booleanos, numéricos e de cadeia padrão. Os dados devolvidos a partir desta API estão sempre alinhados com a região de apresentação do utilizador. Para obter dados independentemente da região, utilize NamedItem.valueAsJson.

valueAsJsonLocal?: CellValue | string;

Valor da propriedade

Excel.CellValue | string

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

visible

Especifica se o objeto está visível.

visible?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.1 ]