Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representa un conjunto de una o más celdas contiguas en un libro, como una celda, una fila, una columna o un bloque de celdas.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Get | workbookRange | Lea las propiedades y relaciones de un objeto de rango. |
| Actualizar | workbookRange | Actualizar un objeto de rango. |
| Delete | Ninguno | Elimine las celdas asociadas al rango. |
| Clear | None | Borrar valores de rango, formato, relleno o borde. |
| Get boundingrect | workbookRange | Obtenga el objeto de rango más pequeño que abarque los rangos dados. Por ejemplo, el valor GetBoundingRect de "B2:C5" y "D10:E15" es "B2:E16". |
| Obtener celda | workbookRange | Obtenga el objeto de rango que contiene la celda única en función de los números de fila y columna. La celda puede estar fuera de los límites de su rango primario siempre que 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 intervalo. |
| Obtener columna | workbookRange | Obtener una columna incluida en el intervalo. |
| Obtener columnas después de | workbookRangeView | Colocar algunas columnas a la derecha del intervalo especificado. |
| Obtener columnas antes | workbookRangeView | Colocar algunas columnas a la izquierda del rango especificado. |
| Obtener la columna completa | workbookRange | Obtener un objeto que represente toda la columna del rango. |
| Obtener toda la fila | workbookRange | Obtener un objeto que represente toda la fila del rango. |
| Obtener intersección | workbookRange | Obtiene el objeto de rango que representa la intersección rectangular de los rangos dados. |
| Obtener última celda | workbookRange | Obtiene la última celda del rango. Por ejemplo, la última celda de "B2:D5" es "D5". |
| Obtener última columna | workbookRange | Obtener la última columna del intervalo. Por ejemplo, la última columna de "B2:D5" es "D2:D5". |
| Obtener última fila | workbookRange | Obtiene la última fila del intervalo. Por ejemplo, la última fila de "B2:D5" es "B5:D5". |
| Obtener intervalo de desplazamiento | workbookRange | Obtener un objeto que represente un rango que se desplaza con respecto al rango 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. |
| Obtener rango redimensionado | workbookRangeView | Obtener un objeto de rango similar al objeto de rango actual, pero con su esquina inferior derecha expandida (o contraída) por un cierto número de filas y columnas. |
| Obtener fila | workbookRange | Obtener una fila contenida en el rango. |
| Obtener filas encima | workbookRangeView | Obtener algunas filas por encima de un rango determinado. |
| Obtener filas a continuación | workbookRangeView | Obtenga algunas filas por debajo de un intervalo determinado. |
| Obtener el rango usado | workbookRange | Devuelve el rango usado del objeto de rango dado. |
| Obtener vista visible | workbookRangeView | Obtenga el rango visible desde un rango filtrado. |
| Insertar rango | workbookRange | Inserte una celda o un rango de celdas en la hoja de cálculo en lugar de este rango y desplaza las otras 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. |
| Unmerge | None | Separa las celdas del intervalo en celdas independientes. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| address | string | Representa la referencia de intervalo en estilo A1. El valor Dirección contiene la referencia de hoja (por ejemplo, Hoja1! 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 | Booleano | Indica 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 | Booleano | 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 | Booleano | Indica 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 de texto no depende del ancho de celda. La sustitución con el signo # que se produce en la interfaz de usuario de Excel no afecta al valor de texto devuelto por la API. Solo lectura. |
| valueTypes | string | 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 un valor 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. |
| hoja de cálculo | 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.
{
"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"
}