Excel.Range class
O intervalo representa um conjunto de uma ou mais células contíguas, como uma célula, uma linha, uma coluna ou um bloco de células. Para saber mais sobre como os intervalos são usados em toda a API, comece com Intervalos na API JavaScript do Excel.
- Extends
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Propriedades
address | Especifica a referência de intervalo no estilo A1. O valor do endereço contém a referência da planilha (por exemplo, "Sheet1! A1:B4"). |
address |
Representa a referência de intervalo para o intervalo especificado no idioma do usuário. |
cell |
Especifica o número de células no intervalo. Essa API retornará -1 se a contagem de células exceder 2^31-1 (2.147.483.647). |
column |
Especifica o número total de colunas no intervalo. |
column |
Representa se todas as colunas no intervalo atual estiverem ocultas. O valor é |
column |
Especifica o número de coluna da primeira célula no intervalo. Indexados com zero. |
conditional |
A coleção do |
context | O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office. |
data |
Retorna um objeto de validação de dados. |
format | Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo. |
formulas | Representa a fórmula em notação A1. Se uma célula não tiver fórmula, seu valor será retornado. |
formulas |
Representa a fórmula em notação A1, na formatação de número da localidade e no idioma do usuário. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado. |
formulasR1C1 | Representa a fórmula em notação no estilo L1C1. Se uma célula não tiver fórmula, seu valor será retornado. |
has |
Representa se todas as células têm uma borda de despejo. Retorna |
height | Retorna a distância em pontos, para 100% de zoom, da borda superior do intervalo até a borda inferior do intervalo. |
hidden | Representa se todas as células do intervalo atual estiverem ocultas. O valor é |
hyperlink | Representa o hiperlink para o intervalo atual. |
is |
Representa se o intervalo atual está em uma coluna inteira. |
is |
Representa se o intervalo atual está em uma linha inteira. |
left | Retorna a distância em pontos, para 100% de zoom, da borda esquerda da planilha até a borda esquerda do intervalo. |
linked |
Representa o estado do tipo de dados de cada célula. |
number |
Representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número. |
number |
Representa a categoria de formato de número de cada célula. |
number |
Representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de idioma do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a |
row |
Retorna o número total de linhas no intervalo. |
row |
Representa se todas as linhas no intervalo atual estiverem ocultas. O valor é |
row |
Representa o número de linhas da primeira célula no intervalo. Indexados com zero. |
saved |
Representa se todas as células seriam salvas como uma fórmula de matriz. Retorna |
sort | Representa a classificação de intervalo do intervalo atual. |
style | Representa o estilo de intervalo atual. Se os estilos das células forem inconsistentes, |
text | Valores de texto do intervalo especificado. O valor de texto não depende da largura da célula. A substituição de sinal de número (#) que acontece na interface do usuário do Excel não afetará o valor de texto retornado pela API. |
top | Retorna a distância em pontos, para 100% de zoom, da borda superior da planilha até a borda superior do intervalo. |
values | Representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula. |
values |
Uma representação JSON dos valores nas células nesse intervalo. Ao contrário |
values |
Uma representação JSON dos valores nas células nesse intervalo. Ao contrário |
value |
Especifica o tipo de dados em cada célula. |
width | Retorna a distância em pontos, para 100% de zoom, da borda esquerda do intervalo até a borda direita do intervalo. |
worksheet | A planilha que contém o intervalo atual. |
Métodos
auto |
Preenche um intervalo do intervalo atual até o intervalo de destino usando a lógica autofill especificada. O intervalo de destino pode ser Para obter mais informações, consulte Usar Preenchimento Automático e Flash. |
auto |
Preenche um intervalo do intervalo atual até o intervalo de destino usando a lógica autofill especificada. O intervalo de destino pode ser Para obter mais informações, consulte Usar Preenchimento Automático e Flash. |
calculate() | Calcula um intervalo de células em uma planilha. |
clear(apply |
Limpe valores de intervalo, formatação, preenchimento, bordas, etc. |
clear(apply |
Limpe valores de intervalo, formatação, preenchimento, bordas, etc. |
convert |
Converte as células de intervalo com tipos de dados em texto. |
convert |
Converte as células de intervalo em tipos de dados vinculados na planilha. |
copy |
Copia dados de célula ou formatação do intervalo de origem ou |
copy |
Copia dados de célula ou formatação do intervalo de origem ou |
delete(shift) | Exclui as células associadas ao intervalo. |
delete(shift |
Exclui as células associadas ao intervalo. |
find(text, criteria) | Localiza certa cadeia de caracteres com base em critérios especificados. Se o intervalo atual for maior que uma única célula, a pesquisa será limitada a esse intervalo, caso contrário, a pesquisa cobrirá toda a planilha a partir dessa célula. |
find |
Localiza certa cadeia de caracteres com base em critérios especificados. Se o intervalo atual for maior que uma única célula, a pesquisa será limitada a esse intervalo, caso contrário, a pesquisa cobrirá toda a planilha a partir dessa célula. Se não houver correspondências, esse método retornará um objeto com sua |
flash |
Faz um Preenchimento Flash para o intervalo atual. O Preenchimento Flash preenche automaticamente os dados quando ele sente um padrão, portanto, o intervalo deve ser um único intervalo de colunas e ter dados ao seu redor para encontrar um padrão. |
get |
Obtém um |
get |
Obtém o menor objeto de intervalo que abrange os intervalos determinados. Por exemplo, o |
get |
Obtém o objeto de intervalo que contém a célula única com base nos números de linha e de coluna. A célula pode estar fora dos limites de seu intervalo pai, desde que permaneça dentro da grade da planilha. A localização da célula retornada está relacionada à célula superior esquerda do intervalo. |
get |
Retorna uma matriz 2D encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula. |
get |
Obtém uma coluna incluída no intervalo. |
get |
Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada coluna. Para propriedades que não são consistentes nas células de uma determinada coluna, será retornado null. |
get |
Obtém um determinado número de colunas à direita do objeto atual |
get |
Obtém um determinado número de colunas à esquerda do objeto atual |
get |
Retorna um |
get |
Retorna um |
get |
Retorna um |
get |
Obtém um objeto que representa toda a coluna do intervalo (por exemplo, se o intervalo atual representa as células "B4:E11", ele |
get |
Obtém um objeto que representa toda a linha do intervalo (por exemplo, se o intervalo atual representa as células "B4:E11", ele |
get |
Retorna um objeto de intervalo que inclui o intervalo atual e até a borda do intervalo, com base na direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Shift+Arrow no Excel na interface do usuário do Windows. |
get |
Retorna um objeto de intervalo que inclui o intervalo atual e até a borda do intervalo, com base na direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Shift+Arrow no Excel na interface do usuário do Windows. |
get |
Renderiza o intervalo como uma imagem png codificada com base64. Importante*: atualmente, essa API não tem suporte em Excel para Mac. Visite OfficeDev/office-js Problema nº 235 do status atual. |
get |
Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados. |
get |
Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados. Se nenhuma interseção for encontrada, esse método retornará um objeto com sua |
get |
Obtém a última célula do intervalo. Por exemplo, a última célula de "B2:D5" é "D5". |
get |
Obtém a última coluna do intervalo. Por exemplo, a última coluna de "B2:D5" é "D2:D5". |
get |
Obtém a última linha do intervalo. Por exemplo, a última linha de "B2:D5" é "B5:D5". |
get |
Retorna um |
get |
Obtém um objeto que representa um intervalo deslocado do intervalo especificado. A dimensão do intervalo retornado corresponde a esse intervalo. Se o intervalo resultante for imposto para fora dos limites da grade da planilha, o sistema gerará um erro. |
get |
Obtém uma coleção com escopo de Tabelas Dinâmicas que se sobrepõem ao intervalo. |
get |
Retorna um |
get |
Retorna um objeto range que é a célula de borda da região de dados que corresponde à direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Arrow no Excel na interface do usuário do Windows. |
get |
Retorna um objeto range que é a célula de borda da região de dados que corresponde à direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Arrow no Excel na interface do usuário do Windows. |
get |
Obtém um |
get |
Obtém uma linha contida no intervalo. |
get |
Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula. Para propriedades que não são consistentes em cada célula dentro de uma determinada linha, |
get |
Obtém um determinado número de linhas acima do objeto atual |
get |
Obtém um determinado número de linhas abaixo do objeto atual |
get |
Obtém o |
get |
Obtém o |
get |
Obtém o |
get |
Obtém o |
get |
Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora. Falha se aplicado a um intervalo com mais de uma célula. |
get |
Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora. Se o intervalo não for uma célula de âncora ou o intervalo de derramamento não puder ser encontrado, esse método retornará um objeto com sua |
get |
Obtém o objeto range que contém a célula âncora para uma célula que recebe o despejo. Falha se aplicado a um intervalo com mais de uma célula. |
get |
Obtém o objeto range que contém a célula âncora para a célula que está sendo derramada. Se não for uma célula derramada ou mais de uma célula for fornecida, esse método retornará um objeto com sua |
get |
Retorna um |
get |
Obtém uma coleção de tabelas com escopo que se sobrepõe ao intervalo. |
get |
Retorna o intervalo usado do objeto de intervalo determinado. Se não houver células usadas no intervalo, essa função gerará um |
get |
Retorna o intervalo usado do objeto de intervalo determinado. Se não houver células usadas no intervalo, esse método retornará um objeto com sua |
get |
Representa as linhas visíveis do intervalo atual. |
group(group |
Agrupa colunas e linhas para um esboço. |
group(group |
Agrupa colunas e linhas para um esboço. |
hide |
Oculta os detalhes da linha ou do grupo de colunas. |
hide |
Oculta os detalhes da linha ou do grupo de colunas. |
insert(shift) | 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. Retorna um novo |
insert(shift |
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. Retorna um novo |
load(options) | Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
load(property |
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar |
merge(across) | Mescla as células do intervalo em uma região da planilha. |
move |
Move valores de célula, formatação e fórmulas do intervalo atual para o intervalo de destino, substituindo as informações antigas nessas células. O intervalo de destino será expandido automaticamente se for menor que o intervalo atual. As células no intervalo de destino que estão fora da área do intervalo original não são alteradas. |
remove |
Remove valores duplicados do intervalo especificado pelas colunas. |
replace |
Localiza e substitui a cadeia de caracteres fornecida com base nos critérios especificados no intervalo atual. |
select() | Seleciona o intervalo especificado na interface do usuário do Excel. |
set(properties, options) | Define várias propriedades de um objeto ao mesmo tempo. Você pode passar um objeto simples com as propriedades apropriadas ou outro objeto de API do mesmo tipo. |
set(properties) | Define várias propriedades no objeto ao mesmo tempo, com base em um objeto carregado existente. |
set |
Atualizações o intervalo com base em uma matriz 2D de propriedades de célula, encapsulando coisas como fonte, preenchimento, bordas e alinhamento. |
set |
Atualizações o intervalo com base em uma matriz unidimensional de propriedades de coluna, encapsulando coisas como fonte, preenchimento, bordas e alinhamento. |
set |
Define um intervalo a ser recalculado quando o próximo recálculo ocorrer. |
set |
Atualizações o intervalo com base em uma matriz unidimensional de propriedades de linha, encapsulando coisas como fonte, preenchimento, bordas e alinhamento. |
show |
Exibe o cartão para uma célula ativa se ele tiver um conteúdo valioso. |
show |
Mostra os detalhes da linha ou do grupo de colunas. |
show |
Mostra os detalhes da linha ou do grupo de colunas. |
toJSON() | Substitui o método JavaScript |
track() | Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Essa chamada é uma abreviação para context.trackedObjects.add(thisObject). Se você estiver usando esse objeto entre |
ungroup(group |
Desagrupa colunas e linhas para um esboço. |
ungroup(group |
Desagrupa colunas e linhas para um esboço. |
unmerge() | Desfaz a mesclagem das células do intervalo em células separadas. |
untrack() | Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Essa chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Você precisará chamar |
Detalhes da propriedade
address
Especifica a referência de intervalo no estilo A1. O valor do endereço contém a referência da planilha (por exemplo, "Sheet1! A1:B4").
readonly address: string;
Valor da propriedade
string
Comentários
addressLocal
Representa a referência de intervalo para o intervalo especificado no idioma do usuário.
readonly addressLocal: string;
Valor da propriedade
string
Comentários
cellCount
Especifica o número de células no intervalo. Essa API retornará -1 se a contagem de células exceder 2^31-1 (2.147.483.647).
readonly cellCount: number;
Valor da propriedade
number
Comentários
columnCount
Especifica o número total de colunas no intervalo.
readonly columnCount: number;
Valor da propriedade
number
Comentários
columnHidden
Representa se todas as colunas no intervalo atual estiverem ocultas. O valor é true
quando todas as colunas em um intervalo são ocultas. O valor é false
quando nenhuma coluna no intervalo está oculta. O valor é null
quando algumas colunas em um intervalo são ocultas e outras colunas no mesmo intervalo não são ocultas.
columnHidden: boolean;
Valor da propriedade
boolean
Comentários
columnIndex
Especifica o número de coluna da primeira célula no intervalo. Indexados com zero.
readonly columnIndex: number;
Valor da propriedade
number
Comentários
conditionalFormats
A coleção do ConditionalFormats
que cruza o intervalo.
readonly conditionalFormats: Excel.ConditionalFormatCollection;
Valor da propriedade
Comentários
context
O contexto de solicitação associado ao objeto. Isso conecta o processo do suplemento ao processo do aplicativo host do Office.
context: RequestContext;
Valor da propriedade
dataValidation
Retorna um objeto de validação de dados.
readonly dataValidation: Excel.DataValidation;
Valor da propriedade
Comentários
format
Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo.
readonly format: Excel.RangeFormat;
Valor da propriedade
Comentários
formulas
Representa a fórmula em notação A1. Se uma célula não tiver fórmula, seu valor será retornado.
formulas: any[][];
Valor da propriedade
any[][]
Comentários
formulasLocal
Representa a fórmula em notação A1, na formatação de número da localidade e no idioma do usuário. Por exemplo, a fórmula "=SUM(A1, 1.5)" em inglês seria "=SOMA(A1; 1,5)" em português. Se uma célula não tiver fórmula, seu valor será retornado.
formulasLocal: any[][];
Valor da propriedade
any[][]
Comentários
formulasR1C1
Representa a fórmula em notação no estilo L1C1. Se uma célula não tiver fórmula, seu valor será retornado.
formulasR1C1: any[][];
Valor da propriedade
any[][]
Comentários
hasSpill
Representa se todas as células têm uma borda de despejo. Retorna true
se todas as células tiverem uma borda de derramamento ou false
se todas as células não tiverem uma borda de derramamento. Retornará null
se houver células com e sem bordas de derramamento dentro do intervalo.
readonly hasSpill: boolean;
Valor da propriedade
boolean
Comentários
height
Retorna a distância em pontos, para 100% de zoom, da borda superior do intervalo até a borda inferior do intervalo.
readonly height: number;
Valor da propriedade
number
Comentários
hidden
Representa se todas as células do intervalo atual estiverem ocultas. O valor é true
quando todas as células em um intervalo são ocultas. O valor é false
quando nenhuma célula no intervalo está oculta. O valor é null
quando algumas células em um intervalo estão ocultas e outras células no mesmo intervalo não estão ocultas.
readonly hidden: boolean;
Valor da propriedade
boolean
Comentários
hyperlink
Representa o hiperlink para o intervalo atual.
hyperlink: Excel.RangeHyperlink;
Valor da propriedade
Comentários
[ Conjunto de API: ExcelApi 1.7 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-hyperlink.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Orders");
let productsRange = sheet.getRange("A3:A5");
productsRange.load("values");
await context.sync();
// Create a hyperlink to a URL
// for each product name in the first table.
for (let i = 0; i < productsRange.values.length; i++) {
let cellRange = productsRange.getCell(i, 0);
let cellText = productsRange.values[i][0];
let hyperlink = {
textToDisplay: cellText,
screenTip: "Search Bing for '" + cellText + "'",
address: "https://www.bing.com?q=" + cellText
}
cellRange.hyperlink = hyperlink;
}
await context.sync();
});
isEntireColumn
Representa se o intervalo atual está em uma coluna inteira.
readonly isEntireColumn: boolean;
Valor da propriedade
boolean
Comentários
isEntireRow
Representa se o intervalo atual está em uma linha inteira.
readonly isEntireRow: boolean;
Valor da propriedade
boolean
Comentários
left
Retorna a distância em pontos, para 100% de zoom, da borda esquerda da planilha até a borda esquerda do intervalo.
readonly left: number;
Valor da propriedade
number
Comentários
linkedDataTypeState
Representa o estado do tipo de dados de cada célula.
readonly linkedDataTypeState: Excel.LinkedDataTypeState[][];
Valor da propriedade
Comentários
numberFormat
Representa o código de formato de número do Excel para o intervalo determinado. Para obter mais informações sobre a formatação de números do Excel, consulte Códigos de formato de número.
numberFormat: any[][];
Valor da propriedade
any[][]
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
// Set the text of the chart title to "My Chart" and display it as an overlay on the chart.
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "F5:G7";
const numberFormat = [[null, "d-mmm"], [null, "d-mmm"], [null, null]]
const values = [["Today", 42147], ["Tomorrow", "5/24"], ["Difference in days", null]];
const formulas = [[null,null], [null,null], [null,"=G6-G5"]];
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.numberFormat = numberFormat;
range.values = values;
range.formulas= formulas;
range.load('text');
await context.sync();
console.log(range.text);
});
numberFormatCategories
Representa a categoria de formato de número de cada célula.
readonly numberFormatCategories: Excel.NumberFormatCategory[][];
Valor da propriedade
Comentários
numberFormatLocal
Representa o código de formato de número do Excel para o intervalo determinado, com base nas configurações de idioma do usuário. O Excel não executa nenhuma coerção de linguagem ou formato ao obter ou definir a numberFormatLocal
propriedade. Qualquer texto retornado usa as cadeias de caracteres formatadas localmente com base no idioma especificado nas configurações do sistema.
numberFormatLocal: any[][];
Valor da propriedade
any[][]
Comentários
rowCount
Retorna o número total de linhas no intervalo.
readonly rowCount: number;
Valor da propriedade
number
Comentários
rowHidden
Representa se todas as linhas no intervalo atual estiverem ocultas. O valor é true
quando todas as linhas em um intervalo são ocultas. O valor é false
quando nenhuma linha no intervalo é oculta. O valor é null
quando algumas linhas em um intervalo estão ocultas e outras linhas no mesmo intervalo não são ocultas.
rowHidden: boolean;
Valor da propriedade
boolean
Comentários
rowIndex
Representa o número de linhas da primeira célula no intervalo. Indexados com zero.
readonly rowIndex: number;
Valor da propriedade
number
Comentários
savedAsArray
Representa se todas as células seriam salvas como uma fórmula de matriz. Retorna true
se todas as células fossem salvas como uma fórmula de matriz ou false
se todas as células não fossem salvas como uma fórmula de matriz. Retorna null
se algumas células seriam salvas como uma fórmula de matriz e algumas não seriam.
readonly savedAsArray: boolean;
Valor da propriedade
boolean
Comentários
sort
Representa a classificação de intervalo do intervalo atual.
readonly sort: Excel.RangeSort;
Valor da propriedade
Comentários
[ Conjunto de API: ExcelApi 1.2 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/event-column-and-row-sort.yaml
async function sortTopToBottom(criteria: string) {
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
const range = sheet.getRange("A1:E5");
// Find the column header that provides the sort criteria.
const header = range.find(criteria, {});
header.load("columnIndex");
await context.sync();
range.sort.apply(
[
{
key: header.columnIndex,
sortOn: Excel.SortOn.value
}
],
false /*matchCase*/,
true /*hasHeaders*/,
Excel.SortOrientation.rows
);
await context.sync();
});
}
style
Representa o estilo de intervalo atual. Se os estilos das células forem inconsistentes, null
serão retornados. Para estilos personalizados, o nome do estilo será retornado. Para estilos internos, uma cadeia de caracteres que representa um valor no BuiltInStyle
enum será retornada.
style: string;
Valor da propriedade
string
Comentários
[ Conjunto de API: ExcelApi 1.7 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/style.yaml
await Excel.run(async (context) => {
let worksheet = context.workbook.worksheets.getItem("Sample");
let range = worksheet.getRange("A1:E1");
// Apply built-in style.
// Styles are in the Home tab ribbon.
range.style = Excel.BuiltInStyle.neutral;
range.format.horizontalAlignment = "Right";
await context.sync();
});
text
Valores de texto do intervalo especificado. O valor de texto não depende da largura da célula. A substituição de sinal de número (#) que acontece na interface do usuário do Excel não afetará o valor de texto retornado pela API.
readonly text: string[][];
Valor da propriedade
string[][]
Comentários
top
Retorna a distância em pontos, para 100% de zoom, da borda superior da planilha até a borda superior do intervalo.
readonly top: number;
Valor da propriedade
number
Comentários
values
Representa os valores brutos do intervalo especificado. Os dados retornados podem ser uma cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro. Se o valor retornado começar com uma adição ("+"), menos ("-"), ou sinal igual ("="), o Excel interpretará esse valor como uma fórmula.
values: any[][];
Valor da propriedade
any[][]
Comentários
valuesAsJson
Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.values
de , Range.valuesAsJson
dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham com a localidade en-US. Para recuperar dados na localidade de exibição do usuário, use Range.valuesAsJsonLocal
.
valuesAsJson: CellValue[][];
Valor da propriedade
Excel.CellValue[][]
Comentários
[ Conjunto de API: ExcelApi 1.16 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-formatted-number.yaml
// This function creates a formatted number data type,
// and sets the format of this data type as a date.
await Excel.run(async (context) => {
// Get the Sample worksheet and a range on that sheet.
const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
const dateRange = sheet.getRange("A1");
// Write a number formatted as a date to cell A1.
dateRange.valuesAsJson = [
[
{
type: Excel.CellValueType.formattedNumber,
basicValue: 32889.0,
numberFormat: "m/d/yyyy"
}
]
];
await context.sync();
});
valuesAsJsonLocal
Uma representação JSON dos valores nas células nesse intervalo. Ao contrário Range.values
de , Range.valuesAsJsonLocal
dá suporte a todos os tipos de dados que podem estar em uma célula. Exemplos incluem valores de número formatado e imagens da Web, além dos valores padrão booliano, número e cadeia de caracteres. Os dados retornados dessa API sempre se alinham à localidade de exibição do usuário. Para recuperar dados independentes da localidade, use Range.valuesAsJson
.
valuesAsJsonLocal: CellValue[][];
Valor da propriedade
Excel.CellValue[][]
Comentários
valueTypes
Especifica o tipo de dados em cada célula.
readonly valueTypes: Excel.RangeValueType[][];
Valor da propriedade
Comentários
width
Retorna a distância em pontos, para 100% de zoom, da borda esquerda do intervalo até a borda direita do intervalo.
readonly width: number;
Valor da propriedade
number
Comentários
worksheet
A planilha que contém o intervalo atual.
readonly worksheet: Excel.Worksheet;
Valor da propriedade
Comentários
Detalhes do método
autoFill(destinationRange, autoFillType)
Preenche um intervalo do intervalo atual até o intervalo de destino usando a lógica autofill especificada. O intervalo de destino pode ser null
ou pode estender o intervalo de origem horizontal ou verticalmente. Não há suporte para intervalos discontiguos.
Para obter mais informações, consulte Usar Preenchimento Automático e Flash.
autoFill(destinationRange?: Range | string, autoFillType?: Excel.AutoFillType): void;
Parâmetros
- destinationRange
-
Excel.Range | string
O intervalo de destino para AutoFill. Se o intervalo de destino for null
, os dados serão preenchidos com base nas células ao redor (que é o comportamento ao clicar duas vezes no identificador de preenchimento de intervalo da interface do usuário).
- autoFillType
- Excel.AutoFillType
O tipo de AutoFill. Especifica como o intervalo de destino deve ser preenchido, com base no conteúdo do intervalo atual. O padrão é "FillDefault".
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.9, Visualização do ExcelApi para nulo destinationRange
]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-auto-fill.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
const sumCell = sheet.getRange("P4");
// Copy everything. The formulas will be contextually updated based on their new locations.
sumCell.autoFill("P4:P7", Excel.AutoFillType.fillCopy);
sumCell.format.autofitColumns();
await context.sync();
});
autoFill(destinationRange, autoFillTypeString)
Preenche um intervalo do intervalo atual até o intervalo de destino usando a lógica autofill especificada. O intervalo de destino pode ser null
ou pode estender o intervalo de origem horizontal ou verticalmente. Não há suporte para intervalos discontiguos.
Para obter mais informações, consulte Usar Preenchimento Automático e Flash.
autoFill(destinationRange?: Range | string, autoFillTypeString?: "FillDefault" | "FillCopy" | "FillSeries" | "FillFormats" | "FillValues" | "FillDays" | "FillWeekdays" | "FillMonths" | "FillYears" | "LinearTrend" | "GrowthTrend" | "FlashFill"): void;
Parâmetros
- destinationRange
-
Excel.Range | string
O intervalo de destino para AutoFill. Se o intervalo de destino for null
, os dados serão preenchidos com base nas células ao redor (que é o comportamento ao clicar duas vezes no identificador de preenchimento de intervalo da interface do usuário).
- autoFillTypeString
-
"FillDefault" | "FillCopy" | "FillSeries" | "FillFormats" | "FillValues" | "FillDays" | "FillWeekdays" | "FillMonths" | "FillYears" | "LinearTrend" | "GrowthTrend" | "FlashFill"
O tipo de AutoFill. Especifica como o intervalo de destino deve ser preenchido, com base no conteúdo do intervalo atual. O padrão é "FillDefault".
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.9, Visualização do ExcelApi para nulo destinationRange
]
calculate()
Calcula um intervalo de células em uma planilha.
calculate(): void;
Retornos
void
Comentários
clear(applyTo)
Limpe valores de intervalo, formatação, preenchimento, bordas, etc.
clear(applyTo?: Excel.ClearApplyTo): void;
Parâmetros
- applyTo
- Excel.ClearApplyTo
Opcional. Determina o tipo de ação clara. Confira Excel.ClearApplyTo
detalhes.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
// Clear the format and contents of the range.
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D:F";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.clear();
await context.sync();
});
clear(applyToString)
Limpe valores de intervalo, formatação, preenchimento, bordas, etc.
clear(applyToString?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks"): void;
Parâmetros
- applyToString
-
"All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks"
Opcional. Determina o tipo de ação clara. Confira Excel.ClearApplyTo
detalhes.
Retornos
void
Comentários
convertDataTypeToText()
Converte as células de intervalo com tipos de dados em texto.
convertDataTypeToText(): void;
Retornos
void
Comentários
convertToLinkedDataType(serviceID, languageCulture)
Converte as células de intervalo em tipos de dados vinculados na planilha.
convertToLinkedDataType(serviceID: number, languageCulture: string): void;
Parâmetros
- serviceID
-
number
A ID do serviço que será usada para consultar os dados.
- languageCulture
-
string
Cultura de idioma para consultar o serviço.
Retornos
void
Comentários
copyFrom(sourceRange, copyType, skipBlanks, transpose)
Copia dados de célula ou formatação do intervalo de origem ou RangeAreas
para o intervalo atual. O intervalo de destino pode ser um tamanho diferente do intervalo de origem ou RangeAreas
. O destino será expandido automaticamente se for menor que a origem. Observação: como a funcionalidade de cópia na interface do usuário do Excel, se o intervalo de destino for um múltiplo exato maior que o intervalo de origem em linhas ou colunas, o conteúdo de origem será replicado várias vezes. Por exemplo, uma cópia de intervalo 2x2 em um intervalo de 2x6 resultará em três cópias do intervalo 2x2 original.
copyFrom(sourceRange: Range | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: boolean, transpose?: boolean): void;
Parâmetros
- sourceRange
-
Excel.Range | Excel.RangeAreas | string
O intervalo de origem ou RangeAreas
para copiar. Quando a origem RangeAreas
tem vários intervalos, seu formulário deve ser capaz de ser criado removendo linhas ou colunas completas de um intervalo retangular.
- copyType
- Excel.RangeCopyType
O tipo de dados de célula ou formatação a ser copiado. O padrão é "Todos".
- skipBlanks
-
boolean
True se for ignorar células em branco no intervalo de origem. O padrão é false.
- transpose
-
boolean
True se para transpor as células no intervalo de destino. O padrão é false.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-copyfrom.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Place a label in front of the copied data.
sheet.getRange("F2").values = [["Copied Formula"]];
// Copy a range preserving the formulas.
// Note: non-formula values are copied over as is.
sheet.getRange("G2").copyFrom("A1:E1", Excel.RangeCopyType.formulas);
await context.sync();
});
copyFrom(sourceRange, copyTypeString, skipBlanks, transpose)
Copia dados de célula ou formatação do intervalo de origem ou RangeAreas
para o intervalo atual. O intervalo de destino pode ser um tamanho diferente do intervalo de origem ou RangeAreas
. O destino será expandido automaticamente se for menor que a origem. Observação: como a funcionalidade de cópia na interface do usuário do Excel, se o intervalo de destino for um múltiplo exato maior que o intervalo de origem em linhas ou colunas, o conteúdo de origem será replicado várias vezes. Por exemplo, uma cópia de intervalo 2x2 em um intervalo de 2x6 resultará em três cópias do intervalo 2x2 original.
copyFrom(sourceRange: Range | RangeAreas | string, copyTypeString?: "All" | "Formulas" | "Values" | "Formats" | "Link" | "ColumnWidths", skipBlanks?: boolean, transpose?: boolean): void;
Parâmetros
- sourceRange
-
Excel.Range | Excel.RangeAreas | string
O intervalo de origem ou RangeAreas
para copiar. Quando a origem RangeAreas
tem vários intervalos, seu formulário deve ser capaz de ser criado removendo linhas ou colunas completas de um intervalo retangular.
- copyTypeString
-
"All" | "Formulas" | "Values" | "Formats" | "Link" | "ColumnWidths"
O tipo de dados de célula ou formatação a ser copiado. O padrão é "Todos".
- skipBlanks
-
boolean
True se for ignorar células em branco no intervalo de origem. O padrão é false.
- transpose
-
boolean
True se para transpor as células no intervalo de destino. O padrão é false.
Retornos
void
Comentários
delete(shift)
Exclui as células associadas ao intervalo.
delete(shift: Excel.DeleteShiftDirection): void;
Parâmetros
Especifica como deslocar as células. Confira Excel.DeleteShiftDirection
detalhes.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D:F";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.delete("Left");
await context.sync();
});
delete(shiftString)
Exclui as células associadas ao intervalo.
delete(shiftString: "Up" | "Left"): void;
Parâmetros
- shiftString
-
"Up" | "Left"
Especifica como deslocar as células. Confira Excel.DeleteShiftDirection
detalhes.
Retornos
void
Comentários
find(text, criteria)
Localiza certa cadeia de caracteres com base em critérios especificados. Se o intervalo atual for maior que uma única célula, a pesquisa será limitada a esse intervalo, caso contrário, a pesquisa cobrirá toda a planilha a partir dessa célula.
find(text: string, criteria: Excel.SearchCriteria): Excel.Range;
Parâmetros
- text
-
string
A cadeia de caracteres a ser encontrada.
- criteria
- Excel.SearchCriteria
Critérios de pesquisa adicionais, incluindo a direção da pesquisa e se a pesquisa precisa corresponder a toda a célula ou ser sensível a casos.
Retornos
O Range
objeto que representa a primeira célula que contém um valor que corresponde ao texto e aos critérios da pesquisa.
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-find.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const table = sheet.tables.getItem("ExpensesTable");
const searchRange = table.getRange();
// NOTE: If no match is found, an ItemNotFound error
// is thrown when Range.find is evaluated.
const foundRange = searchRange.find($("#searchText").val().toString(), {
completeMatch: isCompleteMatchToggle,
matchCase: isMatchCaseToggle,
searchDirection: searchDirectionToggle
});
foundRange.load("address");
await context.sync();
console.log(foundRange.address);
});
findOrNullObject(text, criteria)
Localiza certa cadeia de caracteres com base em critérios especificados. Se o intervalo atual for maior que uma única célula, a pesquisa será limitada a esse intervalo, caso contrário, a pesquisa cobrirá toda a planilha a partir dessa célula. Se não houver correspondências, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
findOrNullObject(text: string, criteria: Excel.SearchCriteria): Excel.Range;
Parâmetros
- text
-
string
A cadeia de caracteres a ser encontrada.
- criteria
- Excel.SearchCriteria
Critérios de pesquisa adicionais, incluindo a direção da pesquisa e se a pesquisa precisa corresponder a toda a célula ou ser sensível a casos.
Retornos
O Range
que correspondia aos critérios de pesquisa.
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-find.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const table = sheet.tables.getItem("ExpensesTable");
const searchRange = table.getRange();
const foundRange = searchRange.findOrNullObject($("#searchText").val().toString(), {
completeMatch: isCompleteMatchToggle,
matchCase: isMatchCaseToggle,
searchDirection: searchDirectionToggle
});
foundRange.load("address");
await context.sync();
if (foundRange.isNullObject) {
console.log("Text not found");
} else {
console.log(foundRange.address);
}
});
flashFill()
Faz um Preenchimento Flash para o intervalo atual. O Preenchimento Flash preenche automaticamente os dados quando ele sente um padrão, portanto, o intervalo deve ser um único intervalo de colunas e ter dados ao seu redor para encontrar um padrão.
flashFill(): void;
Retornos
void
Comentários
getAbsoluteResizedRange(numRows, numColumns)
Obtém um Range
objeto com a mesma célula superior esquerda que o objeto atual Range
, mas com os números especificados de linhas e colunas.
getAbsoluteResizedRange(numRows: number, numColumns: number): Excel.Range;
Parâmetros
- numRows
-
number
O número de linhas do novo tamanho de intervalo.
- numColumns
-
number
O número de colunas do novo tamanho de intervalo.
Retornos
Comentários
getBoundingRect(anotherRange)
Obtém o menor objeto de intervalo que abrange os intervalos determinados. Por exemplo, o GetBoundingRect
de "B2:C5" e "D10:E15" é "B2:E15".
getBoundingRect(anotherRange: Range | string): Excel.Range;
Parâmetros
- anotherRange
-
Excel.Range | string
O objeto de intervalo, o endereço ou o nome do intervalo.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D4:G6";
let range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range = range.getBoundingRect("G4:H8");
range.load('address');
await context.sync();
console.log(range.address); // Prints Sheet1!D4:H8
});
getCell(row, column)
Obtém o objeto de intervalo que contém a célula única com base nos números de linha e de coluna. A célula pode estar fora dos limites de seu intervalo pai, desde que permaneça dentro da grade da planilha. A localização da célula retornada está relacionada à célula superior esquerda do intervalo.
getCell(row: number, column: number): Excel.Range;
Parâmetros
- row
-
number
O número da linha da célula a ser recuperada. Indexados com zero.
- column
-
number
O número da coluna da célula a ser recuperada. Indexados com zero.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const worksheet = context.workbook.worksheets.getItem(sheetName);
const range = worksheet.getRange(rangeAddress);
const cell = range.getCell(0,0);
cell.load('address');
await context.sync();
console.log(cell.address);
});
getCellProperties(cellPropertiesLoadOptions)
Retorna uma matriz 2D encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula.
getCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions): OfficeExtension.ClientResult<CellProperties[][]>;
Parâmetros
- cellPropertiesLoadOptions
- Excel.CellPropertiesLoadOptions
Um objeto que representa quais propriedades de célula carregar.
Retornos
Uma matriz 2D em que cada item representa as propriedades solicitadas da célula correspondente.
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
await Excel.run(async (context) => {
const cell = context.workbook.getActiveCell();
// Define the cell properties to get by setting the matching LoadOptions to true.
const propertiesToGet = cell.getCellProperties({
address: true,
format: {
fill: {
color: true
},
font: {
color: true
}
},
style: true
});
// Sync to get the data from the workbook.
await context.sync();
const cellProperties = propertiesToGet.value[0][0];
console.log(
`Address: ${cellProperties.address}\nStyle: ${cellProperties.style}\nFill Color: ${cellProperties.format.fill.color}\nFont Color: ${cellProperties.format.font.color}`);
});
getColumn(column)
Obtém uma coluna incluída no intervalo.
getColumn(column: number): Excel.Range;
Parâmetros
- column
-
number
O número da coluna do intervalo a ser recuperado. Indexados com zero.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet19";
const rangeAddress = "A1:F8";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getColumn(1);
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!B1:B8
});
getColumnProperties(columnPropertiesLoadOptions)
Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada coluna. Para propriedades que não são consistentes nas células de uma determinada coluna, será retornado null.
getColumnProperties(columnPropertiesLoadOptions: ColumnPropertiesLoadOptions): OfficeExtension.ClientResult<ColumnProperties[]>;
Parâmetros
- columnPropertiesLoadOptions
- Excel.ColumnPropertiesLoadOptions
Um objeto que representa quais propriedades de coluna carregar.
Retornos
Uma matriz em que cada item representa as propriedades solicitadas da coluna correspondente.
Comentários
getColumnsAfter(count)
Obtém um determinado número de colunas à direita do objeto atual Range
.
getColumnsAfter(count?: number): Excel.Range;
Parâmetros
- count
-
number
Opcional. O número de colunas a serem incluídas no intervalo resultante. Em geral, use um número positivo para criar um intervalo fora do intervalo atual. Você também pode usar um número negativo para criar um intervalo dentro do intervalo atual. O valor padrão é 1.
Retornos
Comentários
getColumnsBefore(count)
Obtém um determinado número de colunas à esquerda do objeto atual Range
.
getColumnsBefore(count?: number): Excel.Range;
Parâmetros
- count
-
number
Opcional. O número de colunas a serem incluídas no intervalo resultante. Em geral, use um número positivo para criar um intervalo fora do intervalo atual. Você também pode usar um número negativo para criar um intervalo dentro do intervalo atual. O valor padrão é 1.
Retornos
Comentários
getDependents()
Retorna um WorkbookRangeAreas
objeto que representa o intervalo que contém todas as células dependentes de um intervalo especificado na mesma planilha ou em várias planilhas.
getDependents(): Excel.WorkbookRangeAreas;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.15 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-dependents.yaml
// This function highlights all the dependent cells of the active cell.
// Dependent cells contain formulas that refer to other cells.
await Excel.run(async (context) => {
// Get addresses of the active cell's dependent cells.
const range = context.workbook.getActiveCell();
const dependents = range.getDependents();
range.load("address");
dependents.areas.load("address");
await context.sync();
console.log(`All dependent cells of ${range.address}:`);
// Use the dependents API to loop through dependents of the active cell.
for (let i = 0; i < dependents.areas.items.length; i++) {
// Highlight and print out the address of each dependent cell.
dependents.areas.items[i].format.fill.color = "Orange";
console.log(` ${dependents.areas.items[i].address}`);
}
await context.sync();
});
getDirectDependents()
Retorna um WorkbookRangeAreas
objeto que representa o intervalo que contém todas as células dependentes diretas de um intervalo especificado na mesma planilha ou em várias planilhas.
getDirectDependents(): Excel.WorkbookRangeAreas;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.13 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-direct-dependents.yaml
await Excel.run(async (context) => {
// Direct dependents are cells that contain formulas that refer to other cells.
let range = context.workbook.getActiveCell();
let directDependents = range.getDirectDependents();
range.load("address");
directDependents.areas.load("address");
await context.sync();
console.log(`Direct dependent cells of ${range.address}:`);
// Use the direct dependents API to loop through direct dependents of the active cell.
for (let i = 0; i < directDependents.areas.items.length; i++) {
// Highlight and print the address of each dependent cell.
directDependents.areas.items[i].format.fill.color = "Yellow";
console.log(` ${directDependents.areas.items[i].address}`);
}
await context.sync();
});
getDirectPrecedents()
Retorna um WorkbookRangeAreas
objeto que representa o intervalo que contém todas as células precedentes diretas de um intervalo especificado na mesma planilha ou em várias planilhas.
getDirectPrecedents(): Excel.WorkbookRangeAreas;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.12 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/precedents.yaml
await Excel.run(async (context) => {
// Precedents are cells referenced by the formula in a cell.
// A "direct precedent" is a cell directly referenced by the selected formula.
let range = context.workbook.getActiveCell();
let directPrecedents = range.getDirectPrecedents();
range.load("address");
directPrecedents.areas.load("address");
await context.sync();
console.log(`Direct precedent cells of ${range.address}:`);
// Use the direct precedents API to loop through precedents of the active cell.
for (let i = 0; i < directPrecedents.areas.items.length; i++) {
// Highlight and console the address of each precedent cell.
directPrecedents.areas.items[i].format.fill.color = "Yellow";
console.log(` ${directPrecedents.areas.items[i].address}`);
}
await context.sync();
});
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").
getEntireColumn(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
// Note: the grid properties of the Range (values, numberFormat, formulas)
// contains null since the Range in question is unbounded.
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D:F";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
const rangeEC = range.getEntireColumn();
rangeEC.load('address');
await context.sync();
console.log(rangeEC.address);
});
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").
getEntireRow(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
// Gets an object that represents the entire row of the range
// (for example, if the current range represents cells "B4:E11",
// its GetEntireRow is a range that represents rows "4:11").
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D:F";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
const rangeER = range.getEntireRow();
rangeER.load('address');
await context.sync();
console.log(rangeER.address);
});
getExtendedRange(direction, activeCell)
Retorna um objeto de intervalo que inclui o intervalo atual e até a borda do intervalo, com base na direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Shift+Arrow no Excel na interface do usuário do Windows.
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
Parâmetros
- direction
- Excel.KeyboardDirection
A direção da célula ativa.
- activeCell
-
Excel.Range | string
A célula ativa nesse intervalo. Por padrão, a célula ativa é a célula superior esquerda do intervalo. Um erro será gerado se a célula ativa não estiver nesse intervalo.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.13 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-get-range-edge.yaml
await Excel.run(async (context) => {
// Get the selected range.
const range = context.workbook.getSelectedRange();
// Specify the direction with the `KeyboardDirection` enum.
const direction = Excel.KeyboardDirection.down;
// Get the active cell in the workbook.
const activeCell = context.workbook.getActiveCell();
// Get all the cells from the currently selected range to the bottom-most edge of the used range.
// This method acts like the Ctrl+Shift+Arrow key keyboard shortcut while a range is selected.
const extendedRange = range.getExtendedRange(
direction,
activeCell // If the selected range contains more than one cell, the active cell must be defined.
);
extendedRange.select();
await context.sync();
});
getExtendedRange(directionString, activeCell)
Retorna um objeto de intervalo que inclui o intervalo atual e até a borda do intervalo, com base na direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Shift+Arrow no Excel na interface do usuário do Windows.
getExtendedRange(directionString: "Left" | "Right" | "Up" | "Down", activeCell?: Range | string): Excel.Range;
Parâmetros
- directionString
-
"Left" | "Right" | "Up" | "Down"
A direção da célula ativa.
- activeCell
-
Excel.Range | string
A célula ativa nesse intervalo. Por padrão, a célula ativa é a célula superior esquerda do intervalo. Um erro será gerado se a célula ativa não estiver nesse intervalo.
Retornos
Comentários
getImage()
Renderiza o intervalo como uma imagem png codificada com base64. Importante*: atualmente, essa API não tem suporte em Excel para Mac. Visite OfficeDev/office-js Problema nº 235 do status atual.
getImage(): OfficeExtension.ClientResult<string>;
Retornos
OfficeExtension.ClientResult<string>
Comentários
getIntersection(anotherRange)
Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados.
getIntersection(anotherRange: Range | string): Excel.Range;
Parâmetros
- anotherRange
-
Excel.Range | string
O objeto Range ou o endereço do intervalo que será usado para determinar a interseção de intervalos.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const range =
context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getIntersection("D4:G6");
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!D4:F6
});
getIntersectionOrNullObject(anotherRange)
Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados. Se nenhuma interseção for encontrada, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getIntersectionOrNullObject(anotherRange: Range | string): Excel.Range;
Parâmetros
- anotherRange
-
Excel.Range | string
O objeto Range ou o endereço do intervalo que será usado para determinar a interseção de intervalos.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.4 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-relationships.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const salesTable = sheet.tables.getItem("SalesTable");
const dataRange = salesTable.getDataBodyRange();
// We want the most recent quarter that has data, so
// exclude quarters without data and get the last of
// the remaining columns.
const usedDataRange = dataRange.getUsedRange(true /* valuesOnly */);
const currentQuarterRange = usedDataRange.getLastColumn();
// Asian and European teams have separate contests.
const asianSalesRange = sheet.getRange("A2:E4");
const europeanSalesRange = sheet.getRange("A5:E7");
// The data for each chart is the intersection of the
// current quarter column and the rows for the continent.
const asianContestRange = asianSalesRange.getIntersectionOrNullObject(currentQuarterRange);
const europeanContestRange = europeanSalesRange.getIntersectionOrNullObject(currentQuarterRange);
// Must sync before you can test the output of *OrNullObject
// method/property.
await context.sync();
if (asianContestRange.isNullObject) {
// See the declaration of this function for how to
// test this code path.
reportMissingData("Asian");
} else {
createContinentChart(
sheet,
"Asian",
asianContestRange,
"A9",
"F24"
);
}
if (europeanContestRange.isNullObject) {
// See the declaration of this function for how to
// test this code path.
reportMissingData("European");
} else {
createContinentChart(
sheet,
"European",
europeanContestRange,
"A25",
"F40"
);
}
await context.sync();
});
getLastCell()
Obtém a última célula do intervalo. Por exemplo, a última célula de "B2:D5" é "D5".
getLastCell(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getLastCell();
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!F8
});
getLastColumn()
Obtém a última coluna do intervalo. Por exemplo, a última coluna de "B2:D5" é "D2:D5".
getLastColumn(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getLastColumn();
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!F1:F8
});
getLastRow()
Obtém a última linha do intervalo. Por exemplo, a última linha de "B2:D5" é "B5:D5".
getLastRow(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getLastRow();
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!A8:F8
});
getMergedAreasOrNullObject()
Retorna um RangeAreas
objeto que representa as áreas mescladas nesse intervalo. Observe que, se a contagem de áreas mescladas nesse intervalo for superior a 512, esse método não retornará o resultado. Se o RangeAreas
objeto não existir, essa função retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getMergedAreasOrNullObject(): Excel.RangeAreas;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.13 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-merged-ranges.yaml
await Excel.run(async (context) => {
// Retrieve the worksheet and the table in that worksheet.
const sheet = context.workbook.worksheets.getActiveWorksheet();
const tableRange = sheet.getRange("B2:E6");
// Retrieve the merged range within the table and load its details.
const mergedAreas = tableRange.getMergedAreasOrNullObject();
mergedAreas.load("address");
mergedAreas.load("cellCount");
// Select the merged range.
const range = mergedAreas.areas.getItemAt(0);
range.select();
await context.sync();
// Print out the details of the `mergedAreas` range object.
console.log(`Address of the merged range: ${mergedAreas.address}`);
console.log(`Number of cells in the merged range: ${mergedAreas.cellCount}`);
await context.sync();
});
getOffsetRange(rowOffset, columnOffset)
Obtém um objeto que representa um intervalo deslocado do intervalo especificado. A dimensão do intervalo retornado corresponde a esse intervalo. Se o intervalo resultante for imposto para fora dos limites da grade da planilha, o sistema gerará um erro.
getOffsetRange(rowOffset: number, columnOffset: number): Excel.Range;
Parâmetros
- rowOffset
-
number
O número de linhas (positivo, negativo ou 0) com base no qual o intervalo deve ser deslocado. Valores positivos estão deslocados para baixo, e os valores negativos para cima.
- columnOffset
-
number
O número de colunas (positivo, negativo ou 0) com base no qual o intervalo deve ser deslocado. Valores positivos estão deslocados para a direita, e os valores negativos para a esquerda.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "D4:F6";
const range =
context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getOffsetRange(-1,4);
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!H3:J5
});
getPivotTables(fullyContained)
Obtém uma coleção com escopo de Tabelas Dinâmicas que se sobrepõem ao intervalo.
getPivotTables(fullyContained?: boolean): Excel.PivotTableScopedCollection;
Parâmetros
- fullyContained
-
boolean
Se true
, retornará apenas tabelas dinâmicas que estão totalmente contidas nos limites de intervalo. O valor padrão é false
.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.12 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/38-pivottable/pivottable-get-pivottables.yaml
await Excel.run(async (context) => {
const activeRange = context.workbook.getSelectedRange();
// Get all the PivotTables that intersect with this range.
const partiallyContainedPivotTables = activeRange.getPivotTables();
// Get all the PivotTables that are completely contained within this range.
const fullyContainedPivotTables = activeRange.getPivotTables(true);
partiallyContainedPivotTables.load("name");
fullyContainedPivotTables.load("name");
await context.sync();
// Display the names in the console.
console.log("PivotTables in the current range:")
partiallyContainedPivotTables.items.forEach((pivotTable) => {
console.log(`\t${pivotTable.name}`);
});
console.log("PivotTables completely contained in the current range:")
fullyContainedPivotTables.items.forEach((pivotTable) => {
console.log(`\t${pivotTable.name}`);
});
});
getPrecedents()
Retorna um WorkbookRangeAreas
objeto que representa o intervalo que contém todas as células precedentes de um intervalo especificado na mesma planilha ou em várias planilhas.
getPrecedents(): Excel.WorkbookRangeAreas;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.14 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/precedents.yaml
await Excel.run(async (context) => {
// Precedents are cells referenced by the formula in a cell.
let range = context.workbook.getActiveCell();
let precedents = range.getPrecedents();
range.load("address");
precedents.areas.load("address");
await context.sync();
console.log(`All precedent cells of ${range.address}:`);
// Use the precedents API to loop through precedents of the active cell.
for (let i = 0; i < precedents.areas.items.length; i++) {
// Highlight and console the address of each precedent cell.
precedents.areas.items[i].format.fill.color = "Orange";
console.log(` ${precedents.areas.items[i].address}`);
}
await context.sync();
});
getRangeEdge(direction, activeCell)
Retorna um objeto range que é a célula de borda da região de dados que corresponde à direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Arrow no Excel na interface do usuário do Windows.
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
Parâmetros
- direction
- Excel.KeyboardDirection
A direção da célula ativa.
- activeCell
-
Excel.Range | string
A célula ativa nesse intervalo. Por padrão, a célula ativa é a célula superior esquerda do intervalo. Um erro será gerado se a célula ativa não estiver nesse intervalo.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.13 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-get-range-edge.yaml
await Excel.run(async (context) => {
// Get the selected range.
const range = context.workbook.getSelectedRange();
// Specify the direction with the `KeyboardDirection` enum.
const direction = Excel.KeyboardDirection.up;
// Get the active cell in the workbook.
const activeCell = context.workbook.getActiveCell();
// Get the top-most cell of the current used range.
// This method acts like the Ctrl+Arrow key keyboard shortcut while a range is selected.
const rangeEdge = range.getRangeEdge(
direction,
activeCell // If the selected range contains more than one cell, the active cell must be defined.
);
rangeEdge.select();
await context.sync();
});
getRangeEdge(directionString, activeCell)
Retorna um objeto range que é a célula de borda da região de dados que corresponde à direção fornecida. Isso corresponde ao comportamento da chave Ctrl+Arrow no Excel na interface do usuário do Windows.
getRangeEdge(directionString: "Left" | "Right" | "Up" | "Down", activeCell?: Range | string): Excel.Range;
Parâmetros
- directionString
-
"Left" | "Right" | "Up" | "Down"
A direção da célula ativa.
- activeCell
-
Excel.Range | string
A célula ativa nesse intervalo. Por padrão, a célula ativa é a célula superior esquerda do intervalo. Um erro será gerado se a célula ativa não estiver nesse intervalo.
Retornos
Comentários
getResizedRange(deltaRows, deltaColumns)
Obtém um Range
objeto semelhante ao objeto atual Range
, mas com seu canto inferior direito expandido (ou contraído) por algumas linhas e colunas.
getResizedRange(deltaRows: number, deltaColumns: number): Excel.Range;
Parâmetros
- deltaRows
-
number
O número de linhas pelo qual expandir o canto inferior direito, referente ao intervalo atual. Use um número positivo para expandir o intervalo ou um número negativo para diminuí-lo.
- deltaColumns
-
number
O número de colunas pelas quais expandir o canto inferior direito, em relação ao intervalo atual. Use um número positivo para expandir o intervalo ou um número negativo para diminuí-lo.
Retornos
Comentários
getRow(row)
Obtém uma linha contida no intervalo.
getRow(row: number): Excel.Range;
Parâmetros
- row
-
number
O número da linha do intervalo a ser recuperado. Indexados com zero.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress).getRow(1);
range.load('address');
await context.sync();
console.log(range.address); // prints Sheet1!A2:F2
});
getRowProperties(rowPropertiesLoadOptions)
Retorna uma única matriz dimensional encapsulando os dados de fonte, preenchimento, bordas, alinhamento e outras propriedades de cada célula. Para propriedades que não são consistentes em cada célula dentro de uma determinada linha, null
será retornado.
getRowProperties(rowPropertiesLoadOptions: RowPropertiesLoadOptions): OfficeExtension.ClientResult<RowProperties[]>;
Parâmetros
- rowPropertiesLoadOptions
- Excel.RowPropertiesLoadOptions
Um objeto que representa quais propriedades de linha carregar.
Retornos
Uma matriz em que cada item representa as propriedades solicitadas da linha correspondente.
Comentários
getRowsAbove(count)
Obtém um determinado número de linhas acima do objeto atual Range
.
getRowsAbove(count?: number): Excel.Range;
Parâmetros
- count
-
number
Opcional. O número de linhas a serem incluídas no intervalo resultante. Em geral, use um número positivo para criar um intervalo fora do intervalo atual. Você também pode usar um número negativo para criar um intervalo dentro do intervalo atual. O valor padrão é 1.
Retornos
Comentários
getRowsBelow(count)
Obtém um determinado número de linhas abaixo do objeto atual Range
.
getRowsBelow(count?: number): Excel.Range;
Parâmetros
- count
-
number
Opcional. O número de linhas a serem incluídas no intervalo resultante. Em geral, use um número positivo para criar um intervalo fora do intervalo atual. Você também pode usar um número negativo para criar um intervalo dentro do intervalo atual. O valor padrão é 1.
Retornos
Comentários
getSpecialCells(cellType, cellValueType)
Obtém o RangeAreas
objeto, que compreende um ou mais intervalos retangulares, que representa todas as células que correspondem ao tipo e valor especificados. Se nenhuma célula especial for encontrada, um ItemNotFound
erro será gerado.
getSpecialCells(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;
Parâmetros
- cellType
- Excel.SpecialCellType
O tipo de células a serem incluídas.
- cellValueType
- Excel.SpecialCellValueType
Se cellType
for constants
ou formulas
, esse argumento será usado para determinar quais tipos de células incluir no resultado. Esses valores podem ser combinados para retornar mais de um tipo. O padrão é selecionar todas as constantes ou as fórmulas, independente do tipo.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-areas.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
const usedRange = sheet.getUsedRange();
// Find the ranges with either text or logical (boolean) values.
const formulaRanges = usedRange.getSpecialCells("Constants", "LogicalText");
formulaRanges.format.fill.color = "orange";
return context.sync();
});
getSpecialCells(cellTypeString, cellValueTypeString)
Obtém o RangeAreas
objeto, que compreende um ou mais intervalos retangulares, que representa todas as células que correspondem ao tipo e valor especificados. Se nenhuma célula especial for encontrada, um ItemNotFound
erro será gerado.
getSpecialCells(cellTypeString: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueTypeString?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;
Parâmetros
- cellTypeString
-
"ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"
O tipo de células a serem incluídas.
- cellValueTypeString
-
"All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"
Se cellType
for constants
ou formulas
, esse argumento será usado para determinar quais tipos de células incluir no resultado. Esses valores podem ser combinados para retornar mais de um tipo. O padrão é selecionar todas as constantes ou as fórmulas, independente do tipo.
Retornos
Comentários
getSpecialCellsOrNullObject(cellType, cellValueType)
Obtém o RangeAreas
objeto, composto por um ou mais intervalos, que representa todas as células que correspondem ao tipo e valor especificados. Se nenhuma célula especial for encontrada, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;
Parâmetros
- cellType
- Excel.SpecialCellType
O tipo de células a serem incluídas.
- cellValueType
- Excel.SpecialCellValueType
Se cellType
for constants
ou formulas
, esse argumento será usado para determinar quais tipos de células incluir no resultado. Esses valores podem ser combinados para retornar mais de um tipo. O padrão é selecionar todas as constantes ou as fórmulas, independente do tipo.
Retornos
Comentários
getSpecialCellsOrNullObject(cellTypeString, cellValueTypeString)
Obtém o RangeAreas
objeto, composto por um ou mais intervalos, que representa todas as células que correspondem ao tipo e valor especificados. Se nenhuma célula especial for encontrada, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getSpecialCellsOrNullObject(cellTypeString: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueTypeString?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;
Parâmetros
- cellTypeString
-
"ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"
O tipo de células a serem incluídas.
- cellValueTypeString
-
"All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"
Se cellType
for constants
ou formulas
, esse argumento será usado para determinar quais tipos de células incluir no resultado. Esses valores podem ser combinados para retornar mais de um tipo. O padrão é selecionar todas as constantes ou as fórmulas, independente do tipo.
Retornos
Comentários
getSpillingToRange()
Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora. Falha se aplicado a um intervalo com mais de uma célula.
getSpillingToRange(): Excel.Range;
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.12 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/dynamic-arrays.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Set G4 to a formula that returns a dynamic array.
const targetCell = sheet.getRange("G4");
targetCell.formulas = [["=A4:D4"]];
// Get the address of the cells that the dynamic array spilled into.
const spillRange = targetCell.getSpillingToRange();
spillRange.load("address");
// Fit the columns for readability.
sheet.getUsedRange().format.autofitColumns();
await context.sync();
console.log(`Copying the table headers spilled into ${spillRange.address}.`);
});
getSpillingToRangeOrNullObject()
Obtém objeto range que contém o intervalo de despejo quando chamado em uma célula âncora. Se o intervalo não for uma célula de âncora ou o intervalo de derramamento não puder ser encontrado, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getSpillingToRangeOrNullObject(): Excel.Range;
Retornos
Comentários
getSpillParent()
Obtém o objeto range que contém a célula âncora para uma célula que recebe o despejo. Falha se aplicado a um intervalo com mais de uma célula.
getSpillParent(): Excel.Range;
Retornos
Comentários
getSpillParentOrNullObject()
Obtém o objeto range que contém a célula âncora para a célula que está sendo derramada. Se não for uma célula derramada ou mais de uma célula for fornecida, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getSpillParentOrNullObject(): Excel.Range;
Retornos
Comentários
getSurroundingRegion()
Retorna um Range
objeto que representa a região circundante para a célula superior esquerda nesse intervalo. Uma região ao redor é um intervalo limitado por qualquer combinação de linhas e colunas em branco em relação a esse intervalo.
getSurroundingRegion(): Excel.Range;
Retornos
Comentários
getTables(fullyContained)
Obtém uma coleção de tabelas com escopo que se sobrepõe ao intervalo.
getTables(fullyContained?: boolean): Excel.TableScopedCollection;
Parâmetros
- fullyContained
-
boolean
Se true
, retornará apenas tabelas totalmente contidas nos limites de intervalo. O valor padrão é false
.
Retornos
Comentários
getUsedRange(valuesOnly)
Retorna o intervalo usado do objeto de intervalo determinado. Se não houver células usadas no intervalo, essa função gerará um ItemNotFound
erro.
getUsedRange(valuesOnly?: boolean): Excel.Range;
Parâmetros
- valuesOnly
-
boolean
Considera apenas as células com valores como células usadas. [Conjunto de API: ExcelApi 1.2]
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-relationships.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const salesTable = sheet.tables.getItem("SalesTable");
const dataRange = salesTable.getDataBodyRange();
// We want the most recent quarter that has data, so
// exclude quarters without data and get the last of
// the remaining columns.
const usedDataRange = dataRange.getUsedRange(true /* valuesOnly */);
const currentQuarterRange = usedDataRange.getLastColumn();
// Asian and European teams have separate contests.
const asianSalesRange = sheet.getRange("A2:E4");
const europeanSalesRange = sheet.getRange("A5:E7");
// The data for each chart is the intersection of the
// current quarter column and the rows for the continent.
const asianContestRange = asianSalesRange.getIntersectionOrNullObject(currentQuarterRange);
const europeanContestRange = europeanSalesRange.getIntersectionOrNullObject(currentQuarterRange);
// Must sync before you can test the output of *OrNullObject
// method/property.
await context.sync();
if (asianContestRange.isNullObject) {
// See the declaration of this function for how to
// test this code path.
reportMissingData("Asian");
} else {
createContinentChart(
sheet,
"Asian",
asianContestRange,
"A9",
"F24"
);
}
if (europeanContestRange.isNullObject) {
// See the declaration of this function for how to
// test this code path.
reportMissingData("European");
} else {
createContinentChart(
sheet,
"European",
europeanContestRange,
"A25",
"F40"
);
}
await context.sync();
});
getUsedRangeOrNullObject(valuesOnly)
Retorna o intervalo usado do objeto de intervalo determinado. Se não houver células usadas no intervalo, esse método retornará um objeto com sua isNullObject
propriedade definida como true
. Para obter mais informações, consulte *Métodos e propriedades orNullObject.
getUsedRangeOrNullObject(valuesOnly?: boolean): Excel.Range;
Parâmetros
- valuesOnly
-
boolean
Considera apenas as células com valores como células usadas.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.4 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/used-range.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const salesTable = sheet.tables.getItem("SalesTable");
const dataRange = salesTable.getDataBodyRange();
// Pass true so only cells with values count as used
const usedDataRange = dataRange.getUsedRangeOrNullObject(
true /* valuesOnly */
);
//Must sync before reading value returned from *OrNullObject method/property.
await context.sync();
if (usedDataRange.isNullObject) {
console.log("Need Data to Make Chart");
console.log("To create a meaningful chart, press 'Fill the table' (or add names to the Product column and numbers to some of the other cells). Then press 'Try to create chart' again.");
} else {
const chart = sheet.charts.add(
Excel.ChartType.columnClustered,
dataRange,
"Columns"
);
chart.setPosition("A15", "F30");
chart.title.text = "Quarterly sales chart";
chart.legend.position = "Right";
chart.legend.format.fill.setSolidColor("white");
chart.dataLabels.format.font.size = 15;
chart.dataLabels.format.font.color = "black";
}
await context.sync();
});
getVisibleView()
Representa as linhas visíveis do intervalo atual.
getVisibleView(): Excel.RangeView;
Retornos
Comentários
group(groupOption)
Agrupa colunas e linhas para um esboço.
group(groupOption: Excel.GroupOption): void;
Parâmetros
- groupOption
- Excel.GroupOption
Especifica como o intervalo pode ser agrupado por linhas ou colunas. Um InvalidArgument
erro é gerado quando a opção de grupo difere da propriedade ou isEntireColumn
do isEntireRow
intervalo (ou seja, range.isEntireRow
é true e groupOption
é "ByColumns" ou range.isEntireColumn
é true e groupOption
é "ByRows").
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.10 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/outline.yaml
Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
// Group the larger, main level. Note that the outline controls
// will be on row 10, meaning 4-9 will collapse and expand.
sheet.getRange("4:9").group(Excel.GroupOption.byRows);
// Group the smaller, sublevels. Note that the outline controls
// will be on rows 6 and 9, meaning 4-5 and 7-8 will collapse and expand.
sheet.getRange("4:5").group(Excel.GroupOption.byRows);
sheet.getRange("7:8").group(Excel.GroupOption.byRows);
await context.sync();
});
group(groupOptionString)
Agrupa colunas e linhas para um esboço.
group(groupOptionString: "ByRows" | "ByColumns"): void;
Parâmetros
- groupOptionString
-
"ByRows" | "ByColumns"
Especifica como o intervalo pode ser agrupado por linhas ou colunas. Um InvalidArgument
erro é gerado quando a opção de grupo difere da propriedade ou isEntireColumn
do isEntireRow
intervalo (ou seja, range.isEntireRow
é true e groupOption
é "ByColumns" ou range.isEntireColumn
é true e groupOption
é "ByRows").
Retornos
void
Comentários
hideGroupDetails(groupOption)
Oculta os detalhes da linha ou do grupo de colunas.
hideGroupDetails(groupOption: Excel.GroupOption): void;
Parâmetros
- groupOption
- Excel.GroupOption
Especifica se deve ocultar os detalhes de linhas agrupadas ou colunas agrupadas.
Retornos
void
Comentários
hideGroupDetails(groupOptionString)
Oculta os detalhes da linha ou do grupo de colunas.
hideGroupDetails(groupOptionString: "ByRows" | "ByColumns"): void;
Parâmetros
- groupOptionString
-
"ByRows" | "ByColumns"
Especifica se deve ocultar os detalhes de linhas agrupadas ou colunas agrupadas.
Retornos
void
Comentários
insert(shift)
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. Retorna um novo Range
objeto no espaço agora em branco.
insert(shift: Excel.InsertShiftDirection): Excel.Range;
Parâmetros
Especifica como deslocar as células. Confira Excel.InsertShiftDirection
detalhes.
Retornos
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "F5:F10";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.insert(Excel.InsertShiftDirection.down);
await context.sync();
});
insert(shiftString)
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. Retorna um novo Range
objeto no espaço agora em branco.
insert(shiftString: "Down" | "Right"): Excel.Range;
Parâmetros
- shiftString
-
"Down" | "Right"
Especifica como deslocar as células. Confira Excel.InsertShiftDirection
detalhes.
Retornos
Comentários
load(options)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync()
antes de ler as propriedades.
load(options?: Excel.Interfaces.RangeLoadOptions): Excel.Range;
Parâmetros
Fornece opções para quais propriedades do objeto carregar.
Retornos
load(propertyNames)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync()
antes de ler as propriedades.
load(propertyNames?: string | string[]): Excel.Range;
Parâmetros
- propertyNames
-
string | string[]
Uma cadeia de caracteres delimitada por vírgulas ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.
Retornos
Exemplos
// Use the range address to get the range object.
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:F8";
const worksheet = context.workbook.worksheets.getItem(sheetName);
const range = worksheet.getRange(rangeAddress);
range.load('cellCount');
await context.sync();
console.log(range.cellCount);
});
load(propertyNamesAndPaths)
Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync()
antes de ler as propriedades.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.Range;
Parâmetros
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select
é uma cadeia de caracteres delimitada por vírgulas que especifica as propriedades a serem carregadas e propertyNamesAndPaths.expand
é uma cadeia de caracteres delimitada por vírgulas que especifica as propriedades de navegação a serem carregadas.
Retornos
merge(across)
Mescla as células do intervalo em uma região da planilha.
merge(across?: boolean): void;
Parâmetros
- across
-
boolean
Opcional. Defina true
como mesclar células em cada linha do intervalo especificado como células mescladas separadas. O valor padrão é false
.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.2 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:C3";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.merge(true);
await context.sync();
});
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-merged-ranges.yaml
await Excel.run(async (context) => {
// Retrieve the worksheet and the table in that worksheet.
const sheet = context.workbook.worksheets.getActiveWorksheet();
const tableRange = sheet.getRange("B2:E6");
// Create a merged range in the first row of the table.
const chartTitle = tableRange.getRow(0);
chartTitle.merge(true);
// Format the merged range.
chartTitle.format.horizontalAlignment = "Center";
await context.sync();
});
moveTo(destinationRange)
Move valores de célula, formatação e fórmulas do intervalo atual para o intervalo de destino, substituindo as informações antigas nessas células. O intervalo de destino será expandido automaticamente se for menor que o intervalo atual. As células no intervalo de destino que estão fora da área do intervalo original não são alteradas.
moveTo(destinationRange: Range | string): void;
Parâmetros
- destinationRange
-
Excel.Range | string
destinationRange Especifica o intervalo para onde as informações nesse intervalo serão movidas.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.11 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-copyfrom.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
// Place a label in front of the moved data.
sheet.getRange("F12").values = [["Moved Range:"]];
// Move the range from A1:E1 to G12:K12.
sheet.getRange("A1:E1").moveTo("G12");
await context.sync();
});
removeDuplicates(columns, includesHeader)
Remove valores duplicados do intervalo especificado pelas colunas.
removeDuplicates(columns: number[], includesHeader: boolean): Excel.RemoveDuplicatesResult;
Parâmetros
- columns
-
number[]
As colunas dentro do intervalo que podem conter duplicatas. Pelo menos uma coluna precisa ser especificada. Indexados com zero.
- includesHeader
-
boolean
True se os dados de entrada contiverem cabeçalho. O padrão é false.
Retornos
O objeto resultante que contém o número de linhas removidas e o número de linhas exclusivas restantes.
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-remove-duplicates.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const range = sheet.getRange("B2:D11");
const deleteResult = range.removeDuplicates([0],true);
deleteResult.load();
await context.sync();
console.log(deleteResult.removed + " entries with duplicate names removed.");
console.log(deleteResult.uniqueRemaining + " entries with unique names remain in the range.");
});
replaceAll(text, replacement, criteria)
Localiza e substitui a cadeia de caracteres fornecida com base nos critérios especificados no intervalo atual.
replaceAll(text: string, replacement: string, criteria: Excel.ReplaceCriteria): OfficeExtension.ClientResult<number>;
Parâmetros
- text
-
string
Cadeia de caracteres a ser encontrada.
- replacement
-
string
A cadeia de caracteres que substitui a cadeia de caracteres original.
- criteria
- Excel.ReplaceCriteria
Critérios de substituição adicionais.
Retornos
OfficeExtension.ClientResult<number>
O número de substituições executadas.
Comentários
select()
Seleciona o intervalo especificado na interface do usuário do Excel.
select(): void;
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.1 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "F5:F10";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.select();
await context.sync();
});
set(properties, options)
Define várias propriedades de um objeto ao mesmo tempo. Você pode passar um objeto simples com as propriedades apropriadas ou outro objeto de API do mesmo tipo.
set(properties: Interfaces.RangeUpdateData, options?: OfficeExtension.UpdateOptions): void;
Parâmetros
- properties
- Excel.Interfaces.RangeUpdateData
Um objeto JavaScript com propriedades estruturadas isomorficamente para as propriedades do objeto no qual o método é chamado.
- options
- OfficeExtension.UpdateOptions
Fornece uma opção para suprimir erros se o objeto properties tentar definir quaisquer propriedades somente leitura.
Retornos
void
set(properties)
Define várias propriedades no objeto ao mesmo tempo, com base em um objeto carregado existente.
set(properties: Excel.Range): void;
Parâmetros
- properties
- Excel.Range
Retornos
void
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/90-scenarios/multiple-property-set.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
const sourceRange = sheet.getRange("B2:E2");
sourceRange.load("format/fill/color, format/font/name, format/font/color");
await context.sync();
// Set properties based on the loaded and synced
// source range.
const targetRange = sheet.getRange("B7:E7");
targetRange.set(sourceRange);
targetRange.format.autofitColumns();
await context.sync();
});
setCellProperties(cellPropertiesData)
Atualizações o intervalo com base em uma matriz 2D de propriedades de célula, encapsulando coisas como fonte, preenchimento, bordas e alinhamento.
setCellProperties(cellPropertiesData: SettableCellProperties[][]): void;
Parâmetros
- cellPropertiesData
Uma matriz 2D que representa quais propriedades definir em cada célula.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/cell-properties.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
// Creating the SettableCellProperties objects to use for the range.
// In your add-in, these should be created once, outside the function.
const topHeaderProps: Excel.SettableCellProperties = {
// The style property takes a string matching the name of an Excel style.
// Built-in style names are listed in the `BuiltInStyle` enum.
// Note that a style will overwrite any formatting,
// so do not use the format property with the style property.
style: "Heading1"
};
const headerProps: Excel.SettableCellProperties = {
// Any subproperties of format that are not set will not be changed when these cell properties are set.
format: {
fill: {
color: "Blue"
},
font: {
color: "White",
bold: true
}
}
};
const nonApplicableProps: Excel.SettableCellProperties = {
format: {
fill: {
pattern: Excel.FillPattern.gray25
},
font: {
color: "Gray",
italic: true
}
}
};
const matchupScoreProps: Excel.SettableCellProperties = {
format: {
borders: {
bottom: {
style: Excel.BorderLineStyle.continuous
},
left: {
style: Excel.BorderLineStyle.continuous
},
right: {
style: Excel.BorderLineStyle.continuous
},
top: {
style: Excel.BorderLineStyle.continuous
}
}
}
};
const range = sheet.getRange("A1:E5");
// You can use empty JSON objects to avoid changing a cell's properties.
range.setCellProperties([
[topHeaderProps, {}, {}, {}, {}],
[{}, {}, headerProps, headerProps, headerProps],
[{}, headerProps, nonApplicableProps, matchupScoreProps, matchupScoreProps],
[{}, headerProps, matchupScoreProps, nonApplicableProps, matchupScoreProps],
[{}, headerProps, matchupScoreProps, matchupScoreProps, nonApplicableProps]
]);
sheet.getUsedRange().format.autofitColumns();
await context.sync();
});
setColumnProperties(columnPropertiesData)
Atualizações o intervalo com base em uma matriz unidimensional de propriedades de coluna, encapsulando coisas como fonte, preenchimento, bordas e alinhamento.
setColumnProperties(columnPropertiesData: SettableColumnProperties[]): void;
Parâmetros
- columnPropertiesData
Uma matriz que representa quais propriedades definir em cada coluna.
Retornos
void
Comentários
setDirty()
Define um intervalo a ser recalculado quando o próximo recálculo ocorrer.
setDirty(): void;
Retornos
void
Comentários
setRowProperties(rowPropertiesData)
Atualizações o intervalo com base em uma matriz unidimensional de propriedades de linha, encapsulando coisas como fonte, preenchimento, bordas e alinhamento.
setRowProperties(rowPropertiesData: SettableRowProperties[]): void;
Parâmetros
- rowPropertiesData
Uma matriz que representa quais propriedades definir em cada linha.
Retornos
void
Comentários
showCard()
Exibe o cartão para uma célula ativa se ele tiver um conteúdo valioso.
showCard(): void;
Retornos
void
Comentários
showGroupDetails(groupOption)
Mostra os detalhes da linha ou do grupo de colunas.
showGroupDetails(groupOption: Excel.GroupOption): void;
Parâmetros
- groupOption
- Excel.GroupOption
Especifica se deve mostrar os detalhes de linhas agrupadas ou colunas agrupadas.
Retornos
void
Comentários
showGroupDetails(groupOptionString)
Mostra os detalhes da linha ou do grupo de colunas.
showGroupDetails(groupOptionString: "ByRows" | "ByColumns"): void;
Parâmetros
- groupOptionString
-
"ByRows" | "ByColumns"
Especifica se deve mostrar os detalhes de linhas agrupadas ou colunas agrupadas.
Retornos
void
Comentários
toJSON()
Substitui o método JavaScript toJSON()
para fornecer uma saída mais útil quando um objeto de API é passado para JSON.stringify()
. (JSON.stringify
por sua vez, chama o toJSON
método do objeto que é passado para ele.) Enquanto o objeto Excel.Range original é um objeto API, o toJSON
método retorna um objeto JavaScript simples (digitado como Excel.Interfaces.RangeData
) que contém cópias rasas de quaisquer propriedades filho carregadas do objeto original.
toJSON(): Excel.Interfaces.RangeData;
Retornos
track()
Acompanha o objeto para ajuste automático com base nas alterações adjacentes no documento. Essa chamada é uma abreviação para context.trackedObjects.add(thisObject). Se você estiver usando esse objeto entre .sync
chamadas e fora da execução sequencial de um lote ".run" e receber um erro "InvalidObjectPath" ao definir uma propriedade ou invocar um método no objeto, você precisará adicionar o objeto à coleção de objetos rastreados quando o objeto foi criado pela primeira vez.
track(): Excel.Range;
Retornos
ungroup(groupOption)
Desagrupa colunas e linhas para um esboço.
ungroup(groupOption: Excel.GroupOption): void;
Parâmetros
- groupOption
- Excel.GroupOption
Especifica como o intervalo pode ser desagrupado por linhas ou colunas.
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.10 ]
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/outline.yaml
Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getActiveWorksheet();
// This removes two levels of groups from the "A1-R10" range.
// Any groups at the same level on the same dimension will be removed by a single call.
sheet.getRange("A1:R10").ungroup(Excel.GroupOption.byRows);
sheet.getRange("A1:R10").ungroup(Excel.GroupOption.byRows);
sheet.getRange("A1:R10").ungroup(Excel.GroupOption.byColumns);
sheet.getRange("A1:R10").ungroup(Excel.GroupOption.byColumns);
await context.sync();
});
ungroup(groupOptionString)
Desagrupa colunas e linhas para um esboço.
ungroup(groupOptionString: "ByRows" | "ByColumns"): void;
Parâmetros
- groupOptionString
-
"ByRows" | "ByColumns"
Especifica como o intervalo pode ser desagrupado por linhas ou colunas.
Retornos
void
Comentários
unmerge()
Desfaz a mesclagem das células do intervalo em células separadas.
unmerge(): void;
Retornos
void
Comentários
[ Conjunto de API: ExcelApi 1.2 ]
Exemplos
await Excel.run(async (context) => {
const sheetName = "Sheet1";
const rangeAddress = "A1:C3";
const range = context.workbook.worksheets.getItem(sheetName).getRange(rangeAddress);
range.unmerge();
await context.sync();
});
untrack()
Libere a memória associada a este objeto, se ele já tiver sido rastreado anteriormente. Essa chamada é abreviada para context.trackedObjects.remove(thisObject). Ter muitos objetos rastreados desacelera o aplicativo host, por isso, lembre-se de liberar todos os objetos adicionados após usá-los. Você precisará chamar context.sync()
antes que a versão da memória entre em vigor.
untrack(): Excel.Range;
Retornos
Exemplos
await Excel.run(async (context) => {
const largeRange = context.workbook.getSelectedRange();
largeRange.load(["rowCount", "columnCount"]);
await context.sync();
for (let i = 0; i < largeRange.rowCount; i++) {
for (let j = 0; j < largeRange.columnCount; j++) {
const cell = largeRange.getCell(i, j);
cell.values = [[i *j]];
// Call untrack() to release the range from memory.
cell.untrack();
}
}
await context.sync();
});
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de