Quais são as novidades na API JavaScript do Excel 1.4

  • Artigo

A seguir estão as novas adições às APIs JavaScript do Excel no conjunto de requisitos 1.4.

Adicionar item nomeado e novas propriedades

Novas propriedades:

  • comment
  • scope – Itens com escopo de planilha ou pasta de trabalho.
  • worksheet - Retorna a planilha na qual o item nomeado está no escopo.

Novos métodos:

  • add(name: string, reference: Range or string, comment: string) - Adiciona um novo nome à coleção do escopo determinado.
  • addFormulaLocal(name: string, formula: string, comment: string) - Adiciona um novo nome à coleção do escopo determinado usando a localidade do usuário para a fórmula.

Configurações de API no namespace do Excel

O objeto Configuração representa um par chave-valor de uma configuração persistente ao documento. O recurso Excel.Setting é equivalente a Office.Settings, mas usa a sintaxe da API em lote, em vez de modelo de retorno de chamada de API comuns.

As APIs incluem getItem() obter a entrada de configuração por meio da chave e add() adicionar o par de configuração de chave:valor especificado à pasta de trabalho.

Outros

  • Defina o nome da coluna da tabela.
  • Adicione uma coluna de tabela ao final da tabela.
  • Adicione várias linhas a uma tabela por vez.
  • range.getColumnsAfter(count: number) e range.getColumnsBefore(count: number) para obter determinado número de colunas à direita/esquerda do objeto Range atual.
  • As propriedades e métodos *OrNullObject: essa funcionalidade permite obter um objeto usando uma chave. Se o objeto não existir, a propriedade do isNullObject objeto retornado será verdadeira. Isso permite que os desenvolvedores marcar se um objeto existir sem precisar lidar com ele por meio do tratamento de exceção. Um *OrNullObject método está disponível na maioria dos objetos de coleção.
worksheet.getItemOrNullObject("itemName")

Lista de API

A tabela a seguir lista as APIs no conjunto de requisitos de API JavaScript do Excel 1.4. 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.4 ou anterior, consulte APIs do Excel no conjunto de requisitos 1.4 ou anterior.

Classe Campos Descrição
BindingCollection getCount() Obtém o número de associações da coleção.
getItemOrNullObject(id: string) Obtém um objeto de associação pela ID.
ChartCollection getCount() Retorna o número de gráficos da planilha.
getItemOrNullObject(name: string) Obtém um gráfico usando o respectivo nome.
ChartPointsCollection getCount() Retorna o número de pontos do gráfico da série.
ChartSeriesCollection getCount() Retorna o número de série da coleção.
NamedItem Comentário Especifica o comentário associado a esse nome.
delete() Exclui o nome fornecido.
getRangeOrNullObject() Retorna o objeto Range associado ao nome.
scope Especifica se o nome está no escopo da pasta de trabalho ou de uma planilha específica.
worksheet Retorna a planilha em que o item nomeado tem escopo.
worksheetOrNullObject Retorna a planilha à qual o item nomeado está no escopo.
NamedItemCollection add(name: string, reference: Range | string, comment?: string) Adiciona um novo nome à coleção do escopo fornecido.
addFormulaLocal(name: string, formula: string, comment?: string) Adiciona um novo nome à coleção de escopo fornecido usando a localidade do usuário para a fórmula.
getCount() Obtém o número de itens nomeados na coleção.
getItemOrNullObject(name: string) Obtém um NamedItem objeto usando seu nome.
PivotTableCollection getCount() Obtém o número de tabelas dinâmicas na coleção.
getItemOrNullObject(name: string) Obtém uma Tabela Dinâmica por nome.
Range getIntersectionOrNullObject(anotherRange: Range | string) Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados.
getUsedRangeOrNullObject(valuesOnly?: boolean) Retorna o intervalo usado do objeto de intervalo determinado.
RangeViewCollection getCount() Obtém o número de RangeView objetos na coleção.
Configuração delete() Exclui a configuração.
key A chave que representa a ID da configuração.
value Representa o valor armazenado para esta configuração.
SettingCollection add(key: string, value: string | number | boolean | Data | any[] | any) Define na pasta de trabalho ou adiciona a ela a configuração especificada.
getCount() Obtém o número de configurações na coleção.
getItem(key: string) Obtém uma entrada de configuração por meio da chave.
getItemOrNullObject(key: string) Obtém uma entrada de configuração por meio da chave.
items Obtém os itens filhos carregados nesta coleção.
onSettingsChanged Ocorre quando as configurações no documento são alteradas.
SettingsChangedEventArgs configurações Obtém o Setting objeto que representa a associação que levantou o evento alterado de configurações
TableCollection getCount() Obtém o número de tabelas na coleção.
getItemOrNullObject(key: string) Obtém uma tabela pelo nome ou ID.
TableColumnCollection getCount() Obtém a quantidade de colunas na tabela.
getItemOrNullObject(key: number | string) Obtém um objeto de coluna por nome ou ID.
TableRowCollection getCount() Obtém a quantidade de linhas na tabela.
Pasta de trabalho configurações Representa uma coleção de configurações associadas à pasta de trabalho.
Planilha getUsedRangeOrNullObject(valuesOnly?: boolean) O intervalo usado é o menor intervalo que abrange todas as células que têm um valor ou uma formatação atribuída a elas.
Nomes Coleção de nomes com escopo para a planilha atual.
WorksheetCollection getCount(visibleOnly?: booleano) Obtém o número de planilhas na coleção.
getItemOrNullObject(key: string) Obtém um objeto de planilha usando o nome ou ID dele.

Confira também