tipo de recurso workbookRange
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.
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 | workbookRange | Lee las propiedades y relaciones del objeto range. |
Update | workbookRange | Actualiza el objeto Range. |
Boundingrect | workbookRange | 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 | workbookRange | 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. |
Columna | workbookRange | 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 | workbookRange | Obtiene un objeto que representa toda la columna del rango. |
Entirerow | workbookRange | Obtiene un objeto que representa toda la fila del intervalo. |
Intersection | workbookRange | 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 | workbookRange | 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 | workbookRange | 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 | workbookRange | 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 | workbookRange | 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 dependerá del ancho de celda. La sustitución de signos # que se produce en la interfaz de usuario de Excel no afectará al valor de texto devuelto por la API. Solo lectura. |
valueTypes | string | Representa el tipo de datos de cada celda. Valores posibles: Unknown , Empty , String , Integer , Double , Boolean , 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. |
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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de