Novidades na API JavaScript 1.12 do Excel

  • Artigo

O ExcelApi 1.12 aumentou o suporte para fórmulas em intervalos ao adicionar APIs para controlar matrizes dinâmicas e encontrar precedentes diretos de uma fórmula. Também adicionou o controlo de API de filtros de Tabela Dinâmica. Foram também efetuadas melhorias nas áreas de funcionalidades de comentários, definições de cultura e propriedades personalizadas.

Área de recurso Descrição Objetos relevantes
Eventos de comentários Adiciona eventos para adicionar, alterar e eliminar à coleção de comentários. CommentCollection
Definições de cultura de data e hora Dá acesso a definições culturais adicionais por volta da formatação de data e hora. CultureInfo, NumberFormatInfoApplication
Precedentes diretos Devolve intervalos que são utilizados para avaliar a fórmula de uma célula. Range
Filtros Dinâmicos Aplica filtros orientados por valores aos campos de uma tabela dinâmica. PivotField, PivotFilters
Transposição de intervalos Permite que os suplementos localizem intervalos associados a resultados de matriz dinâmicos . Range
Propriedades personalizadas ao nível da folha de cálculo Permite que as propriedades personalizadas sejam confinadas ao nível da folha de cálculo, além de serem confinadas ao nível do livro. Folha de CálculoCustomProperty, Folha de CálculoCustomPropertyCollection

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.12. Para ver a documentação de referência da API para todas as APIs suportadas pelo conjunto de requisitos da API JavaScript do Excel definido como 1.12 ou anterior, consulte AS APIs do Excel no conjunto de requisitos 1.12 ou anterior.

Classe Campos Descrição
ChartAxisTitle textOrientation Especifica o ângulo para o qual o texto é orientado para o título do eixo do gráfico.
ChartSeries getDimensionValues(dimensão: Excel.ChartSeriesDimension) Obtém os valores de uma única dimensão da série de gráficos.
Comentário contentType Obtém o tipo de conteúdo do comentário.
CommentAddedEventArgs commentDetails Obtém a CommentDetail matriz que contém o ID de comentário e os IDs das respetivas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o evento ocorreu.
CommentChangedEventArgs changeType Obtém o tipo de alteração que representa a forma como o evento alterado é acionado.
commentDetails Obtenha a CommentDetail matriz que contém o ID de comentário e os IDs das respetivas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o evento ocorreu.
CommentCollection onAdded Ocorre quando os comentários são adicionados.
onChanged Ocorre quando os comentários ou respostas numa coleção de comentários são alterados, incluindo quando as respostas são eliminadas.
onDeleted Ocorre quando os comentários são eliminados na coleção de comentários.
CommentDeletedEventArgs commentDetails Obtém a CommentDetail matriz que contém o ID de comentário e os IDs das respetivas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém o ID da folha de cálculo na qual o evento ocorreu.
CommentDetail commentId Representa o ID do comentário.
replyIds Representa os IDs das respostas relacionadas que pertencem ao comentário.
CommentReply contentType O tipo de conteúdo da resposta.
CultureInfo datetimeFormat Define o formato culturalmente apropriado da apresentação da data e hora.
DatetimeFormatInfo dateSeparator Obtém a cadeia utilizada como separador de data.
longDatePattern Obtém a cadeia de formato para um valor de data longo.
longTimePattern Obtém a cadeia de formato para um valor de tempo longo.
shortDatePattern Obtém a cadeia de formato para um valor de data abreviada.
timeSeparator Obtém a cadeia utilizada como separador de tempo.
PivotDateFilter comparador O comparador é o valor estático ao qual são comparados outros valores.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
exclusivo Se true, o filtro excluirá os itens que cumprem os critérios.
lowerBound O limite inferior do intervalo para a condição de between filtro.
upperBound O limite superior do intervalo para a condição de between filtro.
wholeDays Para equals, before, aftere between condições de filtro, indica se as comparações devem ser feitas como dias inteiros.
PivotField applyFilter(filter: Excel.PivotFilters) Define um ou mais dos Filtros Dinâmicos atuais do campo e aplica-os ao campo.
clearAllFilters() Limpa todos os critérios de todos os filtros do campo.
clearFilter(filterType: Excel.PivotFilterType) Limpa todos os critérios existentes do filtro do campo do tipo especificado (se um estiver atualmente aplicado).
getFilters() Obtém todos os filtros atualmente aplicados no campo.
isFiltered(filterType?: Excel.PivotFilterType) Verifica se existem filtros aplicados no campo.
PivotFilters dateFilter O filtro de data atualmente aplicado do Campo Dinâmico.
labelFilter O filtro de etiqueta atualmente aplicado do Campo Dinâmico.
manualFilter O filtro manual atualmente aplicado do Campo Dinâmico.
valueFilter O filtro de valor atualmente aplicado do Campo Dinâmico.
PivotLabelFilter comparador O comparador é o valor estático ao qual são comparados outros valores.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
exclusivo Se true, o filtro excluirá os itens que cumprem os critérios.
lowerBound O limite inferior do intervalo para a condição de between filtro.
substring A subcadeia utilizada para as beginsWithcondições de filtro , endsWithe contains .
upperBound O limite superior do intervalo para a condição de between filtro.
PivotManualFilter selectedItems Uma lista de itens selecionados para filtrar manualmente.
PivotTable allowMultipleFiltersPerField Especifica se a Tabela Dinâmica permite a aplicação de vários Filtros Dinâmicos num determinado Campo Dinâmico na tabela.
PivotTableScopedCollection getCount() Obtém o número de tabelas dinâmicas na coleção.
getFirst() Obtém a primeira tabela dinâmica na coleção.
getItem(key: string) Obtém uma Tabela Dinâmica por nome.
getItemOrNullObject(name: string) Obtém uma Tabela Dinâmica por nome.
items Obtém os itens filhos carregados nesta coleção.
PivotValueFilter comparador O comparador é o valor estático ao qual são comparados outros valores.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
exclusivo Se true, o filtro excluirá os itens que cumprem os critérios.
lowerBound O limite inferior do intervalo para a condição de between filtro.
selectionType Especifica se o filtro se destina aos itens N superiores/inferiores, percentagem N superior/inferior ou soma N superior/inferior.
limiar O número de limiar "N" de itens, percentagem ou soma a filtrar para uma condição de filtro superior/inferior.
upperBound O limite superior do intervalo para a condição de between filtro.
value Nome do "valor" escolhido no campo pelo qual filtrar.
Range getDirectPrecedents() Devolve um WorkbookRangeAreas objeto que representa o intervalo que contém todas as células precedentes diretas de um intervalo especificado na mesma folha de cálculo ou em várias folhas de cálculo.
getPivotTables(fullyContained?: booleano) Obtém uma coleção de tabelas dinâmicas no âmbito que se sobrepõem ao intervalo.
getSpillParent() Obtém o objeto range que contém a célula âncora para uma célula que recebe o despejo.
getSpillParentOrNullObject() Obtém o objeto de intervalo que contém a célula de âncora para a célula a ser transbordada.
getSpillingToRange() Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora.
getSpillingToRangeOrNullObject() Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora.
hasSpill Representa se todas as células têm uma borda de despejo.
numberFormatCategories Representa a categoria do formato de número de cada célula.
savedAsArray Representa se todas as células seriam guardadas como uma fórmula de matriz.
RangeAreasCollection getCount() Obtém o número de RangeAreas objetos nesta coleção.
getItemAt(index: number) Devolve o RangeAreas objeto com base na posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
WorkbookRangeAreas addresses Devolve uma matriz de endereços no estilo A1.
areas Devolve o RangeAreasCollection objeto .
getRangeAreasBySheet(chave: cadeia) Devolve o RangeAreas objeto com base no ID ou nome da folha de cálculo na coleção.
getRangeAreasOrNullObjectBySheet(chave: cadeia) Devolve o RangeAreas objeto com base no nome ou ID da folha de cálculo na coleção.
intervalos Devolve intervalos que compõem este objeto num RangeCollection objeto.
Planilha customProperties Obtém uma coleção de propriedades personalizadas ao nível da folha de cálculo.
WorksheetCustomProperty delete() Exclui a propriedade personalizada.
key Obtém a chave da propriedade personalizada.
value Obtém ou define o valor da propriedade personalizada.
WorksheetCustomPropertyCollection add(key: string, value: string) Adiciona uma nova propriedade personalizada que mapeia à chave fornecida.
getCount() Obtém o número de propriedades personalizadas nesta folha de cálculo.
getItem(key: string) Obtém um objeto de propriedade personalizada por sua chave, que diferencia maiúsculas de minúsculas.
getItemOrNullObject(key: string) Obtém um objeto de propriedade personalizada por sua chave, que diferencia maiúsculas de minúsculas.
items Obtém os itens filhos carregados nesta coleção.

Confira também