tipo de recurso workbookRange

Artigo
09/22/2023

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

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	workbookRange	Leia as propriedades e relacionamentos do objeto de intervalo.
Update	workbookRange	Atualize o objeto Range.
Boundingrect	workbookRange	Obtém o menor objeto de intervalo que abrange os intervalos determinados. Por exemplo, GetBoundingRect de "B2:C5" e "D10:E15" é "B2:E16".
Cell	workbookRange	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.
Coluna	workbookRange	Obtém uma coluna incluída no intervalo.
Columnsafter	workbookRangeView	Obtém algumas colunas à direita do intervalo determinado.
Columnsbefore	workbookRangeView	Obtém algumas colunas à esquerda do intervalo determinado.
Entirecolumn	workbookRange	Obtém um objeto que representa toda a coluna do intervalo.
Entirerow	workbookRange	Obtém um objeto que representa toda a linha do intervalo.
Intersection	workbookRange	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	workbookRange	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	workbookRange	Obtém um objeto que representa um intervalo deslocado do intervalo especificado. A dimensão do intervalo retornado corresponde a esse intervalo. Quando o intervalo resultante é imposto 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 algumas linhas acima de um determinado intervalo.
Rowsbelow	workbookRangeView	Obtém algumas linhas abaixo de um determinado intervalo.
Usedrange	workbookRange	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	workbookRange	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 contém a referência Sheet (por exemplo, Sheet1! 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.
formulas	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.
text	Json	Valores de texto do intervalo especificado. O valor text não dependerá da largura da célula. A substituição # sign que acontece na interface do usuário do Excel não afetará o valor de texto retornado pela API. Somente leitura.
valueTypes	string	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. A célula que contém um erro retorna 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

A representação JSON a seguir mostra o tipo de recurso.

{
  "id": "string",
  "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"
}