Novidades na API JavaScript do Excel 1.14
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
, ShapeCollection
e 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. |