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.
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. |