Tipo de recurso Range

Namespace: microsoft.graph

Range representa um conjunto de uma ou mais células contíguas, como uma célula, uma linha, uma coluna, um bloco de células, etc.

Métodos

Método	Tipo de retorno	Descrição
Get Range	Range	Leia as propriedades e relacionamentos do objeto de intervalo.
Update	Range	Atualize o objeto Range.
Boundingrect	Range	Obtém o menor objeto de intervalo que abrange os intervalos determinados. Por exemplo, GetBoundingRect de "B2:C5" e "D10:E15" é "B2:E16".
Cell	Range	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 do respectivo 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.
Column	Range	Obtém uma coluna incluída no intervalo.
Columnsafter	workbookRangeView	Obtém um determinado número de colunas à direita do intervalo especificado.
Columnsbefore	workbookRangeView	Obtém um determinado número de colunas à esquerda do intervalo especificado.
Entirecolumn	Range	Obtém um objeto que representa toda a coluna do intervalo.
Entirerow	Range	Obtém um objeto que representa toda a linha do intervalo.
Intersection	Range	Obtém o objeto de intervalo que representa a interseção retangular dos intervalos determinados.
Lastcell	Range	Obtém a última célula do intervalo. Por exemplo, a última célula de "B2:D5" é "D5".
Lastcolumn	Range	Obtém a última coluna do intervalo. Por exemplo, a última coluna de "B2:D5" é "D2:D5".
Lastrow	Range	Obtém a última linha do intervalo. Por exemplo, a última linha de "B2:D5" é "B5:D5".
Offsetrange	Range	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 é imposto para fora dos limites da grade da planilha, o sistema gera uma exceção.
Row	Range	Obtém uma linha contida no intervalo.
Rowsabove	workbookRangeView	Obtém um determinado número de linhas acima de um determinado intervalo.
Rowsbelow	workbookRangeView	Obtém um determinado número de linhas abaixo de um determinado intervalo.
Usedrange	Range	Retorna o intervalo usado do objeto de intervalo determinado.
Clear	Nenhum	Limpe valores de intervalo, formatação, preenchimento, bordas, etc.
Delete	Nenhum	Exclui as células associadas ao intervalo.
Insert	Range	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 objeto Range no espaço em branco atual.
Merge	Nenhum	Mescla as células do intervalo em uma região da planilha.
Resizedrange	workbookRangeView	Obtém um objeto range semelhante ao objeto range atual, mas com seu canto inferior direito expandido (ou recolhido) por um determinado número de linhas e colunas.
Unmerge	Nenhum	Desfaz a mesclagem das células do intervalo em células separadas.
Visibleview	workbookRangeView	Obtenha o intervalo visível de um intervalo filtrado.

Propriedades

Propriedade	Tipo	Descrição
address	cadeia de caracteres	Representa a referência do intervalo no estilo A1. O valor do endereço inclui a referência de planilha (por exemplo, Plan1!A1:B4). Somente leitura.
addressLocal	string	Representa a referência de intervalo para o intervalo especificado no idioma do usuário. Somente leitura.
cellCount	int	Número de células no intervalo. Somente leitura.
columnCount	int	Representa o número total de colunas no intervalo. Somente leitura.
columnHidden	booliano	Representa se todas as colunas do intervalo atual estão ocultas.
columnIndex	int	Representa o número de colunas da primeira célula no intervalo. Indexados com zero. Somente leitura.
fórmulas	Json	Representa a fórmula em notação A1.
formulasLocal	Json	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.
formulasR1C1	Json	Representa a fórmula em notação no estilo L1C1.
hidden	booliano	Representa se todas as células do intervalo atual estão ocultas. Somente leitura.
numberFormat	Json	Representa o código de formato de número do Excel para determinada célula.
rowCount	int	Retorna o número total de linhas no intervalo. Somente leitura.
rowHidden	booliano	Representa se todas as linhas do intervalo atual estão ocultas.
rowIndex	int	Representa o número de linhas da primeira célula no intervalo. Indexados com zero. Somente leitura.
texto	Json	Valores de texto do intervalo especificado. O valor de texto não depende da largura da célula. A substituição pelo sinal #, que ocorre na interface de usuário do Excel, não afeta o valor de texto retornado pela API. Somente leitura.
valueTypes	Json	Representa o tipo de dados de cada célula. Os valores possíveis são: Unknown, Empty, String, Integer, Double, Boolean e Error. Somente leitura.
values	Json	Representa os valores brutos do intervalo especificado. Os dados retornados podem ser dos tipos: cadeia de caracteres, número ou booliano. Células que contêm um erro retornarão a cadeia de caracteres de erro.

Relações

Relação	Tipo	Descrição
formato	WorkbookRangeFormat	Retorna um objeto de formato que encapsula a fonte, o preenchimento, as bordas, o alinhamento e outras propriedades do intervalo. Somente leitura.
sort	WorkbookRangeSort	A planilha que contém o intervalo atual. Somente leitura.
planilha	WorkbookWorksheet	A planilha que contém o intervalo atual. Somente leitura.

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "address": "string",
  "addressLocal": "string",
  "cellCount": 1024,
  "columnCount": 1024,
  "columnHidden": true,
  "columnIndex": 1024,
  "formulas": "json",
  "formulasLocal": "json",
  "formulasR1C1": "json",
  "hidden": true,
  "numberFormat": "json",
  "rowCount": 1024,
  "rowHidden": true,
  "rowIndex": 1024,
  "text": "json",
  "valueTypes": "string",
  "values": "json"
}