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 |
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. |
| 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 |
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
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
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
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;