Compartir a través de

Excel.Interfaces.RangeCollectionLoadOptions interface

  • Referencia
Paquete:
excel

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Propiedades

$all

Si se $all especifica para LoadOptions, se cargan todas las propiedades escalares (por ejemplo, Range.address) pero no las propiedades de navegación (por ejemplo, Range.format.fill.color).
address

Para CADA ELEMENTO de la colección: especifica la referencia de intervalo en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Sheet1! A1:B4").
addressLocal

Para CADA ELEMENTO de la colección: representa la referencia de intervalo para el intervalo especificado en el idioma del usuario.
cellCount

Para CADA ELEMENTO de la colección: 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).
columnCount

Para CADA ELEMENTO de la colección: especifica el número total de columnas del intervalo.
columnHidden

Para CADA ELEMENTO de la colección: representa si todas las columnas del intervalo actual están ocultas. El valor es true cuando todas las columnas de un intervalo están ocultas. El valor es false cuando no se oculta ninguna columna del intervalo. El valor es null cuando algunas columnas de un rango están ocultas y otras columnas del mismo rango no están ocultas.
columnIndex

Para CADA ELEMENTO de la colección: especifica el número de columna de la primera celda del rango. Indizado con cero.
control

Para CADA ELEMENTO de la colección: obtiene acceso al control de celda aplicado a este rango. Si el rango tiene varios controles de celda, devuelve EmptyCellControl.
dataValidation

Para CADA ELEMENTO de la colección: devuelve un objeto de validación de datos.
format

Para CADA ELEMENTO de la colección: devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes, la alineación y otras propiedades del intervalo.
formulas

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo A1. Si una celda no tiene ninguna fórmula, su valor se devuelve en su lugar.
formulasLocal

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo A1, en la configuración regional de formato de número y idioma del usuario. 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 ninguna fórmula, su valor se devuelve en su lugar.
formulasR1C1

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo R1C1. Si una celda no tiene ninguna fórmula, su valor se devuelve en su lugar.
hasSpill

Para CADA ELEMENTO de la colección: representa si todas las celdas tienen un borde de desbordamiento. Devuelve true si todas las celdas tienen un borde de derrame o false si todas las celdas no tienen un borde de desbordamiento. Devuelve null si hay celdas con y sin bordes de desbordamiento dentro del intervalo.
height

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior del rango hasta el borde inferior del intervalo.
hidden

Para CADA ELEMENTO de la colección: representa si todas las celdas del rango actual están ocultas. El valor es true cuando todas las celdas de un rango están ocultas. El valor es false cuando no se oculta ninguna celda del rango. El valor es null cuando algunas celdas de un rango están ocultas y otras celdas del mismo rango no están ocultas.
hyperlink

Para CADA ELEMENTO de la colección: representa el hipervínculo del intervalo actual.
isEntireColumn

Para CADA ELEMENTO de la colección: representa si el intervalo actual es una columna completa.
isEntireRow

Para CADA ELEMENTO de la colección: representa si el intervalo actual es una fila completa.
left

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo de la hoja de cálculo hasta el borde izquierdo del rango.
linkedDataTypeState

Para CADA ELEMENTO de la colección: representa el estado del tipo de datos de cada celda.
numberFormat

Para CADA ELEMENTO de la colección: representa el código de formato de número de Excel para el intervalo especificado. Para obtener más información sobre el formato de números de Excel, vea Códigos de formato de número.
numberFormatCategories

Para CADA ELEMENTO de la colección: representa la categoría de formato numérico de cada celda.
numberFormatLocal

Para CADA ELEMENTO de la colección: representa el código de formato de número de Excel para el intervalo especificado, en función de la configuración de idioma del usuario. Excel no realiza ninguna coerción de idioma o formato al obtener o establecer la numberFormatLocal propiedad. Cualquier texto devuelto usa las cadenas con formato local en función del idioma especificado en la configuración del sistema.
rowCount

Para CADA ELEMENTO de la colección: devuelve el número total de filas del intervalo.
rowHidden

Para CADA ELEMENTO de la colección: representa si todas las filas del intervalo actual están ocultas. El valor es true cuando todas las filas de un intervalo están ocultas. El valor es false cuando no se oculta ninguna fila del intervalo. El valor es null cuando algunas filas de un rango están ocultas y otras filas del mismo rango no están ocultas.
rowIndex

Para CADA ELEMENTO de la colección: devuelve el número de fila de la primera celda del rango. Indizado con cero.
savedAsArray

Para CADA ELEMENTO de la colección: representa si todas las celdas se guardarían como una fórmula de matriz. Devuelve true si todas las celdas se guardarían como una fórmula de matriz o false si todas las celdas no se guardarían como una fórmula de matriz. Devuelve null si algunas celdas se guardarían como una fórmula de matriz y otras no lo serían.
style

Para CADA ELEMENTO de la colección: representa el estilo del intervalo actual. Si los estilos de las celdas son incoherentes, null se devolverán. En el caso de los estilos personalizados, se devolverá el nombre del estilo. Para los estilos integrados, se devolverá una cadena que representa un valor en la BuiltInStyle enumeración.
text

Para CADA ELEMENTO de la colección: valores de texto del intervalo especificado. El valor Text no dependerá del ancho de la celda. La sustitución del signo de número (#) que se produce en la interfaz de usuario de Excel no afectará al valor de texto devuelto por la API.
top

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior de la hoja de cálculo hasta el borde superior del rango.
values

Para CADA ELEMENTO de la colección: representa los valores sin procesar del intervalo especificado. Los datos devueltos podrían 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 un signo igual ("="), Excel interpreta este valor como una fórmula.
valuesAsJson

Para CADA ELEMENTO de la colección: representación JSON de los valores de las celdas de este rango. A diferencia de Range.values, Range.valuesAsJson admite todos los tipos de datos que pueden estar en una celda. Entre los ejemplos se incluyen valores de número con formato e imágenes web, además de los valores booleanos, numéricos y de cadena estándar. Los datos devueltos desde esta API siempre se alinean con la configuración regional en-US. Para recuperar datos en la configuración regional de visualización del usuario, use Range.valuesAsJsonLocal.
valuesAsJsonLocal

Para CADA ELEMENTO de la colección: representación JSON de los valores de las celdas de este rango. A diferencia de Range.values, Range.valuesAsJsonLocal admite todos los tipos de datos que pueden estar en una celda. Entre los ejemplos se incluyen valores de número con formato e imágenes web, además de los valores booleanos, numéricos y de cadena estándar. Los datos devueltos desde esta API siempre se alinean con la configuración regional de visualización del usuario. Para recuperar datos independientes de la configuración regional, use Range.valuesAsJson.
valueTypes

Para CADA ELEMENTO de la colección: especifica el tipo de datos de cada celda.
width

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo del intervalo hasta el borde derecho del intervalo.
worksheet

Para CADA ELEMENTO de la colección: la hoja de cálculo que contiene el rango actual.

Detalles de las propiedades

$all

Si se $all especifica para LoadOptions, se cargan todas las propiedades escalares (por ejemplo, Range.address) pero no las propiedades de navegación (por ejemplo, Range.format.fill.color).

$all?: boolean;

Valor de propiedad

boolean

address

Para CADA ELEMENTO de la colección: especifica la referencia de intervalo en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Sheet1! A1:B4").

address?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

addressLocal

Para CADA ELEMENTO de la colección: representa la referencia de intervalo para el intervalo especificado en el idioma del usuario.

addressLocal?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

cellCount

Para CADA ELEMENTO de la colección: 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

[ Conjunto de API: ExcelApi 1.1 ]

columnCount

Para CADA ELEMENTO de la colección: especifica el número total de columnas del intervalo.

columnCount?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

columnHidden

Para CADA ELEMENTO de la colección: representa si todas las columnas del intervalo actual están ocultas. El valor es true cuando todas las columnas de un intervalo están ocultas. El valor es false cuando no se oculta ninguna columna del 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

[ Conjunto de API: ExcelApi 1.2 ]

columnIndex

Para CADA ELEMENTO de la colección: especifica el número de columna de la primera celda del rango. Indizado con cero.

columnIndex?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

control

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

Para CADA ELEMENTO de la colección: obtiene acceso al control de celda aplicado a este rango. Si el rango tiene varios controles de celda, devuelve EmptyCellControl.

control?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi BETA (SOLO VERSIÓN PRELIMINAR) ]

dataValidation

Para CADA ELEMENTO de la colección: devuelve un objeto de validación de datos.

dataValidation?: Excel.Interfaces.DataValidationLoadOptions;

Valor de propiedad

Excel.Interfaces.DataValidationLoadOptions

Comentarios

[ Conjunto de API: ExcelApi 1.8 ]

format

Para CADA ELEMENTO de la colección: devuelve un objeto de formato, encapsulando la fuente, el relleno, los bordes, la alineación y otras propiedades del intervalo.

format?: Excel.Interfaces.RangeFormatLoadOptions;

Valor de propiedad

Excel.Interfaces.RangeFormatLoadOptions

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

formulas

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo A1. Si una celda no tiene ninguna fórmula, su valor se devuelve en su lugar.

formulas?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

formulasLocal

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo A1, en la configuración regional de formato de número y idioma del usuario. 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 ninguna fórmula, su valor se devuelve en su lugar.

formulasLocal?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

formulasR1C1

Para CADA ELEMENTO de la colección: representa la fórmula en la notación de estilo R1C1. Si una celda no tiene ninguna fórmula, su valor se devuelve en su lugar.

formulasR1C1?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

hasSpill

Para CADA ELEMENTO de la colección: representa si todas las celdas tienen un borde de desbordamiento. Devuelve true si todas las celdas tienen un borde de derrame o false si todas las celdas no tienen un borde de desbordamiento. Devuelve null si hay celdas con y sin bordes de desbordamiento dentro del intervalo.

hasSpill?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.12 ]

height

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior del rango hasta el borde inferior del intervalo.

height?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

hidden

Para CADA ELEMENTO de la colección: representa si todas las celdas del rango actual están ocultas. El valor es true cuando todas las celdas de un rango están ocultas. El valor es false cuando no se oculta ninguna celda del rango. El valor es null cuando algunas celdas de un rango están ocultas y otras celdas del mismo rango no están ocultas.

hidden?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.2 ]

Para CADA ELEMENTO de la colección: representa el hipervínculo del intervalo actual.

hyperlink?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

isEntireColumn

Para CADA ELEMENTO de la colección: representa si el intervalo actual es una columna completa.

isEntireColumn?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

isEntireRow

Para CADA ELEMENTO de la colección: representa si el intervalo actual es una fila completa.

isEntireRow?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

left

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo de la hoja de cálculo hasta el borde izquierdo del rango.

left?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

linkedDataTypeState

Para CADA ELEMENTO de la colección: representa el estado del tipo de datos de cada celda.

linkedDataTypeState?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

numberFormat

Para CADA ELEMENTO de la colección: representa el código de formato de número de Excel para el intervalo especificado. Para obtener más información sobre el formato de números de Excel, vea Códigos de formato de número.

numberFormat?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

numberFormatCategories

Para CADA ELEMENTO de la colección: representa la categoría de formato numérico de cada celda.

numberFormatCategories?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.12 ]

numberFormatLocal

Para CADA ELEMENTO de la colección: representa el código de formato de número de Excel para el intervalo especificado, en función de la configuración de idioma del usuario. Excel no realiza ninguna coerción de idioma o formato al obtener o establecer la numberFormatLocal propiedad. Cualquier texto devuelto usa las cadenas con formato local en función del idioma especificado en la configuración del sistema.

numberFormatLocal?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

rowCount

Para CADA ELEMENTO de la colección: devuelve el número total de filas del intervalo.

rowCount?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

rowHidden

Para CADA ELEMENTO de la colección: representa si todas las filas del intervalo actual están ocultas. El valor es true cuando todas las filas de un intervalo están ocultas. El valor es false cuando no se oculta ninguna fila del intervalo. El valor es 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

[ Conjunto de API: ExcelApi 1.2 ]

rowIndex

Para CADA ELEMENTO de la colección: devuelve el número de fila de la primera celda del rango. Indizado con cero.

rowIndex?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

savedAsArray

Para CADA ELEMENTO de la colección: representa si todas las celdas se guardarían como una fórmula de matriz. Devuelve true si todas las celdas se guardarían como una fórmula de matriz o false si todas las celdas no se guardarían como una fórmula de matriz. Devuelve null si algunas celdas se guardarían como una fórmula de matriz y otras no lo serían.

savedAsArray?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.12 ]

style

Para CADA ELEMENTO de la colección: representa el estilo del intervalo actual. Si los estilos de las celdas son incoherentes, null se devolverán. En el caso de los estilos personalizados, se devolverá el nombre del estilo. Para los estilos integrados, se devolverá una cadena que representa un valor en la BuiltInStyle enumeración.

style?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

text

Para CADA ELEMENTO de la colección: valores de texto del intervalo especificado. El valor Text no dependerá del ancho de la celda. La sustitución del signo 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

[ Conjunto de API: ExcelApi 1.1 ]

top

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior de la hoja de cálculo hasta el borde superior del rango.

top?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

values

Para CADA ELEMENTO de la colección: representa los valores sin procesar del intervalo especificado. Los datos devueltos podrían 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 un signo igual ("="), Excel interpreta este valor como una fórmula.

values?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

valuesAsJson

Para CADA ELEMENTO de la colección: representación JSON de los valores de las celdas de este rango. A diferencia de Range.values, Range.valuesAsJson admite todos los tipos de datos que pueden estar en una celda. Entre los ejemplos se incluyen valores de número con formato e imágenes web, además de los valores booleanos, numéricos y de cadena estándar. Los datos devueltos desde esta API siempre se alinean con la configuración regional en-US. Para recuperar datos en la configuración regional de visualización del usuario, use Range.valuesAsJsonLocal.

valuesAsJson?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.16 ]

valuesAsJsonLocal

Para CADA ELEMENTO de la colección: representación JSON de los valores de las celdas de este rango. A diferencia de Range.values, Range.valuesAsJsonLocal admite todos los tipos de datos que pueden estar en una celda. Entre los ejemplos se incluyen valores de número con formato e imágenes web, además de los valores booleanos, numéricos y de cadena estándar. Los datos devueltos desde esta API siempre se alinean con la configuración regional de visualización del usuario. Para recuperar datos independientes de la configuración regional, use Range.valuesAsJson.

valuesAsJsonLocal?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.16 ]

valueTypes

Para CADA ELEMENTO de la colección: especifica el tipo de datos de cada celda.

valueTypes?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]

width

Para CADA ELEMENTO de la colección: devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo del intervalo hasta el borde derecho del intervalo.

width?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: ExcelApi 1.10 ]

worksheet

Para CADA ELEMENTO de la colección: la hoja de cálculo que contiene el rango actual.

worksheet?: Excel.Interfaces.WorksheetLoadOptions;

Valor de propiedad

Excel.Interfaces.WorksheetLoadOptions

Comentarios

[ Conjunto de API: ExcelApi 1.1 ]