Quais são as novidades na API JavaScript do Excel 1.4
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)
erange.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. |