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 com suporte por Excel 2016.
Lista de API
A tabela a seguir lista as APIs no conjunto de requisitos de API JavaScript do Excel 1.1. 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.1, consulte 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 | Retorna o modo de cálculo usado na pasta de trabalho, 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 associação. | |
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 | axes | 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 gráfico. | |
left | A distância, em pontos, da esquerda do gráfico à origem da planilha. | |
Lenda | Representa a legenda do gráfico. | |
name | Especifica o nome de um objeto 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: Range | string, endCell?: Range | string) | 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, da borda superior do objeto até a parte superior da linha 1 (em uma planilha) ou a parte superior da área do gráfico (em um gráfico). | |
width | Especifica a largura, em pontos, do objeto 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 | Retorna um objeto que representa as principais linhas de grade para o 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 | Retorna um objeto que representa as linhas de grade secundárias para o 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 de fonte (nome da fonte, tamanho da fonte, cor etc.) para um elemento do eixo do gráfico. |
line | Especifica a formatação de linha de 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 fonte do título do eixo do gráfico, como nome da fonte, tamanho da fonte ou cor do objeto 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 de fonte (como nome da fonte, tamanho da fonte e cor) para um rótulo de dados do gráfico. | |
ChartDataLabels | format | Especifica o formato de rótulos de dados do gráfico, que inclui preenchimento e formatação de fonte. |
position | Valor que representa a posição do rótulo 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 do rótulo de dados está visível. | |
showCategoryName | Especifica se o nome da categoria do rótulo de dados está visível. | |
showLegendKey | Especifica se a chave de legenda do rótulo de dados está visível. | |
showPercentage | Especifica se o percentual do rótulo de dados está visível. | |
showSeriesName | Especifica se o nome da série de rótulos de dados está visível. | |
showValue | Especifica se o valor do rótulo 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 de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho). | |
italic | Representa o status da fonte em itálico. | |
name | Nome da fonte (por exemplo, "Calibri") | |
size | Tamanho da fonte (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 grade 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 se sobrepor 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 de fonte, como nome da fonte, tamanho da fonte e 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 em segundo plano. |
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 em um gráfico. | |
Pontos | Retorna 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 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 de fonte (como nome da fonte, tamanho da fonte e cor) para um objeto. | |
NamedItem | getRange() | Retorna o objeto Range associado ao nome. |
name | O nome do objeto. | |
type | Especifica o tipo do valor retornado 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 usando seu 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 usuário. | |
cellCount | Especifica o número de células no intervalo. | |
clear(applyTo?: Excel.ClearApplyTo) | Limpe valores de intervalo, formatação, preenchimento, bordas, etc. | |
columnCount | Especifica o número total de colunas no intervalo. | |
columnIndex | Especifica o número de 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: Range | string) | 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 representa as células "B4:E11", ele 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 representa as células "B4:E11", ele GetEntireRow é um intervalo que representa as linhas "4:11"). |
|
getIntersection(anotherRange: Range | string) | 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 determinado. | |
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 cor HTML que representa a cor da linha de borda, no formulário #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(index: 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 cor HTML que representa a cor do plano de fundo, no formulário #RRGGBB (por exemplo, "FFA500" ou como uma cor HTML nomeada (por exemplo, "laranja") | |
RangeFont | bold | Representa o status em negrito da fonte. |
color | Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho). | |
italic | Especifica o status itálico da fonte. | |
name | Nome da fonte (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 encapsula 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: boolean) | 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 de 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(key: number | string) | 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(index?: number, values?: Array<Array<boolean | string | number>> | boolean | string | number, alwaysInsert?: boolean) | 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 de aplicativo do Excel que contém essa pasta de trabalho. |
bindings | Representa uma coleção de ligações que fazem parte da pasta de trabalho. | |
getSelectedRange() | Obtém o intervalo único selecionado atualmente na pasta de trabalho. | |
Nomes | Representa uma coleção de itens nomeados com escopo de pasta de trabalho (intervalos e constantes nomeados). | |
Tabelas | Representa uma coleção de tabelas associadas à pasta de trabalho. | |
Planilhas | Representa uma coleção de planilhas associadas à pasta de trabalho. | |
Planilha | activate() | Ative a planilha na interface do usuário do Excel. |
Gráficos | Retorna uma coleção de gráficos que fazem parte da planilha. | |
delete() | Exclui a planilha da pasta de trabalho. | |
getCell(row: number, column: number) | Obtém o Range objeto que contém a célula única com base em números de linha e coluna. |
|
getRange(endereço?: cadeia de caracteres) | 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
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.