Compartilhar via


Novidades na API JavaScript 1.19 do Excel

O ExcelApi 1.19 adiciona capacidades para gráficos e formas, para o ajudar a visualizar melhor os seus dados no Excel. Também inclui atualizações para a funcionalidade de tipos de dados, como suporte para tipos de dados ligados, notação de pontos e opções expandidas para valores de células básicos.

A tabela seguinte fornece um resumo conciso das APIs, enquanto a tabela da lista de API subsequente apresenta uma lista detalhada.

Área de recurso Descrição Objetos relevantes
Etiquetas de gráfico Controlar o aspeto das etiquetas de gráfico. ChartDataLabel, ChartDataLabelAnchor, ChartLeaderLines, ChartLeaderLinesFormat
Tipos de dados ligados Adiciona suporte para tipos de dados ligados ao Excel a partir de origens externas. Para saber mais, veja Criar valores de células de entidade ligada LinkedDataType, LinkedDataTypeAddedEventArgs, LinkedDataTypeCollection

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.19. Para ver API reference documentation for all APIs supported by Excel JavaScript API requirement set 1.19 or earlier, see Excel APIs in requirement set 1.19 or earlier.

Classe Campos Descrição
BasicCardLayout esquema Representa o tipo deste esquema.
BasicCompactLayout icon Especifica o nome do ícone que é utilizado para abrir o card.
BasicViewLayouts card Representa o esquema deste valor e as respetivas propriedades na vista card.
compacto Representa o esquema utilizado quando existe espaço limitado para representar o valor.
BooleanCellValue esquemas Representa informações de esquema para vistas deste valor Booleano.
properties Representa propriedades adicionais deste valor Booleano.
fornecedor Representa informações que descrevem o serviço que forneceu os dados neste BooleanCellValue.
referencedValues Representa os valores das células que são referenciados em BooleanCellValue.properties.
CardLayoutTwoColumnSection esquema Representa o tipo de esquema para esta secção.
ChartDataLabel geometricShapeType Especifica o tipo de forma geométrica da etiqueta de dados.
getSubstring(start: number, length?: number) Devolve uma subcadeia da etiqueta de dados.
getTailAnchor() Devolve a âncora traseira da etiqueta de dados que é apresentada como uma nota de aviso autocolante.
setHeight(altura: número) Define a altura da etiqueta de dados em pontos.
setWidth(largura: número) Define a largura da etiqueta de dados em pontos.
showAsStickyCallout Obtém um valor que indica se a etiqueta de dados é apresentada como uma nota de aviso com a âncora de cauda anexada ao ponto de dados.
ChartDataLabelAnchor left Representa a distância, em pontos, da âncora à margem esquerda da etiqueta de dados do gráfico.
top Representa a distância, em pontos, da âncora até à margem superior da etiqueta de dados do gráfico.
ChartDataLabels geometricShapeType Especifica o tipo de forma geométrica das etiquetas de dados.
linhas de preenchimento Obtém um objeto que representa as linhas de preenchimento das etiquetas de dados.
showAsStickyCallout Obtém um valor que indica se as etiquetas de dados são apresentadas como nota de aviso com a âncora de cauda anexada ao ponto de dados.
showLeaderLines Especifica um valor que indica se as linhas de preenchimento são apresentadas para as etiquetas de dados.
ChartLeaderLines format Representa a formatação de linhas de preenchimento de etiquetas de dados numa série.
ChartLeaderLinesFormat line Obtém um objeto que representa a formatação de linhas das linhas de preenchimento do gráfico.
DoubleCellValue esquemas Representa informações de esquema para vistas deste valor duplo.
numberFormat Devolve a cadeia de formato de número que é utilizada para apresentar este valor.
properties Representa propriedades adicionais deste valor duplo.
fornecedor Representa informações que descrevem o serviço que forneceu os dados neste DoubleCellValue.
referencedValues Representa os valores das células que são referenciados em DoubleCellValue.properties.
EntityCompactLayout icon Especifica o nome do ícone que é utilizado para abrir o card.
FormattedNumberCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
numberFormat Devolve a cadeia de formato de número que é utilizada para apresentar este valor.
type Representa o tipo deste valor de célula.
JavaScriptCustomFunctionReferenceCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
functionType Representa o tipo de FunctionCellValue.
id Representa o ID da função personalizada.
espaço de nomes Representa o espaço de nomes utilizado pela função personalizada.
type Representa o tipo deste valor de célula.
LinkedEntityDataDomain dataProvider Obtém o nome do fornecedor de dados para o domínio de dados da entidade ligada.
delete() Elimina este objeto do LinkedEntityDataDomainCollection.
id Obtém o ID do domínio de dados da entidade ligada definido pelos Suplementos do Office.
lastRefreshed Obtém a data e hora (no fuso horário local) desde que o livro foi aberto e os LinkedEntityCellValue objetos deste domínio de dados de entidade ligada foram atualizados pela última vez.
loadFunctionId Obtém o ID da função personalizada que é chamada a pedido para resolve ou atualizar os LinkedEntityCellValue objetos do domínio de dados da entidade ligada definido pelos Suplementos do Office.
name Obtém o nome do domínio de dados da entidade ligada.
periodicRefreshInterval Obtém a frequência, em segundos, na qual LinkedEntityCellValue os objetos deste domínio de dados de entidade ligada são atualizados automaticamente.
refresh() Atualiza todos os LinkedEntityCellValue objetos deste domínio de dados de entidade ligada.
refreshMode Especifica o modo de atualização que define como e quando os LinkedEntityCellValue objetos deste domínio de dados de entidade ligada são atualizados.
serviceId Obtém o ID de serviço do domínio de dados da entidade ligada.
supportedRefreshModes Obtém todos os modos de atualização suportados pelo domínio de dados da entidade ligada.
LinkedEntityDataDomainAddedEventArgs id Obtém o ID do domínio de dados da entidade ligada que acabou de ser adicionado ao livro.
serviceId Obtém o ID de serviço do domínio de dados da entidade ligada que acabou de ser adicionado ao livro.
source Obtém a origem do evento.
tipo Obtém o tipo do evento.
LinkedEntityDataDomainCollection add(options: Excel.LinkedEntityDataDomainCreateOptions) Adiciona um objeto de domínio de dados de entidade ligada definido pelo Suplemento do Office à coleção.
getCount() Obtém o número de domínios de dados de entidade ligados na coleção.
getItem(id: string) Obtém um domínio de dados de entidade ligada pelo respetivo id.
getItemAt(index: number) Obtém um domínio de dados de entidade ligada pelo respetivo índice na coleção.
getItemByName(nome: cadeia) Obtém um domínio de dados de entidade ligada pelo respetivo name.
getItemByNameOrNullObject(nome: cadeia) Obtém um domínio de dados de entidade ligada pelo respetivo name.
getItemOrNullObject(id: string) Obtém um domínio de dados de entidade ligada pelo respetivo id.
items Obtém os itens filhos carregados nesta coleção.
onLinkedEntityDataDomainAdded Ocorre quando um novo domínio de dados de entidade ligada é adicionado ao livro.
onRefreshCompleted Ocorre quando o pedido de atualização LinkedEntityCellValue de objetos de um domínio de dados de entidade ligada é concluído.
onRefreshModeChanged Ocorre quando o refreshMode de um domínio de dados de entidade ligada é alterado.
refreshAll() Atualiza todos os LinkedEntityCellValue objetos de todos os domínios de dados de entidades ligadas nesta coleção.
LinkedEntityDataDomainCreateOptions dataProvider Especifica o nome do fornecedor de dados para o domínio de dados da entidade ligada.
id Especifica o ID do domínio de dados da entidade ligada.
loadFunctionId Especifica o ID da função personalizada que será chamada a pedido para resolve ou atualizar os LinkedEntityCellValue objetos deste domínio de dados de entidade ligada.
name Especifica o nome do domínio de dados da entidade ligada.
periodicRefreshInterval Especifica a frequência, em segundos, na qual LinkedEntityCellValue os objetos deste domínio de dados de entidade ligada são atualizados automaticamente.
supportedRefreshModes Especifica todos os modos de atualização suportados pelo domínio de dados da entidade ligada.
LinkedEntityDataDomainRefreshCompletedEventArgs errors Obtém todos os erros encontrados durante o pedido de atualização LinkedEntityCellValue de objetos do domínio de dados da entidade ligada.
id Obtém o ID do domínio de dados da entidade ligada cujos LinkedEntityCellValue objetos foram atualizados.
atualizado Devolve true se os LinkedEntityCellValue objetos do domínio de dados da entidade ligada foram atualizados com êxito. Caso contrário, devolve false.
serviceId Obtém o ID de serviço do domínio de dados da entidade ligada cujos LinkedEntityCellValue objetos foram atualizados.
source Obtém a origem do evento.
tipo Obtém o tipo do evento.
LinkedEntityDataDomainRefreshModeChangedEventArgs id Obtém o ID do domínio de dados da entidade ligada cujo modo de atualização foi alterado.
refreshMode Obtém o novo modo de atualização do domínio de dados da entidade ligada.
serviceId Obtém o ID de serviço do domínio de dados da entidade ligada cujo modo de atualização foi alterado.
source Obtém a origem do evento.
tipo Obtém o tipo do evento.
LinkedEntityIdCulture cultura Representa a cultura de linguagem utilizada para criar o LinkedEntityCellValue objeto.
entityId Representa o identificador específico de um serviço utilizado para criar o LinkedEntityCellValue objeto.
LinkedEntityLoadServiceRequest domainId Representa o domínio específico do serviço utilizado para criar os LinkedEntityCellValue objetos.
entidades Representa os IDs de entidade e as culturas dos LinkedEntityCellValue objetos a carregar.
LinkedEntityLoadServiceResult entidades Representa os objetos carregados LinkedEntityCellValue .
Range getDisplayedCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions) Devolve uma matriz 2D, encapsulando os dados de apresentação para o tipo de letra, preenchimento, limites, alinhamento e outras propriedades de cada célula.
StringCellValue esquemas Representa informações de esquema para vistas deste valor de cadeia.
properties Representa propriedades adicionais deste valor de cadeia.
fornecedor Representa informações que descrevem o serviço que forneceu os dados neste StringCellValue.
referencedValues Representa os valores das células que são referenciados em StringCellValue.properties.
Pasta de trabalho getActiveShape() Obtém a forma ativa no livro.
getActiveShapeOrNullObject() Obtém a forma ativa no livro.
linkedEntityDataDomains Devolve uma coleção de domínios de dados de entidades ligadas que estão disponíveis no livro.
Planilha showDataTypeIcons Especifica se os ícones do tipo de dados estão visíveis na folha de cálculo.

Confira também