Partilhar via

Novidades na API JavaScript do Excel 1.13

  • Artigo

O ExcelApi 1.13 adicionou um método para inserir planilhas em uma pasta de trabalho de uma cadeia de caracteres codificada base64 e um evento para detectar a ativação da pasta de trabalho. Também aumentou o suporte para fórmulas em intervalos adicionando APIs para acompanhar as alterações nas fórmulas e localizar as células dependentes diretas de uma fórmula. Além disso, expandiu o suporte à Tabela Dinâmica adicionando APIs PivotLayout para texto alt, estilo e gerenciamento de células vazios.

Área de recurso Descrição Objetos relevantes
Eventos alterados de fórmula Acompanhe as alterações nas fórmulas, incluindo a origem e o tipo de evento que causaram uma alteração. Planilha.onFormulaChanged
Dependentes de fórmula Localize as células dependentes diretas de uma fórmula. Range.getDirectDependents
Inserir planilhas Insira planilhas de outra pasta de trabalho na pasta de trabalho atual como uma cadeia de caracteres codificada em Base64. Workbook.insertWorksheetsFromBase64
PivotTable PivotLayout Uma expansão da classe PivotLayout, incluindo novo suporte para texto alt e gerenciamento de células vazias. PivotLayout

Lista de API

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

Classe Campos Descrição
FormulaChangedEventDetail cellAddress O endereço da célula que contém a fórmula alterada.
previousFormula Representa a fórmula anterior, antes de ser alterada.
InsertWorksheetOptions Positiontype A posição de inserção, na pasta de trabalho atual, das novas planilhas.
Relativeto A planilha na pasta de trabalho atual que é referenciada para o WorksheetPositionType parâmetro.
sheetNamesToInsert Os nomes das planilhas individuais a serem inseridas.
PivotLayout altTextDescription A descrição do texto alt da Tabela Dinâmica.
altTextTitle O título de texto alt da Tabela Dinâmica.
displayBlankLineAfterEachItem(display: booleano) Define se deve ou não exibir uma linha em branco após cada item.
emptyCellText O texto que é preenchido automaticamente em qualquer célula vazia na Tabela Dinâmica se fillEmptyCells == true.
fillEmptyCells Especifica se as células vazias na Tabela Dinâmica devem ser preenchidas com o emptyCellText.
repeatAllItemLabels(repeatLabels: boolean) Define a configuração "repetir todos os rótulos de item" em todos os campos da Tabela Dinâmica.
showFieldHeaders Especifica se a Tabela Dinâmica exibe cabeçalhos de campo (legendas de campo e drop-downs de filtro).
PivotTable refreshOnOpen Especifica se a Tabela Dinâmica é atualizada quando a pasta de trabalho é aberta.
Range getDirectDependents() Retorna um WorkbookRangeAreas objeto que representa o intervalo que contém todas as células dependentes diretas de um intervalo especificado na mesma planilha ou em várias planilhas.
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string) Retorna um objeto de intervalo que inclui o intervalo atual e até a borda do intervalo, com base na direção fornecida.
getMergedAreasOrNullObject() Retorna um RangeAreas objeto que representa as áreas mescladas nesse intervalo.
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string) Retorna um objeto range que é a célula de borda da região de dados que corresponde à direção fornecida.
Table redimensionamento(newRange: cadeia de caracteres | de intervalo) Redimensione a tabela para o novo intervalo.
Pasta de trabalho insertWorksheetsFromBase64(base64File: cadeia de caracteres, opções?: Excel.InsertWorksheetOptions) Insere as planilhas especificadas de uma pasta de trabalho de origem na pasta de trabalho atual.
onActivated Ocorre quando a pasta de trabalho é ativada.
WorkbookActivatedEventArgs tipo Obtém o tipo do evento.
Planilha onFormulaChanged Ocorre quando uma ou mais fórmulas são alteradas nesta planilha.
WorksheetCollection onFormulaChanged Ocorre quando uma ou mais fórmulas são alteradas em qualquer planilha desta coleção.
WorksheetFormulaChangedEventArgs formulaDetails Obtém uma matriz de FormulaChangedEventDetail objetos, que contêm os detalhes sobre todas as fórmulas alteradas.
source A origem do evento.
tipo Obtém o tipo do evento.
worksheetId Obtém a ID da planilha na qual a fórmula foi alterada.

Confira também