Partilhar via


Conjunto de requisitos da API javaScript do Excel 1.1

A API JavaScript do Excel 1.1 é a primeira versão da API. É o único conjunto de requisitos específico do Excel suportado pelo Excel 2016.

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.1. Para ver a documentação de referência da API para todas as APIs suportadas pelo conjunto de requisitos da API JavaScript do Excel 1.1, veja APIs do Excel no conjunto de requisitos 1.1.

Classe Campos Descrição
Aplicativo calculate(calculationType: Excel.CalculationType) Recalcula todas as pastas de trabalho abertas no Excel no momento.
calculationMode Devolve o modo de cálculo utilizado no livro, conforme definido pelas constantes em Excel.CalculationMode.
Associação getRange() Retorna o intervalo representado pela associação.
getTable() Retorna a tabela representada pela associação.
getText() Retorna o texto representado pela associação.
id Representa o identificador de enlace.
type Retorna o tipo da associação.
BindingCollection Count Retorna o número de associações da coleção.
getItem(id: string) Obtém um objeto de associação pela ID.
getItemAt(index: number) Obtém um objeto de associação com base em sua posição na matriz dos itens.
items Obtém os itens filhos carregados nesta coleção.
Gráfico eixos Representa os eixos de um gráfico.
dataLabels Representa os rótulos de dados no gráfico.
delete() Exclui o objeto de gráfico.
format Encapsula as propriedades de formato da área do gráfico.
height Especifica a altura, em pontos, do objeto de gráfico.
left A distância, em pontos, da esquerda do gráfico à origem da planilha.
legenda Representa a legenda do gráfico.
name Especifica o nome de um objeto de gráfico.
series Representa uma única série ou uma coleção de séries no gráfico.
setData(sourceData: Range, seriesBy?: Excel.ChartSeriesBy) Redefine os dados de origem do gráfico.
setPosition(startCell: Intervalo | cadeia, endCell?: Intervalo | cadeia) Posiciona o gráfico em relação às células na planilha.
title Representa o título do gráfico especificado, incluindo o respectivo texto, a visibilidade, a posição e a formatação.
top Especifica a distância, em pontos, desde a margem superior do objeto até à parte superior da linha 1 (numa folha de cálculo) ou à parte superior da área do gráfico (num gráfico).
width Especifica a largura, em pontos, do objeto de gráfico.
ChartAreaFormat fill Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.
font Representa os atributos de fonte do objeto atual, como nome, tamanho, cor, dentre outros.
ChartAxes categoryAxis Representa o eixo de categoria em um gráfico.
seriesAxis Representa o eixo da série de um gráfico 3D.
valueAxis Representa o eixo dos valores em um eixo.
ChartAxis format Representa a formatação de um objeto Chart, que inclui formatação de linha e de fonte.
majorGridlines Devolve um objeto que representa as principais linhas de grelha do eixo especificado.
majorUnit Representa o intervalo entre as duas principais marcas de escala.
maximum Representa o valor máximo no eixo dos valores.
minimum Representa o valor mínimo no eixo dos valores.
minorGridlines Devolve um objeto que representa as linhas de grelha secundárias do eixo especificado.
minorUnit Representa o intervalo entre as duas marcas de escala secundárias.
title Representa o título do eixo.
ChartAxisFormat font Especifica os atributos do tipo de letra (nome do tipo de letra, tamanho do tipo de letra, cor, etc.) para um elemento do eixo do gráfico.
line Especifica a formatação de linhas do gráfico.
ChartAxisTitle format Especifica a formatação do título do eixo do gráfico.
text Especifica o título do eixo.
visible Especifica se o título do eixo está visível.
ChartAxisTitleFormat font Especifica os atributos de tipo de letra do título do eixo do gráfico, como o nome do tipo de letra, o tamanho do tipo de letra ou a cor, do objeto de título do eixo do gráfico.
ChartCollection add(type: Excel.ChartType, sourceData: Range, seriesBy?: Excel.ChartSeriesBy) Cria um novo gráfico.
Count Retorna o número de gráficos da planilha.
getItem(name: string) Obtém um gráfico usando o respectivo nome.
getItemAt(index: number) Obtém um gráfico com base em sua posição no conjunto.
items Obtém os itens filhos carregados nesta coleção.
ChartDataLabelFormat fill Representa o formato de preenchimento do rótulo de dados atual do gráfico.
font Representa os atributos do tipo de letra (como o nome do tipo de letra, o tamanho do tipo de letra e a cor) de uma etiqueta de dados do gráfico.
ChartDataLabels format Especifica o formato das etiquetas de dados do gráfico, que inclui a formatação de tipo de letra e preenchimento.
position Valor que representa a posição da etiqueta de dados.
separador Cadeia de caracteres que representa o separador usado para os rótulos de dados em um gráfico.
showBubbleSize Especifica se o tamanho da bolha da etiqueta de dados está visível.
showCategoryName Especifica se o nome da categoria da etiqueta de dados está visível.
showLegendKey Especifica se a chave de legenda da etiqueta de dados está visível.
showPercentage Especifica se a percentagem da etiqueta de dados está visível.
showSeriesName Especifica se o nome da série de etiquetas de dados está visível.
showValue Especifica se o valor da etiqueta de dados está visível.
ChartFill clear() Limpa a cor de preenchimento de um elemento de gráfico.
setSolidColor(color: string) Define a formatação de preenchimento de um elemento do gráfico com uma cor uniforme.
ChartFont bold Representa o status da fonte em negrito.
color Representação do código de cores HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
italic Representa o status da fonte em itálico.
name Nome do tipo de letra (por exemplo, "Calibri")
size Tamanho do tipo de letra (por exemplo, 11)
underline Tipo de sublinhado aplicado à fonte.
ChartGridlines format Representa a formatação de linhas de grade do gráfico.
visible Especifica se as linhas de grelha do eixo estão visíveis.
ChartGridlinesFormat line Representa a formatação de linha do gráfico.
ChartLegend format Representa a formatação de uma legenda de gráfico, que inclui a formatação de fonte e de preenchimento.
overlay Especifica se a legenda do gráfico deve sobrepor-se ao corpo main do gráfico.
position Especifica a posição da legenda no gráfico.
visible Especifica se a legenda do gráfico está visível.
ChartLegendFormat fill Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.
font Representa os atributos do tipo de letra, como o nome do tipo de letra, o tamanho do tipo de letra e a cor de uma legenda de gráfico.
ChartLineFormat clear() Limpa o formato de linha de um elemento de gráfico.
color Código de cores HTML que representa a cor das linhas no gráfico.
ChartPoint format Encapsula as propriedades de formato de um ponto do gráfico.
value Retorna o valor de um ponto do gráfico.
ChartPointFormat fill Representa o formato de preenchimento de um gráfico, que inclui informações de formatação de fundo.
ChartPointsCollection Count Retorna o número de pontos do gráfico da série.
getItemAt(index: number) Recupera um ponto com base na respectiva posição dentro da série.
items Obtém os itens filhos carregados nesta coleção.
ChartSeries format Representa a formatação de uma série do gráfico, que inclui a formatação de linha e de preenchimento.
name Especifica o nome de uma série num gráfico.
pontos Devolve uma coleção de todos os pontos da série.
ChartSeriesCollection Count Retorna o número de série da coleção.
getItemAt(index: number) Recupera uma série com base na respectiva posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
ChartSeriesFormat fill Representa o formato de preenchimento de uma série do gráfico, que inclui informações sobre a formatação da tela de fundo.
line Representa a formatação de linha.
ChartTitle format Representa a formatação de um título do gráfico, que inclui a formatação de fonte e de preenchimento.
overlay Especifica se o título do gráfico irá sobrepor o gráfico.
text Especifica o texto do título do gráfico.
visible Especifica se o título do gráfico está visível.
ChartTitleFormat fill Representa o formato de preenchimento de um objeto, que inclui informações sobre a formatação da tela de fundo.
font Representa os atributos do tipo de letra (como o nome do tipo de letra, o tamanho do tipo de letra e a cor) de um objeto.
NamedItem getRange() Retorna o objeto Range associado ao nome.
name O nome do objeto.
type Especifica o tipo do valor devolvido pela fórmula do nome.
value Representa o valor calculado pela fórmula do nome.
visible Especifica se o objeto está visível.
NamedItemCollection getItem(name: string) Obtém um NamedItem objeto com o respetivo nome.
items Obtém os itens filhos carregados nesta coleção.
Range address Especifica a referência de intervalo no estilo A1.
addressLocal Representa a referência de intervalo para o intervalo especificado no idioma do utilizador.
cellCount Especifica o número de células no intervalo.
clear(applyTo?: Excel.ClearApplyTo) Limpar valores de intervalo e formatação, como preenchimento e limite.
columnCount Especifica o número total de colunas no intervalo.
columnIndex Especifica o número da coluna da primeira célula no intervalo.
delete(shift: Excel.DeleteShiftDirection) Exclui as células associadas ao intervalo.
format Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.
fórmulas Representa a fórmula em notação A1.
formulasLocal Representa a fórmula em notação A1, na formatação de número da localidade e no idioma do usuário.
getBoundingRect(anotherRange: Intervalo | cadeia) Obtém o menor objeto de intervalo que abrange os intervalos determinados.
getCell(row: number, column: number) Obtém o objeto de intervalo que contém a célula única com base nos números de linha e de coluna.
getColumn(column: number) Obtém uma coluna incluída no intervalo.
getEntireColumn() Obtém um objeto que representa toda a coluna do intervalo (por exemplo, se o intervalo atual representar as células "B4:E11", getEntireColumn é um intervalo que representa as colunas "B:E").
getEntireRow() Obtém um objeto que representa toda a linha do intervalo (por exemplo, se o intervalo atual representar as células "B4:E11", GetEntireRow é um intervalo que representa as linhas "4:11").
getIntersection(anotherRange: Intervalo | cadeia) Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados.
getLastCell() Obtém a última célula do intervalo.
getLastColumn() Obtém a última coluna do intervalo.
getLastRow() Obtém a última linha do intervalo.
getOffsetRange(rowOffset: number, columnOffset: number) Obtém um objeto que representa um intervalo deslocado do intervalo especificado.
getRow(row: number) Obtém uma linha contida no intervalo.
insert(shift: Excel.InsertShiftDirection) Insere uma célula ou um intervalo de células na planilha, no lugar desse intervalo, e desloca as outras células para liberar espaço.
numberFormat Representa o código de formato de número do Excel para o intervalo especificado.
rowCount Retorna o número total de linhas no intervalo.
rowIndex Representa o número de linhas da primeira célula no intervalo.
Seleciona. Seleciona o intervalo especificado na interface do usuário do Excel.
text Valores de texto do intervalo especificado.
valueTypes Especifica o tipo de dados em cada célula.
values Representa os valores brutos do intervalo especificado.
worksheet A planilha que contém o intervalo atual.
RangeBorder color Código de cores HTML que representa a cor da linha de limite, na forma #RRGGBB (por exemplo, "FFA500") ou como uma cor HTML nomeada (por exemplo, "laranja").
sideIndex Valor constante que indica o lado específico da borda.
style Uma das constantes de estilo de linha especificando o estilo de linha da borda.
peso Especifica o peso da borda em torno de um intervalo.
RangeBorderCollection Count Número de objetos de borda da coleção.
getItem(índice: Excel.BorderIndex) Obtém um objeto Border usando o respectivo nome.
getItemAt(index: number) Obtém um objeto Border usando o respectivo índice.
items Obtém os itens filhos carregados nesta coleção.
RangeFill clear() Redefine a tela de fundo do intervalo.
color Código de cores HTML que representa a cor do fundo, no formulário #RRGGBB (por exemplo, "FFA500" ou como uma cor HTML nomeada (por exemplo, "laranja")
RangeFont bold Representa a status a negrito do tipo de letra.
color Representação do código de cores HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
italic Especifica o status itálico do tipo de letra.
name Nome do tipo de letra (por exemplo, "Calibri").
size Font Size
underline Tipo de sublinhado aplicado à fonte.
RangeFormat Borders Coleção de objetos border que se aplicam a todo o intervalo.
fill Retorna o objeto de preenchimento definido em todo o intervalo.
font Retorna o objeto font definido em todo o intervalo.
horizontalAlignment Representa o alinhamento horizontal do objeto especificado.
verticalAlignment Representa o alinhamento vertical do objeto especificado.
wrapText Especifica se o Excel molda o texto no objeto.
Table colunas Representa uma coleção de todas as colunas na tabela.
delete() Exclui a tabela.
getDataBodyRange() Obtém o objeto de intervalo associado ao corpo de dados da tabela.
getHeaderRowRange() Obtém o objeto de intervalo associado à linha de cabeçalho da tabela.
getRange() Obtém o objeto de intervalo associado a toda a tabela.
getTotalRowRange() Obtém o objeto de intervalo associado à linha de totais da tabela.
id Retorna um valor que identifica de forma exclusiva a tabela em uma determinada pasta de trabalho.
name Nome da tabela.
rows Representa uma coleção de todas as linhas na tabela.
showHeaders Especifica se a linha de cabeçalho está visível.
showTotals Especifica se a linha total está visível.
style Valor constante que representa o estilo de tabela.
TableCollection add(address: Range | string, hasHeaders: booleano) Cria uma nova tabela.
Count Retorna o número de tabelas na pasta de trabalho.
getItem(key: string) Obtém uma tabela pelo nome ou ID.
getItemAt(index: number) Obtém uma tabela com base em sua posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
TableColumn delete() Exclui a coluna da tabela.
getDataBodyRange() Obtém o objeto de intervalo associado ao corpo de dados da coluna.
getHeaderRowRange() Obtém o objeto de intervalo associado à linha de cabeçalho da coluna.
getRange() Obtém o objeto de intervalo associado a toda a coluna.
getTotalRowRange() Obtém o objeto de intervalo associado à linha de totais da coluna.
id Retorna uma chave exclusiva que identifica a coluna na tabela.
índice Retorna o número de índice da coluna na coleção de colunas da tabela.
name Especifica o nome da coluna da tabela.
values Representa os valores brutos do intervalo especificado.
TableColumnCollection add(index?: number, values?: Array<Array<boolean | string | number>> | boolean | string | number, name?: string) Adiciona uma nova coluna à tabela.
Count Retorna o número de colunas na tabela.
getItem(chave: número | cadeia) Obtém um objeto de coluna por nome ou ID.
getItemAt(index: number) Obtém uma coluna com base em sua posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
TableRow delete() Exclui a linha da tabela.
getRange() Retorna o objeto de intervalo associado a toda a linha.
índice Retorna o número de índice da linha na coleção de linhas da tabela.
values Representa os valores brutos do intervalo especificado.
TableRowCollection add(índice?: número, valores?:<<Matriz booleana | cadeia | número>> | booleano | cadeia | número, alwaysInsert?: booleano) Adiciona uma ou mais linhas à tabela.
Count Retorna o número de linhas na tabela.
getItemAt(index: number) Obtém uma linha com base em sua posição na coleção.
items Obtém os itens filhos carregados nesta coleção.
Pasta de trabalho application Representa a instância da aplicação Excel que contém este livro.
bindings Representa uma coleção de ligações que fazem parte da pasta de trabalho.
getSelectedRange() Obtém o intervalo único selecionado atualmente a partir do livro.
nomes Representa uma coleção de itens nomeados com âmbito de livro (intervalos com nome e constantes).
tabelas Representa uma coleção de tabelas associadas à pasta de trabalho.
folhas de cálculo Representa uma coleção de planilhas associadas à pasta de trabalho.
Planilha activate() Ative a planilha na interface do usuário do Excel.
gráficos Devolve uma coleção de gráficos que fazem parte da folha de cálculo.
delete() Exclui a planilha da pasta de trabalho.
getCell(row: number, column: number) Obtém o Range objeto que contém a única célula com base nos números de linha e coluna.
getRange(endereço?: cadeia) Obtém o Range objeto, representando um único bloco retangular de células, especificado pelo endereço ou nome.
id Retorna um valor que identifica de forma exclusiva a planilha em uma determinada pasta de trabalho.
name O nome de exibição da planilha.
position A posição baseada em zero da planilha na pasta de trabalho.
tabelas Coleção de tabelas que fazem parte da planilha.
visibilidade A visibilidade da planilha.
WorksheetCollection add(name?: string) Adiciona uma nova planilha à pasta de trabalho.
getActiveWorksheet() Obtém a planilha ativa no momento na pasta de trabalho.
getItem(key: string) Obtém um objeto de planilha usando o nome ou ID dele.
items Obtém os itens filhos carregados nesta coleção.

Confira também