Tipo de recurso Range

Espacio de nombres: microsoft.graph

Range representa un conjunto de una o más celdas contiguas, como una celda, una fila, una columna, un bloque de celdas, etc.

Métodos

Método Tipo de valor devuelto Descripción
Get Range Range Lee las propiedades y relaciones del objeto range.
Update Range Actualiza el objeto Range.
Boundingrect Range Obtiene el objeto de intervalo más pequeño que abarca los intervalos especificados. Por ejemplo, el valor GetBoundingRect de "B2:C5" y "D10:E15" es "B2:E16".
Cell Range Obtiene el objeto de intervalo que contiene la celda en función de los números de fila y columna. La celda puede estar fuera de los límites del intervalo principal, siempre y cuando permanezca dentro de la cuadrícula de la hoja de cálculo. La celda devuelta se ubica con respecto a la celda superior izquierda del rango.
Column Range Obtiene una columna contenida en el intervalo.
Columnsafter workbookRangeView Obtiene algunas columnas a la derecha del intervalo especificado.
Columnsbefore workbookRangeView Obtiene algunas columnas a la izquierda del intervalo especificado.
Entirecolumn Range Obtiene un objeto que representa toda la columna del rango.
Entirerow Range Obtiene un objeto que representa toda la fila del intervalo.
Intersection Range Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados.
Lastcell Range Obtiene la última celda del intervalo. Por ejemplo, la última celda de "B2:D5" es "D5".
Lastcolumn Range Obtiene la última columna del intervalo. Por ejemplo, la última columna de "B2:D5" es "D2:D5".
Lastrow Range Obtiene la última fila del intervalo. Por ejemplo, la última fila de "B2:D5" es "B5:D5".
Offsetrange Range Obtiene un objeto que representa un intervalo desplazado con respecto al intervalo especificado. La dimensión del intervalo devuelto coincide con este intervalo. Si el intervalo resultante se fuerza fuera de los límites de la cuadrícula de la hoja de cálculo, se producirá una excepción.
Row Range Obtiene una fila contenida en el intervalo.
Rowsabove workbookRangeView Obtiene algunas filas por encima de un intervalo determinado.
Rowsbelow workbookRangeView Obtiene algunas filas por debajo de un intervalo determinado.
Usedrange Range Devuelve el intervalo usado del objeto de rango especificado.
Clear None Borra valores de rango, formato, relleno, borde, etc.
Delete None Elimina las celdas asociadas al rango.
Insert Range Inserta una celda o un intervalo de celdas en la hoja de cálculo en lugar de este intervalo y desplaza las demás celdas para crear espacio. Devuelve un nuevo objeto Range en el espacio que queda en blanco.
Merge None Combina las celdas del intervalo en una región de la hoja de cálculo.
Resizedrange workbookRangeView Obtiene un objeto de rango similar al objeto actual, pero con su esquina inferior derecha expandida (o contraída) mediante un número de filas y columnas.
Unmerge None Separa las celdas del intervalo en celdas independientes.
Visibleview workbookRangeView Obtenga el rango visible desde un rango filtrado.

Propiedades

Propiedad Tipo Descripción
address string Representa la referencia de intervalo en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, Sheet1! A1:B4). Solo lectura.
addressLocal cadena Representa la referencia del intervalo especificado en el idioma del usuario. Solo lectura.
cellCount entero Número de celdas del intervalo. Solo lectura.
columnCount entero Representa el número total de columnas del intervalo. Solo lectura.
columnHidden boolean Representa si todas las columnas del rango actual están ocultas.
columnIndex entero Representa el número de columna de la primera celda del intervalo. Indizado con cero. Solo lectura.
formulas Json Representa la fórmula en notación de estilo A1.
formulasLocal Json Representa la fórmula en notación de estilo A1, en el idioma del usuario y en la configuración regional del formato numérico. Por ejemplo, la fórmula "=SUM(A1, 1.5)" en inglés se convertiría en "=SUMME(A1; 1,5)" en alemán.
formulasR1C1 Json Representa la fórmula en notación de estilo R1C1.
hidden boolean Representa si todas las celdas del rango actual están ocultas. Solo lectura.
numberFormat Json Representa el código de formato numérico de Excel para la celda especificada.
rowCount int Devuelve el número total de filas del intervalo. Solo lectura.
rowHidden boolean Representa si todas las filas del rango actual están ocultas.
rowIndex entero Devuelve el número de fila de la primera celda del intervalo. Indizado con cero. Solo lectura.
text Json Valores de texto del rango especificado. El valor text no depende del ancho de celda. La sustitución de signos # que se produce en la interfaz de usuario de Excel no afecta al valor de texto devuelto por la API. Solo lectura.
valueTypes Json Representa el tipo de datos de cada celda. Los valores posibles son: Unknown, Empty, String, Integer, Double, Boolean y Error. Solo lectura.
values Json Representa los valores sin formato del rango especificado. Los datos devueltos pueden ser de tipo cadena, número o booleano. La celda que contiene un error devuelve la cadena de error.

Relaciones

Relación Tipo Descripción
format WorkbookRangeFormat Devuelve un objeto de formato que encapsula la fuente, el relleno, los bordes, la alineación y otras propiedades del rango. Solo lectura.
sort WorkbookRangeSort Hoja de cálculo que contiene el rango actual. Solo lectura.
worksheet WorkbookWorksheet Hoja de cálculo que contiene el rango actual. Solo lectura.

Representación JSON

La siguiente representación JSON muestra el tipo de 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"
}