Excel.Interfaces.RangeLoadOptions interface
El rango representa un conjunto de una o más celdas contiguas, como una celda, una fila, una columna o un bloque de celdas. Para obtener más información sobre cómo se usan los intervalos en toda la API, comience con Intervalos en la API de JavaScript de Excel.
Propiedades
| $all | Al especificar |
| address | Especifica el rango de referencia en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Hoja1! A1:B4"). |
| address |
Representa la referencia de rango para el rango especificado en el idioma del usuario. |
| cell |
Especifica el número de celdas del rango. Esta API devolverá -1 si el recuento de celdas supera 2^31-1 (2 147 483 647). |
| column |
Especifica el número total de columnas del rango. |
| column |
Representa si todas las columnas del rango actual están ocultas. El valor es |
| column |
Especifica el número de columna de la primera celda del rango. Indizado con cero. |
| format | Devuelve un objeto de formato que encapsula la fuente, el relleno, los bordes, la alineación y otras propiedades del rango. |
| formulas | Representa la fórmula en notación de estilo A1. Si una celda no tiene fórmula, se devuelve su valor en su lugar. |
| formulas |
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. Si una celda no tiene fórmula, se devuelve su valor en su lugar. |
| formulasR1C1 | Representa la fórmula en notación de estilo R1C1. Si una celda no tiene fórmula, se devuelve su valor en su lugar. |
| hidden | Representa si todas las celdas del rango actual están ocultas. El valor se produce |
| number |
Representa el código de formato de número de Excel para un rango determinado. Para obtener más información sobre el formato de número de Excel, vea códigos de formato de número. |
| row |
Devuelve el número total de filas del intervalo. |
| row |
Representa si todas las filas del rango actual están ocultas. El valor es |
| row |
Devuelve el número de fila de la primera celda del intervalo. Indizado con cero. |
| text | Valores de texto del intervalo especificado. El valor Text no dependerá del ancho de la celda. La sustitución de signos de número (#) que se produce en la interfaz de usuario de Excel no afectará al valor de texto devuelto por la API. |
| values | Representa los valores sin formato del rango especificado. Los datos devueltos pueden ser una cadena, un número o un valor booleano. Las celdas que contienen un error devolverán la cadena de error. Si el valor devuelto comienza con un signo más ("+"), menos ("-") o igual ("="), Excel interpretará este valor como una fórmula. Las cadenas con forma de configuración regional (como la fecha "19-8-2025" en nl-NL o fr-FR, formato DD-MM-AAAA) se almacenan como texto en lugar de como fechas. Para asegurarse de que las fechas se almacenan como fechas, use una API compatible con la configuración regional, como |
| value |
Especifica el tipo de datos de cada celda. |
| worksheet | Hoja de cálculo que contiene el rango actual. |
Detalles de las propiedades
$all
Al especificar $all las opciones de carga, se cargan todas las propiedades escalares (como Range.address) pero no las propiedades de navegación (como Range.format.fill.color).
$all?: boolean;Valor de propiedad
boolean
address
Especifica el rango de referencia en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Hoja1! A1:B4").
address?: boolean;Valor de propiedad
boolean
Comentarios
addressLocal
Representa la referencia de rango para el rango especificado en el idioma del usuario.
addressLocal?: boolean;Valor de propiedad
boolean
Comentarios
cellCount
Especifica el número de celdas del rango. Esta API devolverá -1 si el recuento de celdas supera 2^31-1 (2 147 483 647).
cellCount?: boolean;Valor de propiedad
boolean
Comentarios
columnCount
Especifica el número total de columnas del rango.
columnCount?: boolean;Valor de propiedad
boolean
Comentarios
columnHidden
Representa si todas las columnas del rango actual están ocultas. El valor es true cuando todas las columnas de un rango están ocultas. El valor es false cuando no hay columnas ocultas en el intervalo. El valor es null cuando algunas columnas de un rango están ocultas y otras columnas del mismo rango no están ocultas.
columnHidden?: boolean;Valor de propiedad
boolean
Comentarios
columnIndex
Especifica el número de columna de la primera celda del rango. Indizado con cero.
columnIndex?: boolean;Valor de propiedad
boolean
Comentarios
format
Devuelve un objeto de formato que encapsula la fuente, el relleno, los bordes, la alineación y otras propiedades del rango.
format?: Excel.Interfaces.RangeFormatLoadOptions;Valor de propiedad
Comentarios
formulas
Representa la fórmula en notación de estilo A1. Si una celda no tiene fórmula, se devuelve su valor en su lugar.
formulas?: boolean;Valor de propiedad
boolean
Comentarios
formulasLocal
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. Si una celda no tiene fórmula, se devuelve su valor en su lugar.
formulasLocal?: boolean;Valor de propiedad
boolean
Comentarios
formulasR1C1
Representa la fórmula en notación de estilo R1C1. Si una celda no tiene fórmula, se devuelve su valor en su lugar.
formulasR1C1?: boolean;Valor de propiedad
boolean
Comentarios
hidden
Representa si todas las celdas del rango actual están ocultas. El valor se produce true cuando todas las celdas de un rango están ocultas. El valor es false cuando no hay celdas ocultas en el rango. El valor se produce null cuando algunas celdas de un rango están ocultas y otras del mismo rango no están ocultas.
hidden?: boolean;Valor de propiedad
boolean
Comentarios
numberFormat
Representa el código de formato de número de Excel para un rango determinado. Para obtener más información sobre el formato de número de Excel, vea códigos de formato de número.
numberFormat?: boolean;Valor de propiedad
boolean
Comentarios
rowCount
Devuelve el número total de filas del intervalo.
rowCount?: boolean;Valor de propiedad
boolean
Comentarios
rowHidden
Representa si todas las filas del rango actual están ocultas. El valor es true cuando todas las filas de un rango están ocultas. El valor es false cuando no hay filas ocultas en el rango. El valor se produce null cuando algunas filas de un rango están ocultas y otras filas del mismo rango no están ocultas.
rowHidden?: boolean;Valor de propiedad
boolean
Comentarios
rowIndex
Devuelve el número de fila de la primera celda del intervalo. Indizado con cero.
rowIndex?: boolean;Valor de propiedad
boolean
Comentarios
text
Valores de texto del intervalo especificado. El valor Text no dependerá del ancho de la celda. La sustitución de signos de número (#) que se produce en la interfaz de usuario de Excel no afectará al valor de texto devuelto por la API.
text?: boolean;Valor de propiedad
boolean
Comentarios
values
Representa los valores sin formato del rango especificado. Los datos devueltos pueden ser una cadena, un número o un valor booleano. Las celdas que contienen un error devolverán la cadena de error. Si el valor devuelto comienza con un signo más ("+"), menos ("-") o igual ("="), Excel interpretará este valor como una fórmula. Las cadenas con forma de configuración regional (como la fecha "19-8-2025" en nl-NL o fr-FR, formato DD-MM-AAAA) se almacenan como texto en lugar de como fechas. Para asegurarse de que las fechas se almacenan como fechas, use una API compatible con la configuración regional, como formulasLocal o use un formato independiente de la configuración regional, como ISO (AAAAA-MM-DD) o una serie de fechas numéricas.
values?: boolean;Valor de propiedad
boolean
Comentarios
valueTypes
Especifica el tipo de datos de cada celda.
valueTypes?: boolean;Valor de propiedad
boolean
Comentarios
worksheet
Hoja de cálculo que contiene el rango actual.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;