Novidades na API JavaScript do Excel 1.14

  • Artigo

O ExcelApi 1.14 adicionou objetos para controlar o recurso de tabela de dados de um gráfico, um método para localizar todas as células precedentes de uma fórmula e eventos de proteção de planilha para acompanhar as alterações no estado de proteção de uma planilha. Ele também adicionou vários getItemOrNullObject métodos para objetos como CommentCollection, ShapeCollectione StyleCollection para melhorar o tratamento de erros.

Área de recurso Descrição Objetos relevantes
Tabelas de dados do gráfico Controlar a aparência, a formatação e a visibilidade das tabelas de dados nos gráficos. Gráfico, ChartDataTable, ChartDataTableFormat
Precedentes de fórmula Retorne todas as células precedentes de uma fórmula. Range
Consultas Recupere Power Query atributos como nome, data de atualização e contagem de consultas. Consulta, QueryCollection
Eventos de proteção de planilha Acompanhe as alterações no estado de proteção de uma planilha e na origem dessas alterações. WorksheetProtectionChangedEventArgs, Worksheet, WorksheetCollection

Lista de API

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

Classe Campos Descrição
AutoFilter clearColumnCriteria(columnIndex: number) Limpa os critérios de filtro de coluna do AutoFilter.
ChangeDirectionState deleteShiftDirection Representa a direção (como para cima ou para a esquerda) que as células restantes mudarão quando uma célula ou células forem excluídas.
insertShiftDirection Representa a direção (como para baixo ou para a direita) que as células existentes mudarão quando uma nova célula ou células forem inseridas.
Gráfico getDataTable() Obtém a tabela de dados no gráfico.
getDataTableOrNullObject() Obtém a tabela de dados no gráfico.
ChartDataTable format Representa o formato de uma tabela de dados do gráfico, que inclui preenchimento, fonte e formato de borda.
showHorizontalBorder Especifica se deve exibir a borda horizontal da tabela de dados.
showLegendKey Especifica se deve mostrar a chave de legenda da tabela de dados.
showOutlineBorder Especifica se deve exibir a borda de contorno da tabela de dados.
showVerticalBorder Especifica se deve exibir a borda vertical da tabela de dados.
visible Especifica se deve mostrar a tabela de dados do gráfico.
ChartDataTableFormat borda Representa o formato de borda da tabela de dados do gráfico, que inclui cor, estilo de linha e peso.
fill Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.
font Representa os atributos de fonte (como nome da fonte, tamanho da fonte e cor) para o objeto atual.
CommentCollection getItemOrNullObject(commentId: string) Obtém um comentário da coleção com base em seu ID.
CommentReplyCollection getItemOrNullObject(commentReplyId: string) Retorna uma resposta de comentário identificada pela respectiva ID.
ConditionalFormatCollection getItemOrNullObject(id: string) Retorna um formato condicional identificado por sua ID.
GroupShapeCollection getItemOrNullObject(key: string) Obtém uma forma usando seu nome ou ID.
Query error Obtém a mensagem de erro de consulta de quando a consulta foi atualizada pela última vez.
loadedTo Obtém a consulta carregada no tipo de objeto.
loadedToDataModel Especifica se a consulta foi carregada no modelo de dados.
name Obtém o nome da consulta.
refreshDate Obtém a data e a hora em que a consulta foi atualizada pela última vez.
rowsLoadedCount Obtém o número de linhas que foram carregadas quando a consulta foi atualizada pela última vez.
QueryCollection getCount() Obtém o número de consultas na pasta de trabalho.
getItem(key: string) Obtém uma consulta da coleção com base em seu nome.
items Obtém os itens filhos carregados nesta coleção.
Range getPrecedents() Retorna um WorkbookRangeAreas objeto que representa o intervalo que contém todas as células precedentes de um intervalo especificado na mesma planilha ou em várias planilhas.
ShapeCollection getItemOrNullObject(key: string) Obtém uma forma usando seu nome ou ID.
StyleCollection getItemOrNullObject(name: string) Obtém um estilo por nome.
TableScopedCollection getItemOrNullObject(key: string) Obtém uma tabela pelo nome ou ID.
Pasta de trabalho Consultas Retorna uma coleção de consultas Power Query que fazem parte da pasta de trabalho.
Planilha onProtectionChanged Ocorre quando o estado de proteção de planilha é alterado.
tabId Retorna um valor que representa essa planilha que pode ser lido pelo Open Office XML.
WorksheetChangedEventArgs changeDirectionState Representa uma alteração na direção em que as células em uma planilha mudarão quando uma célula ou células forem excluídas ou inseridas.
triggerSource Representa a origem do gatilho do evento.
WorksheetCollection onProtectionChanged Ocorre quando o estado de proteção de planilha é alterado.
WorksheetProtectionChangedEventArgs Isprotected Obtém o status de proteção atual da planilha.
source A origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha na qual o status de proteção é alterado.

Confira também