Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |