Compartilhar via


Excel.Interfaces.RangeUpdateData interface

Uma interface para atualizar dados no objeto Range, para uso em range.set({ ... }).

Propriedades

columnHidden

Representa se todas as colunas no intervalo atual estiverem ocultas. O valor é true quando todas as colunas em um intervalo são ocultas. O valor é false quando nenhuma coluna no intervalo está oculta. O valor é null quando algumas colunas em um intervalo são ocultas e outras colunas no mesmo intervalo não são ocultas.

dataValidation

Retorna um objeto de validação de dados.

format

Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.

formulas

Representa a fórmula em notação A1. Se uma célula não tiver fórmula, seu valor será retornado.

formulasLocal

Representa a fórmula em notação A1, na formatação de número da localidade e no idioma do usuário. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado.

formulasR1C1

Representa a fórmula em notação no estilo L1C1. Se uma célula não tiver fórmula, seu valor será retornado.

hyperlink

Representa o hiperlink para o intervalo atual.

numberFormat

Representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número.

numberFormatLocal

Representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de idioma do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a numberFormatLocal propriedade. Qualquer texto retornado usa as cadeias de caracteres formatadas localmente com base no idioma especificado nas configurações do sistema.

rowHidden

Representa se todas as linhas no intervalo atual estiverem ocultas. O valor é true quando todas as linhas em um intervalo são ocultas. O valor é false quando nenhuma linha no intervalo é oculta. O valor é null quando algumas linhas em um intervalo estão ocultas e outras linhas no mesmo intervalo não são ocultas.

style

Representa o estilo de intervalo atual. Se os estilos das células forem inconsistentes, null serão retornados. Para estilos personalizados, o nome do estilo será retornado. Para estilos internos, uma cadeia de caracteres que representa um valor no BuiltInStyle enum será retornada.

values

Representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula.

valuesAsJson

Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.valuesde , Range.valuesAsJson dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham com a localidade en-US. Para recuperar dados na localidade de exibição do usuário, use Range.valuesAsJsonLocal.

valuesAsJsonLocal

Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.valuesde , Range.valuesAsJsonLocal dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham à localidade de exibição do usuário. Para recuperar dados independentes da localidade, use Range.valuesAsJson.

Detalhes da propriedade

columnHidden

Representa se todas as colunas no intervalo atual estiverem ocultas. O valor é true quando todas as colunas em um intervalo são ocultas. O valor é false quando nenhuma coluna no intervalo está oculta. O valor é null quando algumas colunas em um intervalo são ocultas e outras colunas no mesmo intervalo não são ocultas.

columnHidden?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

dataValidation

Retorna um objeto de validação de dados.

dataValidation?: Excel.Interfaces.DataValidationUpdateData;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.8 ]

format

Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.

format?: Excel.Interfaces.RangeFormatUpdateData;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulas

Representa a fórmula em notação A1. Se uma célula não tiver fórmula, seu valor será retornado.

formulas?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulasLocal

Representa a fórmula em notação A1, na formatação de número da localidade e no idioma do usuário. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado.

formulasLocal?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

formulasR1C1

Representa a fórmula em notação no estilo L1C1. Se uma célula não tiver fórmula, seu valor será retornado.

formulasR1C1?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

Representa o hiperlink para o intervalo atual.

hyperlink?: Excel.RangeHyperlink;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

numberFormat

Representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número.

numberFormat?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

numberFormatLocal

Representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de idioma do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a numberFormatLocal propriedade. Qualquer texto retornado usa as cadeias de caracteres formatadas localmente com base no idioma especificado nas configurações do sistema.

numberFormatLocal?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

rowHidden

Representa se todas as linhas no intervalo atual estiverem ocultas. O valor é true quando todas as linhas em um intervalo são ocultas. O valor é false quando nenhuma linha no intervalo é oculta. O valor é null quando algumas linhas em um intervalo estão ocultas e outras linhas no mesmo intervalo não são ocultas.

rowHidden?: boolean;

Valor da propriedade

boolean

Comentários

[ Conjunto de API: ExcelApi 1.2 ]

style

Representa o estilo de intervalo atual. Se os estilos das células forem inconsistentes, null serão retornados. Para estilos personalizados, o nome do estilo será retornado. Para estilos internos, uma cadeia de caracteres que representa um valor no BuiltInStyle enum será retornada.

style?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

values

Representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula.

values?: any[][];

Valor da propriedade

any[][]

Comentários

[ Conjunto de API: ExcelApi 1.1 ]

valuesAsJson

Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.valuesde , Range.valuesAsJson dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham com a localidade en-US. Para recuperar dados na localidade de exibição do usuário, use Range.valuesAsJsonLocal.

valuesAsJson?: CellValue[][];

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.16 ]

valuesAsJsonLocal

Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.valuesde , Range.valuesAsJsonLocal dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham à localidade de exibição do usuário. Para recuperar dados independentes da localidade, use Range.valuesAsJson.

valuesAsJsonLocal?: CellValue[][];

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.16 ]