Novidades no Excel API JavaScript 1.12

O ExcelApi 1.12 aumentou o suporte para fórmulas em intervalos adicionando APIs para acompanhar matrizes dinâmicas e encontrar precedentes diretos de uma fórmula. Ele também adicionou controle de API de filtros de tabela dinâmica. Também foram feitas melhorias nas áreas de recursos de comentários, configurações de cultura e propriedades personalizadas.

Área de recurso Descrição Objetos relevantes
Eventos de comentários Adiciona eventos para adicionar, alterar e excluir à coleção de comentários. CommentCollection
Configurações de cultura de data e hora Dá acesso a configurações culturais adicionais relacionadas à formatação de data e hora. CultureInfo, NumberFormatInfoApplication
Precedentes diretos Retorna intervalos usados para avaliar a fórmula de uma célula. Range
Filtros dinâmicos Aplica filtros controlados por valor aos campos de uma Tabela Dinâmica. PivotField, PivotFilters
Despejo de alcance Permite que os suplementos localizem intervalos associados a resultados de matriz dinâmica . Range
Propriedades personalizadas em nível de planilha Permite que as propriedades personalizadas sejam definidas no nível da planilha, além de serem definidas no nível da pasta de trabalho. WorksheetCustomProperty, WorksheetCustomPropertyCollection

Lista de APIs

A tabela a seguir lista as APIs no Excel Conjunto de requisitos da API JavaScript 1.12. Para exibir a documentação de referência da API para todas as APIs compatíveis com o conjunto de requisitos da API JavaScript do Excel 1.12 ou anterior, consulte APIs do Excel no conjunto de requisitos 1.12 ou anterior.

Classe Campos Descrição
ChartAxisTitle textOrientation Especifica o ângulo no qual o texto é orientado para o título do eixo do gráfico.
ChartSeries getDimensionValues(dimension: Excel.ChartSeriesDimension) Obtém os valores de uma única dimensão da série do gráfico.
Comentário contentType Obtém o tipo de conteúdo do comentário.
CommentAddedEventArgs commentDetails Obtém a CommentDetail matriz que contém a ID do comentário e as IDs de suas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha na qual o evento aconteceu.
CommentChangedEventArgs changeType Obtém o tipo de alteração que representa como o evento alterado é disparado.
commentDetails Obtém a CommentDetail matriz que contém a ID do comentário e as IDs de suas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha na qual o evento aconteceu.
CommentCollection onAdded Ocorre quando os comentários são adicionados.
onChanged Ocorre quando comentários ou respostas em uma coleção de comentários são alterados, inclusive quando as respostas são excluídas.
onDeleted Ocorre quando os comentários são excluídos na coleção de comentários.
CommentDeletedEventArgs commentDetails Obtém a CommentDetail matriz que contém a ID do comentário e as IDs de suas respostas relacionadas.
source Especifica a origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha na qual o evento aconteceu.
CommentDetail commentId Representa a ID do comentário.
replyIds Representa as 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 de exibição de data e hora.
DatetimeFormatInfo dateSeparator Obtém a cadeia de caracteres usada como separador de data.
longDatePattern Obtém a cadeia de caracteres de formato para um valor de data longo.
longTimePattern Obtém a cadeia de caracteres de formato para um valor de tempo longo.
shortDatePattern Obtém a cadeia de caracteres de formato para um valor de data abreviada.
timeSeparator Obtém a cadeia de caracteres usada como separador de tempo.
PivotDateFilter comparador O comparador é o valor estático com o qual outros valores são comparados.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
Exclusivo Se true, o filtro exclui itens que atendem aos critérios.
lowerBound O limite inferior do intervalo para a between condição de filtro.
upperBound O limite superior do intervalo para a between condição de filtro.
wholeDays Para equals, before, after, e between condições de filtro, indica se as comparações devem ser feitas como dias inteiros.
PivotField applyFilter(filtro: Excel.PivotFilters) Define um ou mais dos PivotFilters atuais do campo e os aplica 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 fornecido (se algum estiver aplicado no momento).
getFilters() Obtém todos os filtros atualmente aplicados no campo.
isFiltered(filterType?: Excel.PivotFilterType) Verifica se há filtros aplicados no campo.
PivotFilters dateFilter O filtro de data aplicado no momento do Campo Dinâmico.
labelFilter O filtro de rótulo aplicado no momento do Campo Dinâmico.
manualFilter O filtro manual aplicado no momento do Campo Dinâmico.
valueFilter O filtro de valor aplicado no momento do Campo Dinâmico.
PivotLabelFilter comparador O comparador é o valor estático com o qual outros valores são comparados.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
Exclusivo Se true, o filtro exclui itens que atendem aos critérios.
lowerBound O limite inferior do intervalo para a between condição de filtro.
substring A subcadeia de caracteres usada para as beginsWithcondições , endsWithe contains filter.
upperBound O limite superior do intervalo para a between condição de 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 PivotFilters em um determinado PivotField na tabela.
PivotTableScopedCollection getCount() Obtém o número de Tabelas Dinâmicas na coleção.
getFirst() Obtém a primeira Tabela Dinâmica da 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 com o qual outros valores são comparados.
condição Especifica a condição para o filtro, que define os critérios de filtragem necessários.
Exclusivo Se true, o filtro exclui itens que atendem aos critérios.
lowerBound O limite inferior do intervalo para a between condição de filtro.
selectionType Especifica se o filtro é para os N itens superior/inferior, N por cento superior/inferior ou soma N superior/inferior.
de aviso O número limite "N" de itens, porcentagem ou soma a serem filtrados para uma condição de filtro superior/inferior.
upperBound O limite superior do intervalo para a between condição de filtro.
value Nome do "valor" escolhido no campo pelo qual filtrar.
Range getDirectPrecedents() Retorna um WorkbookRangeAreas objeto que representa o intervalo que contém todas as células de precedente direta de um intervalo especificado na mesma planilha ou em várias planilhas.
getPivotTables(fullyContained?: boolean) Obtém uma coleção com escopo de Tabelas Dinâmicas 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 âncora da célula que está sendo despejada.
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 salvas como uma fórmula de matriz.
RangeAreasCollection getCount() Obtém o número de RangeAreas objetos nesta coleção.
getItemAt(index: number) Retorna o RangeAreas objeto com base na posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
WorkbookRangeAreas addresses Retorna uma matriz de endereços no estilo A1.
areas Retorna o RangeAreasCollection objeto.
getRangeAreasBySheet(chave: string) Retorna o RangeAreas objeto com base na ID da planilha ou no nome da coleção.
getRangeAreasOrNullObjectBySheet(chave: string) Retorna o RangeAreas objeto com base no nome ou na ID da planilha da coleção.
de produção Retorna intervalos que compreendem esse objeto em um RangeCollection objeto.
Planilha customProperties Obtém uma coleção de propriedades personalizadas no nível da planilha.
WorksheetCustomProperty delete() Exclui a propriedade personalizada.
key Obtém a chave da propriedade personalizada.
value Especifica o valor da propriedade personalizada.
WorksheetCustomPropertyCollection add(key: string, value: string) Adiciona uma nova propriedade personalizada que mapeia para a chave fornecida.
getCount() Obtém o número de propriedades personalizadas nesta planilha.
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