Excel.Range class

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.

Comentarios

[Conjunto de API: ExcelApi 1.1]

Propiedades

address	Especifica el rango de referencia en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Hoja1! A1:B4").
addressLocal	Representa la referencia de rango para el rango especificado en el idioma del usuario.
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).
columnCount	Especifica el número total de columnas del rango.
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.
columnIndex	Especifica el número de columna de la primera celda del rango. Indizado con cero.
conditionalFormats	La colección de `ConditionalFormats` eso cruza la cordillera.
context	El contexto de solicitud asociado al objeto. De esta forma, se conecta el proceso del complemento con el proceso de la aplicación host de Office.
control	Accede al control de celda aplicado a este rango. Si el rango tiene varios controles de celda, devuelve `EmptyCellControl`.
dataValidation	Devuelve un objeto de validación de datos.
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.
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.
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.
hasSpill	Indica si todas las celdas tienen un borde de desbordamiento. Devuelve `true` si todas las celdas tienen un borde de desbordamiento o `false` si no lo tienen. Devuelve `null` si hay celdas con y sin bordes de desbordamiento dentro del rango.
height	Devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior del rango hasta el borde inferior del rango.
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.
hyperlink	Representa el hipervínculo del rango actual.
isEntireColumn	Representa si el intervalo actual es una columna completa.
isEntireRow	Representa si el intervalo actual es una fila completa.
left	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	Indica el estado del tipo de datos de cada celda.
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.
numberFormatCategories	Representa la categoría del formato de número de cada celda.
numberFormatLocal	Representa el código de formato de número de Excel para el rango especificado, en función de la configuración de idioma del usuario. Excel no ejerce ninguna coerción de idioma o formato al obtener o establecer la `numberFormatLocal` propiedad. Cualquier texto devuelto usa cadenas con formato local basadas en el idioma especificado en la configuración del sistema.
rowCount	Devuelve el número total de filas del intervalo.
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.
rowIndex	Devuelve el número de fila de la primera celda del intervalo. Indizado con cero.
savedAsArray	Representa si todas las celdas se guardarían como una fórmula de matriz. Devuelve `true` si todas las celdas se guardarían como fórmula de matriz o `false` si no se guardarían todas las celdas como fórmula de matriz. Devuelve `null` si algunas celdas se guardarían como una fórmula de matriz y otras no.
sort	Representa la ordenación del intervalo del intervalo actual.
style	Representa el estilo del rango actual. Si los estilos de las celdas son incoherentes, `null` se devolverá. Para los estilos personalizados, se devolverá el nombre del estilo. Para los estilos integrados, se devolverá una cadena que representa un valor de la `BuiltInStyle` enumeración.
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.
top	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	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.
valuesAsJson	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. Algunos ejemplos son los valores numéricos con formato y las imágenes web, además de los valores estándar booleanos, numéricos y de cadena. 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	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. Algunos ejemplos son los valores numéricos con formato y las imágenes web, además de los valores estándar booleanos, numéricos y de cadena. Los datos devueltos desde esta API siempre se alinean con la configuración regional de visualización del usuario. Para recuperar datos independientemente de la configuración regional, use `Range.valuesAsJson`.
valueTypes	Especifica el tipo de datos de cada celda.
width	Devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo del rango hasta el borde derecho del rango.
worksheet	Hoja de cálculo que contiene el rango actual.

Métodos

autoFill(destinationRange, autoFillType)	Rellena un rango desde el rango actual hasta el rango de destino utilizando la lógica de Autorrellenar especificada. El rango de destino puede ser `null` o puede extender el rango de origen horizontal o verticalmente. No se admiten intervalos discontinuos. Para obtener más información, consulte Uso de Autorrellenar y Relleno rápido.
autoFill(destinationRange, autoFillType)	Rellena un rango desde el rango actual hasta el rango de destino utilizando la lógica de Autorrellenar especificada. El rango de destino puede ser `null` o puede extender el rango de origen horizontal o verticalmente. No se admiten intervalos discontinuos. Para obtener más información, consulte Uso de Autorrellenar y Relleno rápido.
calculate()	Calcula un rango de celdas en una hoja de cálculo.
clear(applyTo)	Borrar valores de rango y formato, como relleno y borde.
clear(applyTo)	Borrar valores de rango y formato, como relleno y borde.
clearOrResetContents()	Borra los valores de las celdas del rango, prestando especial atención a las celdas que contienen controles. Si el rango contiene solo valores en blanco y los controles establecidos en su valor predeterminado, se quitan los valores y el formato de control. De lo contrario, se establecerán las celdas con controles en su valor predeterminado y se borrarán los valores de las demás celdas del rango.
convertDataTypeToText()	Convierte las celdas de rango con tipos de datos en texto.
convertToLinkedDataType(serviceID, languageCulture)	Convierte las celdas de rango en tipos de datos vinculados en la hoja de cálculo.
copyFrom(sourceRange, copyType, skipBlanks, transpose)	Copia los datos o el formato de celda del rango de origen o `RangeAreas` al rango actual. El rango de destino puede tener un tamaño diferente del rango de origen o `RangeAreas`. El destino se expande automáticamente si es más pequeño que el origen. Nota: Al igual que la funcionalidad de copia en la interfaz de usuario de Excel, si el rango de destino es un múltiplo exacto mayor que el rango de origen en filas o columnas, el contenido de origen se replica varias veces. Por ejemplo, una copia de un rango 2x2 en un rango de 2x6 dará como resultado 3 copias del rango de 2x2 original.
copyFrom(sourceRange, copyType, skipBlanks, transpose)	Copia los datos o el formato de celda del rango de origen o `RangeAreas` al rango actual. El rango de destino puede tener un tamaño diferente del rango de origen o `RangeAreas`. El destino se expande automáticamente si es más pequeño que el origen. Nota: Al igual que la funcionalidad de copia en la interfaz de usuario de Excel, si el rango de destino es un múltiplo exacto mayor que el rango de origen en filas o columnas, el contenido de origen se replica varias veces. Por ejemplo, una copia de un rango 2x2 en un rango de 2x6 dará como resultado 3 copias del rango de 2x2 original.
delete(shift)	Elimina las celdas asociadas al rango.
delete(shift)	Elimina las celdas asociadas al rango.
find(text, criteria)	Busca la cadena especificada, según los criterios especificados. Si el rango actual es mayor que una celda, la búsqueda se limitará a ese rango; de lo contrario, la búsqueda cubrirá toda la hoja a partir de esa celda.
findOrNullObject(text, criteria)	Busca la cadena especificada, según los criterios especificados. Si el rango actual es mayor que una celda, la búsqueda se limitará a ese rango; de lo contrario, la búsqueda cubrirá toda la hoja a partir de esa celda. Si no hay coincidencias, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
flashFill()	Rellena rápidamente el rango actual. Relleno rápido rellena automáticamente los datos cuando detecta un patrón, por lo que el rango debe ser un rango de una sola columna y tener datos a su alrededor para encontrar un patrón.
getAbsoluteResizedRange(numRows, numColumns)	Obtiene un `Range` objeto con la misma celda superior izquierda que el objeto actual `Range` , pero con el número especificado de filas y columnas.
getBoundingRect(anotherRange)	Obtiene el objeto de intervalo más pequeño que abarca los intervalos especificados. Por ejemplo, el `GetBoundingRect` valor de "B2:C5" y "D10:E15" es "B2:E15".
getCell(row, column)	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 de su rango primario siempre que se mantenga 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.
getCellProperties(cellPropertiesLoadOptions)	Devuelve una matriz 2D que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la celda.
getColumn(column)	Obtiene una columna contenida en el intervalo.
getColumnProperties(columnPropertiesLoadOptions)	Devuelve una matriz de una sola dimensión que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la columna. Se devolverá null para las propiedades que no son coherentes en cada celda de una columna determinada.
getColumnsAfter(count)	Obtiene un cierto número de columnas a la derecha del objeto actual `Range` .
getColumnsBefore(count)	Obtiene un cierto número de columnas a la izquierda del objeto actual `Range` .
getDependents()	Devuelve un `WorkbookRangeAreas` objeto que representa el rango que contiene todas las celdas dependientes de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. Genera un `ItemNotFound` error si no se encuentran dependientes.
getDirectDependents()	Devuelve un `WorkbookRangeAreas` objeto que representa el rango que contiene todas las celdas dependientes directas de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. Genera un `ItemNotFound` error si no se encuentran dependientes.
getDirectPrecedents()	Devuelve un `WorkbookRangeAreas` objeto que representa el rango que contiene todas las celdas de precedentes directos de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. Genera un `ItemNotFound` error si no se encuentran precedentes.
getDisplayedCellProperties(cellPropertiesLoadOptions)	Devuelve una matriz 2D que encapsula los datos de visualización de la fuente, el relleno, los bordes, la alineación y otras propiedades de cada celda. A diferencia `getCellProperties`de , que solo muestra las propiedades que se establecen directamente para la celda, devuelve las propiedades que se muestran desde orígenes indirectos, como el formato condicional o los estilos.
getEntireColumn()	Obtiene un objeto que representa toda la columna del rango (por ejemplo, si el rango actual representa las celdas "B4:E11", este `getEntireColumn` es un rango que representa las columnas "B:E").
getEntireRow()	Obtiene un objeto que representa toda la fila del rango (por ejemplo, si el rango actual representa las celdas "B4:E11", este `GetEntireRow` es un rango que representa las filas "4:11").
getExtendedRange(direction, activeCell)	Devuelve un objeto de rango que incluye el rango actual y hasta el borde del rango, en función de la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+Mayús+tecla de dirección en la interfaz de usuario de Excel en Windows.
getExtendedRange(direction, activeCell)	Devuelve un objeto de rango que incluye el rango actual y hasta el borde del rango, en función de la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+Mayús+tecla de dirección en la interfaz de usuario de Excel en Windows.
getImage()	Representa el rango como una imagen PNG codificada en Base64.
getIntersection(anotherRange)	Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados.
getIntersectionOrNullObject(anotherRange)	Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados. Si no se encuentra ninguna intersección, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getLastCell()	Obtiene la última celda del intervalo. Por ejemplo, la última celda de "B2:D5" es "D5".
getLastColumn()	Obtiene la última columna del intervalo. Por ejemplo, la última columna de "B2:D5" es "D2:D5".
getLastRow()	Obtiene la última fila del intervalo. Por ejemplo, la última fila de "B2:D5" es "B5:D5".
getMergedAreasOrNullObject()	Devuelve un `RangeAreas` objeto que representa las áreas combinadas de este intervalo. Tenga en cuenta que si el recuento de áreas combinadas en este intervalo es superior a 512, este método no devolverá el resultado. Si el `RangeAreas` objeto no existe, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getOffsetRange(rowOffset, columnOffset)	Obtiene un objeto que representa un intervalo desplazado con respecto al intervalo especificado. La dimensión del rango devuelto coincidirá con este rango. Si el rango resultante se fuerza más allá de los límites de la cuadrícula de la hoja de cálculo, se producirá un error.
getPivotTables(fullyContained)	Obtiene una colección con ámbito de tablas dinámicas que se superponen con el rango.
getPrecedents()	Devuelve un `WorkbookRangeAreas` objeto que representa el rango que contiene todas las celdas precedentes de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. Genera un `ItemNotFound` error si no se encuentran precedentes.
getRangeEdge(direction, activeCell)	Devuelve un objeto de rango que es la celda perimetral de la región de datos que corresponde a la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+tecla de dirección en la interfaz de usuario de Excel en Windows.
getRangeEdge(direction, activeCell)	Devuelve un objeto de rango que es la celda perimetral de la región de datos que corresponde a la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+tecla de dirección en la interfaz de usuario de Excel en Windows.
getResizedRange(deltaRows, deltaColumns)	Obtiene un `Range` objeto similar al objeto actual `Range` , pero con su esquina inferior derecha expandida (o contraída) por un cierto número de filas y columnas.
getRow(row)	Obtiene una fila contenida en el intervalo.
getRowProperties(rowPropertiesLoadOptions)	Devuelve una matriz de una sola dimensión que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la fila. Para las propiedades que no son coherentes en todas las celdas de una fila determinada, `null` se devolverá.
getRowsAbove(count)	Obtiene un número determinado de filas por encima del objeto actual `Range` .
getRowsBelow(count)	Obtiene un cierto número de filas debajo del objeto actual `Range` .
getSpecialCells(cellType, cellValueType)	Obtiene el `RangeAreas` objeto, que comprende uno o más rangos rectangulares, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentra ninguna celda especial, se producirá un `ItemNotFound` error.
getSpecialCells(cellType, cellValueType)	Obtiene el `RangeAreas` objeto, que comprende uno o más rangos rectangulares, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentra ninguna celda especial, se producirá un `ItemNotFound` error.
getSpecialCellsOrNullObject(cellType, cellValueType)	Obtiene el `RangeAreas` objeto, que comprende uno o más rangos, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentran celdas especiales, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getSpecialCellsOrNullObject(cellType, cellValueType)	Obtiene el `RangeAreas` objeto, que comprende uno o más rangos, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentran celdas especiales, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getSpillingToRange()	Obtiene el objeto de intervalo que contiene el intervalo de desbordamiento al llamar en una celda de delimitador. Se produce un error si se aplica a un intervalo con más de una celda.
getSpillingToRangeOrNullObject()	Obtiene el objeto de intervalo que contiene el intervalo de desbordamiento al llamar en una celda de delimitador. Si el rango no es una celda delimitadora o no se puede encontrar el rango de desbordamiento, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getSpillParent()	Obtiene el intervalo que contiene la celda de delimitador de una celda en la que se derrama. Se produce un error si se aplica a un intervalo con más de una celda.
getSpillParentOrNullObject()	Obtiene el objeto de rango que contiene la celda de anclaje de la celda en la que se está derramando. Si no es una celda desbordada, o se proporciona más de una celda, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getSurroundingRegion()	Devuelve un `Range` objeto que representa la región circundante de la celda superior izquierda de este rango. Una región circundante es un intervalo limitado por cualquier combinación de filas y columnas en blanco en relación a este intervalo.
getTables(fullyContained)	Obtiene una colección con ámbito de tablas que se superpone con el intervalo.
getUsedRange(valuesOnly)	Devuelve el intervalo usado del objeto de rango especificado. Si no hay celdas usadas en el rango, esta función generará un `ItemNotFound` error.
getUsedRangeOrNullObject(valuesOnly)	Devuelve el intervalo usado del objeto de rango especificado. Si no hay celdas usadas en el rango, este método devuelve un objeto con su `isNullObject` propiedad establecida en `true`. Para obtener más información, vea los métodos y propiedades *OrNullObject.
getVisibleView()	Representa las filas visibles del intervalo actual.
group(groupOption)	Agrupa columnas y filas para obtener un esquema.
group(groupOption)	Agrupa columnas y filas para obtener un esquema.
hideGroupDetails(groupOption)	Oculta los detalles del grupo de filas o columnas.
hideGroupDetails(groupOption)	Oculta los detalles del grupo de filas o columnas.
insert(shift)	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 `Range` objeto en el espacio en blanco.
insert(shift)	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 `Range` objeto en el espacio en blanco.
load(options)	Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a `context.sync()` antes de leer las propiedades.
load(propertyNames)	Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a `context.sync()` antes de leer las propiedades.
load(propertyNamesAndPaths)	Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a `context.sync()` antes de leer las propiedades.
merge(across)	Combina las celdas del intervalo en una región de la hoja de cálculo.
moveTo(destinationRange)	Mueve los valores de celda, el formato y las fórmulas del rango actual al rango de destino, reemplazando la información anterior de esas celdas. El rango de destino se expandirá automáticamente si es más pequeño que el rango actual. Las celdas del rango de destino que están fuera del área del rango original no se cambian. Nota: Cuando un rango se mueve a una nueva dirección usando esta API, el nuevo objeto de rango debe recuperarse usando la nueva dirección.
removeDuplicates(columns, includesHeader)	Quita los valores duplicados del intervalo especificado por las columnas.
replaceAll(text, replacement, criteria)	Busca y reemplaza la cadena especificada, según los criterios especificados dentro del intervalo actual.
select()	Selecciona el intervalo especificado en la interfaz de usuario de Excel.
set(properties, options)	Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto API del mismo tipo.
set(properties)	Establece varias propiedades en el objeto al mismo tiempo, basadas en un objeto cargado existente.
setCellProperties(cellPropertiesData)	Actualiza las novedades del rango en función de una matriz 2D de propiedades de celda, encapsulando elementos como fuente, relleno, bordes y alineación.
setColumnProperties(columnPropertiesData)	Novedades el rango en función de una matriz unidimensional de propiedades de columna, encapsulando elementos como la fuente, el relleno, los bordes y la alineación.
setDirty()	Establece un intervalo que se deberá actualizar cuando se realice la próxima actualización.
setRowProperties(rowPropertiesData)	Novedades el rango en función de una matriz unidimensional de propiedades de fila, encapsulando elementos como fuente, relleno, bordes y alineación.
showCard()	Muestra la tarjeta de una celda activa si tiene contenido de valor enriquecido.
showGroupDetails(groupOption)	Muestra los detalles del grupo de filas o columnas.
showGroupDetails(groupOption)	Muestra los detalles del grupo de filas o columnas.
toJSON()	Reemplaza el método JavaScript `toJSON()` para proporcionar una salida más útil cuando se pasa un objeto API a `JSON.stringify()`. (`JSON.stringify`, a su vez, llama al `toJSON` método del objeto que se le pasa). Mientras que el objeto original `Excel.Range` es un objeto API, el `toJSON` método devuelve un objeto JavaScript simple (escrito como `Excel.Interfaces.RangeData`) que contiene copias superficiales de cualquier propiedad secundaria cargada del objeto original.
track()	Realiza un seguimiento del objeto de ajuste automático según cambios adyacentes en el documento. Esta llamada es una abreviatura de context.trackedObjects.add(thisObject). Si usa este objeto entre `.sync` llamadas y fuera de la ejecución secuencial de un lote ".run" y recibe un error "InvalidObjectPath" al establecer una propiedad o invocar un método en el objeto, debe agregar el objeto a la colección de objetos objeto de seguimiento cuando se creó el objeto por primera vez.
ungroup(groupOption)	Desagrupa las columnas y filas para obtener un esquema.
ungroup(groupOption)	Desagrupa las columnas y filas para obtener un esquema.
unmerge()	Separa las celdas del intervalo en celdas independientes.
untrack()	Libere la memoria asociada a este objeto, si se ha realizado un seguimiento de él anteriormente. Esta llamada es la abreviatura de context.trackedObjects.remove(thisObject). Tener muchos objetos marcados ralentiza la aplicación host, así que debe recordar liberar los objetos que agregue cuando haya terminado con ellos. Deberá llamar `context.sync()` antes de que la liberación de memoria surta efecto.

address

Especifica el rango de referencia en estilo A1. El valor de dirección contiene la referencia de hoja (por ejemplo, "Hoja1! A1:B4").

readonly address: string;

Valor de propiedad

string

Comentarios

[Conjunto de API: ExcelApi 1.1]

addressLocal

Representa la referencia de rango para el rango especificado en el idioma del usuario.

readonly addressLocal: string;

Valor de propiedad

string

Comentarios

[Conjunto de API: ExcelApi 1.1]

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

readonly cellCount: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.1]

columnCount

Especifica el número total de columnas del rango.

readonly columnCount: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.1]

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

[Conjunto de API: ExcelApi 1.2]

columnIndex

Especifica el número de columna de la primera celda del rango. Indizado con cero.

readonly columnIndex: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.1]

conditionalFormats

La colección de ConditionalFormats eso cruza la cordillera.

readonly conditionalFormats: Excel.ConditionalFormatCollection;

Valor de propiedad

Excel.ConditionalFormatCollection

Comentarios

[Conjunto de API: ExcelApi 1.6]

context

El contexto de solicitud asociado al objeto. De esta forma, se conecta el proceso del complemento con el proceso de la aplicación host de Office.

context: RequestContext;

Valor de propiedad

Excel.RequestContext

control

Accede al control de celda aplicado a este rango. Si el rango tiene varios controles de celda, devuelve EmptyCellControl.

control: CellControl;

Valor de propiedad

Excel.CellControl

Comentarios

[Conjunto de API: ExcelApi 1.18]

dataValidation

Devuelve un objeto de validación de datos.

readonly dataValidation: Excel.DataValidation;

Valor de propiedad

Excel.DataValidation

Comentarios

[Conjunto de API: ExcelApi 1.8]

format

Devuelve un objeto de formato que encapsula la fuente, el relleno, los bordes, la alineación y otras propiedades del rango.

readonly format: Excel.RangeFormat;

Valor de propiedad

Excel.RangeFormat

Comentarios

[Conjunto de API: ExcelApi 1.1]

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: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

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: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

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: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.2]

hasSpill

Indica si todas las celdas tienen un borde de desbordamiento. Devuelve true si todas las celdas tienen un borde de desbordamiento o false si no lo tienen. Devuelve null si hay celdas con y sin bordes de desbordamiento dentro del rango.

readonly hasSpill: boolean;

Valor de propiedad

boolean

Comentarios

[Conjunto de API: ExcelApi 1.12]

height

Devuelve la distancia en puntos, para un zoom del 100 %, desde el borde superior del rango hasta el borde inferior del rango.

readonly height: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.10]

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.

readonly hidden: boolean;

Valor de propiedad

boolean

Comentarios

[Conjunto de API: ExcelApi 1.2]

hyperlink

Representa el hipervínculo del rango actual.

hyperlink: Excel.RangeHyperlink;

Valor de propiedad

Excel.RangeHyperlink

Comentarios

[Conjunto de API: ExcelApi 1.7]

isEntireColumn

Representa si el intervalo actual es una columna completa.

readonly isEntireColumn: boolean;

Valor de propiedad

boolean

Comentarios

[Conjunto de API: ExcelApi 1.7]

isEntireRow

Representa si el intervalo actual es una fila completa.

readonly isEntireRow: boolean;

Valor de propiedad

boolean

Comentarios

[Conjunto de API: ExcelApi 1.7]

left

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.

readonly left: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.10]

linkedDataTypeState

Indica el estado del tipo de datos de cada celda.

readonly linkedDataTypeState: Excel.LinkedDataTypeState[][];

Valor de propiedad

Excel.LinkedDataTypeState[][]

Comentarios

[Conjunto de API: ExcelApi 1.9]

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: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

numberFormatCategories

Representa la categoría del formato de número de cada celda.

readonly numberFormatCategories: Excel.NumberFormatCategory[][];

Valor de propiedad

Excel.NumberFormatCategory[][]

Comentarios

[Conjunto de API: ExcelApi 1.12]

numberFormatLocal

Representa el código de formato de número de Excel para el rango especificado, en función de la configuración de idioma del usuario. Excel no ejerce ninguna coerción de idioma o formato al obtener o establecer la numberFormatLocal propiedad. Cualquier texto devuelto usa cadenas con formato local basadas en el idioma especificado en la configuración del sistema.

numberFormatLocal: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.7]

rowCount

Devuelve el número total de filas del intervalo.

readonly rowCount: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.1]

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

[Conjunto de API: ExcelApi 1.2]

rowIndex

Devuelve el número de fila de la primera celda del intervalo. Indizado con cero.

readonly rowIndex: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.1]

savedAsArray

Representa si todas las celdas se guardarían como una fórmula de matriz. Devuelve true si todas las celdas se guardarían como fórmula de matriz o false si no se guardarían todas las celdas como fórmula de matriz. Devuelve null si algunas celdas se guardarían como una fórmula de matriz y otras no.

readonly savedAsArray: boolean;

Valor de propiedad

boolean

Comentarios

[Conjunto de API: ExcelApi 1.12]

sort

Representa la ordenación del intervalo del intervalo actual.

readonly sort: Excel.RangeSort;

Valor de propiedad

Excel.RangeSort

Comentarios

[Conjunto de API: ExcelApi 1.2]

style

Representa el estilo del rango actual. Si los estilos de las celdas son incoherentes, null se devolverá. Para los estilos personalizados, se devolverá el nombre del estilo. Para los estilos integrados, se devolverá una cadena que representa un valor de la BuiltInStyle enumeración.

style: string;

Valor de propiedad

string

Comentarios

[Conjunto de API: ExcelApi 1.7]

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.

readonly text: string[][];

Valor de propiedad

string[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

top

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.

readonly top: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.10]

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: any[][];

Valor de propiedad

any[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

valuesAsJson

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. Algunos ejemplos son los valores numéricos con formato y las imágenes web, además de los valores estándar booleanos, numéricos y de cadena. 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: CellValue[][];

Valor de propiedad

Excel.CellValue[][]

Comentarios

[Conjunto de API: ExcelApi 1.16]

valuesAsJsonLocal

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. Algunos ejemplos son los valores numéricos con formato y las imágenes web, además de los valores estándar booleanos, numéricos y de cadena. Los datos devueltos desde esta API siempre se alinean con la configuración regional de visualización del usuario. Para recuperar datos independientemente de la configuración regional, use Range.valuesAsJson.

valuesAsJsonLocal: CellValue[][];

Valor de propiedad

Excel.CellValue[][]

Comentarios

[Conjunto de API: ExcelApi 1.16]

valueTypes

Especifica el tipo de datos de cada celda.

readonly valueTypes: Excel.RangeValueType[][];

Valor de propiedad

Excel.RangeValueType[][]

Comentarios

[Conjunto de API: ExcelApi 1.1]

width

Devuelve la distancia en puntos, para un zoom del 100 %, desde el borde izquierdo del rango hasta el borde derecho del rango.

readonly width: number;

Valor de propiedad

number

Comentarios

[Conjunto de API: ExcelApi 1.10]

worksheet

Hoja de cálculo que contiene el rango actual.

readonly worksheet: Excel.Worksheet;

Valor de propiedad

Excel.Worksheet

Comentarios

[Conjunto de API: ExcelApi 1.1]

autoFill(destinationRange, autoFillType)

Rellena un rango desde el rango actual hasta el rango de destino utilizando la lógica de Autorrellenar especificada. El rango de destino puede ser null o puede extender el rango de origen horizontal o verticalmente. No se admiten intervalos discontinuos.

Para obtener más información, consulte Uso de Autorrellenar y Relleno rápido.

autoFill(destinationRange?: Range | string, autoFillType?: Excel.AutoFillType): void;

Parámetros

destinationRange: Excel.Range | string

El rango de destino para autorrellenar. Si el rango de destino es null, los datos se rellenan en función de las celdas circundantes (que es el comportamiento al hacer doble clic en el controlador de relleno de rango de la interfaz de usuario).

autoFillType: Excel.AutoFillType

El tipo de Autorrellenar. Especifica cómo se debe rellenar el intervalo de destino, en función del contenido del intervalo actual. El valor predeterminado es "FillDefault".

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9, vista previa de ExcelApi para null destinationRange]

autoFill(destinationRange, autoFillType)

Rellena un rango desde el rango actual hasta el rango de destino utilizando la lógica de Autorrellenar especificada. El rango de destino puede ser null o puede extender el rango de origen horizontal o verticalmente. No se admiten intervalos discontinuos.

Para obtener más información, consulte Uso de Autorrellenar y Relleno rápido.

autoFill(destinationRange?: Range | string, autoFillType?: "FillDefault" | "FillCopy" | "FillSeries" | "FillFormats" | "FillValues" | "FillDays" | "FillWeekdays" | "FillMonths" | "FillYears" | "LinearTrend" | "GrowthTrend" | "FlashFill"): void;

Parámetros

destinationRange: Excel.Range | string

El rango de destino para autorrellenar. Si el rango de destino es null, los datos se rellenan en función de las celdas circundantes (que es el comportamiento al hacer doble clic en el controlador de relleno de rango de la interfaz de usuario).

autoFillType: "FillDefault" | "FillCopy" | "FillSeries" | "FillFormats" | "FillValues" | "FillDays" | "FillWeekdays" | "FillMonths" | "FillYears" | "LinearTrend" | "GrowthTrend" | "FlashFill"

El tipo de Autorrellenar. Especifica cómo se debe rellenar el intervalo de destino, en función del contenido del intervalo actual. El valor predeterminado es "FillDefault".

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9, vista previa de ExcelApi para null destinationRange]

calculate()

Calcula un rango de celdas en una hoja de cálculo.

calculate(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.6]

clear(applyTo)

Borrar valores de rango y formato, como relleno y borde.

clear(applyTo?: Excel.ClearApplyTo): void;

Parámetros

applyTo: Excel.ClearApplyTo

Opcional. Determina el tipo de acción de borrado. Vea Excel.ClearApplyTo para más información.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.1]

clear(applyTo)

Borrar valores de rango y formato, como relleno y borde.

clear(applyTo?: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"): void;

Parámetros

applyTo: "All" | "Formats" | "Contents" | "Hyperlinks" | "RemoveHyperlinks" | "ResetContents"

convertToLinkedDataType(serviceID: number, languageCulture: string): void;

Parámetros

serviceID: number

El identificador de servicio que se usará para consultar los datos.

languageCulture: string

Referencia cultural lingüística para consultar el servicio.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

copyFrom(sourceRange, copyType, skipBlanks, transpose)

Copia los datos o el formato de celda del rango de origen o RangeAreas al rango actual. El rango de destino puede tener un tamaño diferente del rango de origen o RangeAreas. El destino se expande automáticamente si es más pequeño que el origen. Nota: Al igual que la funcionalidad de copia en la interfaz de usuario de Excel, si el rango de destino es un múltiplo exacto mayor que el rango de origen en filas o columnas, el contenido de origen se replica varias veces. Por ejemplo, una copia de un rango 2x2 en un rango de 2x6 dará como resultado 3 copias del rango de 2x2 original.

copyFrom(sourceRange: Range | RangeAreas | string, copyType?: Excel.RangeCopyType, skipBlanks?: boolean, transpose?: boolean): void;

Parámetros

sourceRange: Excel.Range | Excel.RangeAreas | string

El rango de origen o RangeAreas desde el que copiar. Cuando el origen RangeAreas tiene varios rangos, su forma debe poder crearse quitando filas o columnas completas de un rango rectangular.

copyType: Excel.RangeCopyType

El tipo de datos o formato de celda que se va a copiar. El valor predeterminado es "Todos".

skipBlanks: boolean

Verdadero si quiere omitir celdas en blanco en el rango de origen. El valor predeterminado es false.

transpose: boolean

Verdadero si se transponen las celdas del rango de destino. El valor predeterminado es false.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

copyFrom(sourceRange, copyType, skipBlanks, transpose)

Copia los datos o el formato de celda del rango de origen o RangeAreas al rango actual. El rango de destino puede tener un tamaño diferente del rango de origen o RangeAreas. El destino se expande automáticamente si es más pequeño que el origen. Nota: Al igual que la funcionalidad de copia en la interfaz de usuario de Excel, si el rango de destino es un múltiplo exacto mayor que el rango de origen en filas o columnas, el contenido de origen se replica varias veces. Por ejemplo, una copia de un rango 2x2 en un rango de 2x6 dará como resultado 3 copias del rango de 2x2 original.

copyFrom(sourceRange: Range | RangeAreas | string, copyType?: "All" | "Formulas" | "Values" | "Formats" | "Link", skipBlanks?: boolean, transpose?: boolean): void;

Parámetros

sourceRange: Excel.Range | Excel.RangeAreas | string

El rango de origen o RangeAreas desde el que copiar. Cuando el origen RangeAreas tiene varios rangos, su forma debe poder crearse quitando filas o columnas completas de un rango rectangular.

copyType: "All" | "Formulas" | "Values" | "Formats" | "Link"

El tipo de datos o formato de celda que se va a copiar. El valor predeterminado es "Todos".

skipBlanks: boolean

Verdadero si quiere omitir celdas en blanco en el rango de origen. El valor predeterminado es false.

transpose: boolean

Verdadero si se transponen las celdas del rango de destino. El valor predeterminado es false.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

delete(shift)

Elimina las celdas asociadas al rango.

delete(shift: Excel.DeleteShiftDirection): void;

Parámetros

shift: Excel.DeleteShiftDirection

Especifica hacia dónde se desplazarán las celdas. Vea Excel.DeleteShiftDirection para más información.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.1]

delete(shift)

Elimina las celdas asociadas al rango.

delete(shift: "Up" | "Left"): void;

Parámetros

shift: "Up" | "Left"

Especifica hacia dónde se desplazarán las celdas. Vea Excel.DeleteShiftDirection para más información.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.1]

find(text, criteria)

Busca la cadena especificada, según los criterios especificados. Si el rango actual es mayor que una celda, la búsqueda se limitará a ese rango; de lo contrario, la búsqueda cubrirá toda la hoja a partir de esa celda.

find(text: string, criteria: Excel.SearchCriteria): Excel.Range;

Parámetros

text: string

La cadena que se va a buscar.

criteria: Excel.SearchCriteria

Criterios de búsqueda adicionales, como la dirección de búsqueda y si la búsqueda debe coincidir con toda la celda o distinguir mayúsculas de minúsculas.

Devoluciones

Excel.Range

Objeto Range que representa la primera celda que contiene un valor que coincide con el texto y los criterios de búsqueda.

Comentarios

[Conjunto de API: ExcelApi 1.9]

findOrNullObject(text, criteria)

Busca la cadena especificada, según los criterios especificados. Si el rango actual es mayor que una celda, la búsqueda se limitará a ese rango; de lo contrario, la búsqueda cubrirá toda la hoja a partir de esa celda. Si no hay coincidencias, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea los métodos y propiedades *OrNullObject.

findOrNullObject(text: string, criteria: Excel.SearchCriteria): Excel.Range;

Parámetros

text: string

La cadena que se va a buscar.

criteria: Excel.SearchCriteria

Criterios de búsqueda adicionales, como la dirección de búsqueda y si la búsqueda debe coincidir con toda la celda o distinguir mayúsculas de minúsculas.

Devoluciones

Excel.Range

Los Range que coincidan con los criterios de búsqueda.

Comentarios

[Conjunto de API: ExcelApi 1.9]

flashFill()

Rellena rápidamente el rango actual. Relleno rápido rellena automáticamente los datos cuando detecta un patrón, por lo que el rango debe ser un rango de una sola columna y tener datos a su alrededor para encontrar un patrón.

flashFill(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

getAbsoluteResizedRange(numRows, numColumns)

Obtiene un Range objeto con la misma celda superior izquierda que el objeto actual Range , pero con el número especificado de filas y columnas.

getAbsoluteResizedRange(numRows: number, numColumns: number): Excel.Range;

Parámetros

numRows: number

El número de filas del nuevo tamaño de rango.

numColumns: number

El número de columnas del nuevo tamaño del rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.7]

getBoundingRect(anotherRange)

Obtiene el objeto de intervalo más pequeño que abarca los intervalos especificados. Por ejemplo, el GetBoundingRect valor de "B2:C5" y "D10:E15" es "B2:E15".

getBoundingRect(anotherRange: Range | string): Excel.Range;

Parámetros

anotherRange: Excel.Range | string

El objeto de rango, la dirección o el nombre del rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getCell(row, column)

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 de su rango primario siempre que se mantenga 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.

getCell(row: number, column: number): Excel.Range;

Parámetros

row: number

Número de fila de la celda que se va a recuperar. Indizado con cero.

column: number

Número de columna de la celda que se va a recuperar. Indizado con cero.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getCellProperties(cellPropertiesLoadOptions)

Devuelve una matriz 2D que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la celda.

getCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions): OfficeExtension.ClientResult<CellProperties[][]>;

Parámetros

cellPropertiesLoadOptions: Excel.CellPropertiesLoadOptions

Un objeto que representa las propiedades de la celda que se van a cargar.

Devoluciones

OfficeExtension.ClientResult<Excel.CellProperties[][]>

Una matriz 2D donde cada elemento representa las propiedades solicitadas de la celda correspondiente.

Comentarios

[Conjunto de API: ExcelApi 1.9]

getColumn(column)

Obtiene una columna contenida en el intervalo.

getColumn(column: number): Excel.Range;

Parámetros

column: number

Número de columna del intervalo que se va a recuperar. Indizado con cero.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getColumnProperties(columnPropertiesLoadOptions)

Devuelve una matriz de una sola dimensión que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la columna. Se devolverá null para las propiedades que no son coherentes en cada celda de una columna determinada.

getColumnProperties(columnPropertiesLoadOptions: ColumnPropertiesLoadOptions): OfficeExtension.ClientResult<ColumnProperties[]>;

Parámetros

columnPropertiesLoadOptions: Excel.ColumnPropertiesLoadOptions

Un objeto que representa qué propiedades de columna cargar.

Devoluciones

OfficeExtension.ClientResult<Excel.ColumnProperties[]>

Una matriz donde cada elemento representa las propiedades solicitadas de la columna correspondiente.

Comentarios

[Conjunto de API: ExcelApi 1.9]

getColumnsAfter(count)

Obtiene un cierto número de columnas a la derecha del objeto actual Range .

getColumnsAfter(count?: number): Excel.Range;

Parámetros

count: number

Opcional. El número de columnas que se va a incluir en el rango resultante. En general, use un número positivo para crear un intervalo fuera del intervalo actual. También puede usar un número negativo para crear un intervalo dentro del intervalo actual. El valor predeterminado es 1.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.2]

getColumnsBefore(count)

Obtiene un cierto número de columnas a la izquierda del objeto actual Range .

getColumnsBefore(count?: number): Excel.Range;

Parámetros

count: number

getDisplayedCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions): OfficeExtension.ClientResult<CellProperties[][]>;

Parámetros

cellPropertiesLoadOptions: Excel.CellPropertiesLoadOptions

Un objeto que representa las propiedades de la celda que se van a cargar.

Devoluciones

OfficeExtension.ClientResult<Excel.CellProperties[][]>

Una matriz 2D donde cada elemento representa las propiedades de visualización solicitadas de la celda correspondiente.

Comentarios

[Conjunto de API: ExcelApi 1.19]

getEntireColumn()

Obtiene un objeto que representa toda la columna del rango (por ejemplo, si el rango actual representa las celdas "B4:E11", este getEntireColumn es un rango que representa las columnas "B:E").

getEntireColumn(): Excel.Range;

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getEntireRow()

Obtiene un objeto que representa toda la fila del rango (por ejemplo, si el rango actual representa las celdas "B4:E11", este GetEntireRow es un rango que representa las filas "4:11").

getEntireRow(): Excel.Range;

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getExtendedRange(direction, activeCell)

Devuelve un objeto de rango que incluye el rango actual y hasta el borde del rango, en función de la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+Mayús+tecla de dirección en la interfaz de usuario de Excel en Windows.

getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;

Parámetros

direction: Excel.KeyboardDirection

Dirección desde la celda activa.

activeCell: Excel.Range | string

La celda activa de este intervalo. De forma predeterminada, la celda activa es la celda superior izquierda del rango. Se genera un error si la celda activa no está en este rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.13]

getExtendedRange(direction, activeCell)

Devuelve un objeto de rango que incluye el rango actual y hasta el borde del rango, en función de la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+Mayús+tecla de dirección en la interfaz de usuario de Excel en Windows.

getExtendedRange(direction: "Left" | "Right" | "Up" | "Down", activeCell?: Range | string): Excel.Range;

Parámetros

direction: "Left" | "Right" | "Up" | "Down"

Dirección desde la celda activa.

activeCell: Excel.Range | string

La celda activa de este intervalo. De forma predeterminada, la celda activa es la celda superior izquierda del rango. Se genera un error si la celda activa no está en este rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.13]

getImage()

Representa el rango como una imagen PNG codificada en Base64.

getImage(): OfficeExtension.ClientResult<string>;

Devoluciones

OfficeExtension.ClientResult<string>

Comentarios

[Conjunto de API: ExcelApi 1.7]

getIntersection(anotherRange)

Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados.

getIntersection(anotherRange: Range | string): Excel.Range;

Parámetros

anotherRange: Excel.Range | string

Objeto de intervalo o dirección de intervalo que se usará para determinar la intersección de los intervalos.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getIntersectionOrNullObject(anotherRange)

Obtiene el objeto de rango que representa la intersección rectangular de los rangos especificados. Si no se encuentra ninguna intersección, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea los métodos y propiedades *OrNullObject.

getIntersectionOrNullObject(anotherRange: Range | string): Excel.Range;

Parámetros

anotherRange: Excel.Range | string

getOffsetRange(rowOffset: number, columnOffset: number): Excel.Range;

Parámetros

rowOffset: number

Número de filas (número positivo, negativo o 0) que debe desplazarse el intervalo. Los valores positivos desplazan hacia abajo, mientras que los negativos lo hacen hacia arriba.

columnOffset: number

Número de columnas (número positivo, negativo o 0) que debe desplazarse el intervalo. Los valores positivos desplazan hacia la derecha, mientras que los negativos lo hacen hacia la izquierda.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getPivotTables(fullyContained)

Obtiene una colección con ámbito de tablas dinámicas que se superponen con el rango.

getPivotTables(fullyContained?: boolean): Excel.PivotTableScopedCollection;

Parámetros

fullyContained: boolean

Si true, devuelve solo tablas dinámicas que están completamente contenidas dentro de los límites del rango. El valor predeterminado es false.

Devoluciones

Excel.PivotTableScopedCollection

Comentarios

[Conjunto de API: ExcelApi 1.12]

getPrecedents()

Devuelve un WorkbookRangeAreas objeto que representa el rango que contiene todas las celdas precedentes de un rango especificado en la misma hoja de cálculo o en varias hojas de cálculo. Genera un ItemNotFound error si no se encuentran precedentes.

getPrecedents(): Excel.WorkbookRangeAreas;

Devoluciones

Excel.WorkbookRangeAreas

Comentarios

[Conjunto de API: ExcelApi 1.14]

getRangeEdge(direction, activeCell)

Devuelve un objeto de rango que es la celda perimetral de la región de datos que corresponde a la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+tecla de dirección en la interfaz de usuario de Excel en Windows.

getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;

Parámetros

direction: Excel.KeyboardDirection

Dirección desde la celda activa.

activeCell: Excel.Range | string

La celda activa de este intervalo. De forma predeterminada, la celda activa es la celda superior izquierda del rango. Se genera un error si la celda activa no está en este rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.13]

getRangeEdge(direction, activeCell)

Devuelve un objeto de rango que es la celda perimetral de la región de datos que corresponde a la dirección proporcionada. Esto coincide con el comportamiento de Ctrl+tecla de dirección en la interfaz de usuario de Excel en Windows.

getRangeEdge(direction: "Left" | "Right" | "Up" | "Down", activeCell?: Range | string): Excel.Range;

Parámetros

direction: "Left" | "Right" | "Up" | "Down"

Dirección desde la celda activa.

activeCell: Excel.Range | string

La celda activa de este intervalo. De forma predeterminada, la celda activa es la celda superior izquierda del rango. Se genera un error si la celda activa no está en este rango.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.13]

getResizedRange(deltaRows, deltaColumns)

Obtiene un Range objeto similar al objeto actual Range , pero con su esquina inferior derecha expandida (o contraída) por un cierto número de filas y columnas.

getResizedRange(deltaRows: number, deltaColumns: number): Excel.Range;

Parámetros

deltaRows: number

El número de filas en el que se va a expandir la esquina inferior derecha, con respecto al intervalo actual. Use un número positivo para expandir el intervalo, o un número negativo para reducirlo.

deltaColumns: number

Número de columnas por las que se va a expandir la esquina inferior derecha, en relación con el rango actual. Use un número positivo para expandir el intervalo, o un número negativo para reducirlo.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.2]

getRow(row)

Obtiene una fila contenida en el intervalo.

getRow(row: number): Excel.Range;

Parámetros

row: number

Número de fila del intervalo que se va a recuperar. Indizado con cero.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getRowProperties(rowPropertiesLoadOptions)

Devuelve una matriz de una sola dimensión que encapsula los datos para la fuente, el relleno, los bordes, la alineación y otras propiedades de la fila. Para las propiedades que no son coherentes en todas las celdas de una fila determinada, null se devolverá.

getRowProperties(rowPropertiesLoadOptions: RowPropertiesLoadOptions): OfficeExtension.ClientResult<RowProperties[]>;

Parámetros

rowPropertiesLoadOptions: Excel.RowPropertiesLoadOptions

Un objeto que representa qué propiedades de fila se van a cargar.

Devoluciones

OfficeExtension.ClientResult<Excel.RowProperties[]>

Una matriz donde cada elemento representa las propiedades solicitadas de la fila correspondiente.

Comentarios

[Conjunto de API: ExcelApi 1.9]

getRowsAbove(count)

Obtiene un número determinado de filas por encima del objeto actual Range .

getRowsAbove(count?: number): Excel.Range;

Parámetros

count: number

Opcional. El número de filas que se va a incluir en el intervalo resultante. En general, use un número positivo para crear un intervalo fuera del intervalo actual. También puede usar un número negativo para crear un intervalo dentro del intervalo actual. El valor predeterminado es 1.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.2]

getRowsBelow(count)

Obtiene un cierto número de filas debajo del objeto actual Range .

getRowsBelow(count?: number): Excel.Range;

Parámetros

count: number

Opcional. El número de filas que se va a incluir en el intervalo resultante. En general, use un número positivo para crear un intervalo fuera del intervalo actual. También puede usar un número negativo para crear un intervalo dentro del intervalo actual. El valor predeterminado es 1.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.2]

getSpecialCells(cellType, cellValueType)

Obtiene el RangeAreas objeto, que comprende uno o más rangos rectangulares, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentra ninguna celda especial, se producirá un ItemNotFound error.

getSpecialCells(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;

Parámetros

cellType: Excel.SpecialCellType

El tipo de celdas que se van a incluir.

cellValueType: Excel.SpecialCellValueType

Si cellType es o constantsformulas, este argumento se usa para determinar qué tipos de celdas incluir en el resultado. Estos valores se pueden combinar para devolver más de un tipo. El valor predeterminado es seleccionar todas las constantes o fórmulas, sea cual sea el tipo.

Devoluciones

Excel.RangeAreas

Comentarios

[Conjunto de API: ExcelApi 1.9]

getSpecialCells(cellType, cellValueType)

Obtiene el RangeAreas objeto, que comprende uno o más rangos rectangulares, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentra ninguna celda especial, se producirá un ItemNotFound error.

getSpecialCells(cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueType?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;

Parámetros

cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"

El tipo de celdas que se van a incluir.

cellValueType: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"

Si cellType es o constantsformulas, este argumento se usa para determinar qué tipos de celdas incluir en el resultado. Estos valores se pueden combinar para devolver más de un tipo. El valor predeterminado es seleccionar todas las constantes o fórmulas, sea cual sea el tipo.

Devoluciones

Excel.RangeAreas

Comentarios

[Conjunto de API: ExcelApi 1.9]

getSpecialCellsOrNullObject(cellType, cellValueType)

Obtiene el RangeAreas objeto, que comprende uno o más rangos, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentran celdas especiales, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea los métodos y propiedades *OrNullObject.

getSpecialCellsOrNullObject(cellType: Excel.SpecialCellType, cellValueType?: Excel.SpecialCellValueType): Excel.RangeAreas;

Parámetros

cellType: Excel.SpecialCellType

El tipo de celdas que se van a incluir.

cellValueType: Excel.SpecialCellValueType

Si cellType es o constantsformulas, este argumento se usa para determinar qué tipos de celdas incluir en el resultado. Estos valores se pueden combinar para devolver más de un tipo. El valor predeterminado es seleccionar todas las constantes o fórmulas, sea cual sea el tipo.

Devoluciones

Excel.RangeAreas

Comentarios

[Conjunto de API: ExcelApi 1.9]

getSpecialCellsOrNullObject(cellType, cellValueType)

Obtiene el RangeAreas objeto, que comprende uno o más rangos, que representa todas las celdas que coinciden con el tipo y valor especificados. Si no se encuentran celdas especiales, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea los métodos y propiedades *OrNullObject.

getSpecialCellsOrNullObject(cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible", cellValueType?: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"): Excel.RangeAreas;

Parámetros

cellType: "ConditionalFormats" | "DataValidations" | "Blanks" | "Constants" | "Formulas" | "SameConditionalFormat" | "SameDataValidation" | "Visible"

El tipo de celdas que se van a incluir.

cellValueType: "All" | "Errors" | "ErrorsLogical" | "ErrorsNumbers" | "ErrorsText" | "ErrorsLogicalNumber" | "ErrorsLogicalText" | "ErrorsNumberText" | "Logical" | "LogicalNumbers" | "LogicalText" | "LogicalNumbersText" | "Numbers" | "NumbersText" | "Text"

getTables(fullyContained?: boolean): Excel.TableScopedCollection;

Parámetros

fullyContained: boolean

Si true, devuelve solo las tablas que están completamente contenidas dentro de los límites del rango. El valor predeterminado es false.

Devoluciones

Excel.TableScopedCollection

Comentarios

[Conjunto de API: ExcelApi 1.9]

getUsedRange(valuesOnly)

Devuelve el intervalo usado del objeto de rango especificado. Si no hay celdas usadas en el rango, esta función generará un ItemNotFound error.

getUsedRange(valuesOnly?: boolean): Excel.Range;

Parámetros

valuesOnly: boolean

Solo tiene en cuenta las celdas con valores como celdas usadas. [Conjunto de API: ExcelApi 1.2]

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

getUsedRangeOrNullObject(valuesOnly)

Devuelve el intervalo usado del objeto de rango especificado. Si no hay celdas usadas en el rango, este método devuelve un objeto con su isNullObject propiedad establecida en true. Para obtener más información, vea los métodos y propiedades *OrNullObject.

getUsedRangeOrNullObject(valuesOnly?: boolean): Excel.Range;

Parámetros

valuesOnly: boolean

Solo tiene en cuenta las celdas con valores como celdas usadas.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.4]

getVisibleView()

Representa las filas visibles del intervalo actual.

getVisibleView(): Excel.RangeView;

Devoluciones

Excel.RangeView

Comentarios

[Conjunto de API: ExcelApi 1.3]

group(groupOption)

Agrupa columnas y filas para obtener un esquema.

group(groupOption: Excel.GroupOption): void;

Parámetros

groupOption: Excel.GroupOption

Especifica cómo se puede agrupar el rango por filas o columnas. Se genera un InvalidArgument error cuando la opción de grupo difiere de la propiedad o isEntireColumn del rango isEntireRow (es decir, range.isEntireRow es verdadera y groupOption es "ByColumns" o range.isEntireColumn es verdadera y groupOption es "ByRows").

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

group(groupOption)

Agrupa columnas y filas para obtener un esquema.

group(groupOption: "ByRows" | "ByColumns"): void;

Parámetros

groupOption: "ByRows" | "ByColumns"

Especifica cómo se puede agrupar el rango por filas o columnas. Se genera un InvalidArgument error cuando la opción de grupo difiere de la propiedad o isEntireColumn del rango isEntireRow (es decir, range.isEntireRow es verdadera y groupOption es "ByColumns" o range.isEntireColumn es verdadera y groupOption es "ByRows").

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

hideGroupDetails(groupOption)

Oculta los detalles del grupo de filas o columnas.

hideGroupDetails(groupOption: Excel.GroupOption): void;

Parámetros

groupOption: Excel.GroupOption

Especifica si se ocultan los detalles de las filas o columnas agrupadas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

hideGroupDetails(groupOption)

Oculta los detalles del grupo de filas o columnas.

hideGroupDetails(groupOption: "ByRows" | "ByColumns"): void;

Parámetros

groupOption: "ByRows" | "ByColumns"

Especifica si se ocultan los detalles de las filas o columnas agrupadas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

insert(shift)

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 Range objeto en el espacio en blanco.

insert(shift: Excel.InsertShiftDirection): Excel.Range;

Parámetros

shift: Excel.InsertShiftDirection

Especifica hacia dónde se desplazarán las celdas. Vea Excel.InsertShiftDirection para más información.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

insert(shift)

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 Range objeto en el espacio en blanco.

insert(shift: "Down" | "Right"): Excel.Range;

Parámetros

shift: "Down" | "Right"

Especifica hacia dónde se desplazarán las celdas. Vea Excel.InsertShiftDirection para más información.

Devoluciones

Excel.Range

Comentarios

[Conjunto de API: ExcelApi 1.1]

load(options)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(options?: Excel.Interfaces.RangeLoadOptions): Excel.Range;

Parámetros

options: Excel.Interfaces.RangeLoadOptions

Proporciona opciones para las propiedades del objeto que se van a cargar.

Devoluciones

Excel.Range

load(propertyNames)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNames?: string | string[]): Excel.Range;

Parámetros

propertyNames: string | string[]

Una cadena delimitada por comas o una matriz de cadenas que especifican las propiedades que se van a cargar.

Devoluciones

Excel.Range

load(propertyNamesAndPaths)

Pone en cola un comando para cargar las propiedades especificadas del objeto. Debe llamar a context.sync() antes de leer las propiedades.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.Range;

Parámetros

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select es una cadena delimitada por comas que especifica las propiedades que se van a cargar y propertyNamesAndPaths.expand es una cadena delimitada por comas que especifica las propiedades de navegación que se van a cargar.

Devoluciones

Excel.Range

merge(across)

Combina las celdas del intervalo en una región de la hoja de cálculo.

merge(across?: boolean): void;

Parámetros

across: boolean

Opcional. Establecer true para combinar las celdas de cada fila del rango especificado como celdas combinadas independientes. El valor predeterminado es false.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.2]

moveTo(destinationRange)

Mueve los valores de celda, el formato y las fórmulas del rango actual al rango de destino, reemplazando la información anterior de esas celdas. El rango de destino se expandirá automáticamente si es más pequeño que el rango actual. Las celdas del rango de destino que están fuera del área del rango original no se cambian. Nota: Cuando un rango se mueve a una nueva dirección usando esta API, el nuevo objeto de rango debe recuperarse usando la nueva dirección.

moveTo(destinationRange: Range | string): void;

Parámetros

destinationRange: Excel.Range | string

destinationRange Especifica el rango al que se moverá la información de este rango.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.11]

removeDuplicates(columns, includesHeader)

Quita los valores duplicados del intervalo especificado por las columnas.

removeDuplicates(columns: number[], includesHeader: boolean): Excel.RemoveDuplicatesResult;

Parámetros

columns: number[]

Las columnas del rango que pueden contener duplicados. Es necesario especificar al menos una columna. Indizado con cero.

includesHeader: boolean

True si los datos de entrada contienen un encabezado. El valor predeterminado es false.

Devoluciones

Excel.RemoveDuplicatesResult

El objeto resultante que contiene el número de filas eliminadas y el número de filas únicas restantes.

Comentarios

[Conjunto de API: ExcelApi 1.9]

replaceAll(text, replacement, criteria)

Busca y reemplaza la cadena especificada, según los criterios especificados dentro del intervalo actual.

replaceAll(text: string, replacement: string, criteria: Excel.ReplaceCriteria): OfficeExtension.ClientResult<number>;

Parámetros

text: string

Cadena que se va a buscar.

replacement: string

Cadena que reemplaza a la cadena original.

criteria: Excel.ReplaceCriteria

Criterios de reemplazo adicionales.

Devoluciones

OfficeExtension.ClientResult<number>

El número de reemplazos realizados.

Comentarios

[Conjunto de API: ExcelApi 1.9]

select()

Selecciona el intervalo especificado en la interfaz de usuario de Excel.

select(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.1]

set(properties, options)

Establece varias propiedades de un objeto al mismo tiempo. Puede pasar un objeto sin formato con las propiedades adecuadas u otro objeto API del mismo tipo.

set(properties: Interfaces.RangeUpdateData, options?: OfficeExtension.UpdateOptions): void;

Parámetros

properties: Excel.Interfaces.RangeUpdateData

Un objeto JavaScript con propiedades que están estructuradas isomorfamente a las propiedades del objeto en el que se llama al método.

options: OfficeExtension.UpdateOptions

Proporciona una opción para suprimir errores si el objeto properties intenta establecer propiedades de solo lectura.

Devoluciones

void

set(properties)

Establece varias propiedades en el objeto al mismo tiempo, basadas en un objeto cargado existente.

set(properties: Excel.Range): void;

Parámetros

properties: Excel.Range

Devoluciones

void

setCellProperties(cellPropertiesData)

Actualiza las novedades del rango en función de una matriz 2D de propiedades de celda, encapsulando elementos como fuente, relleno, bordes y alineación.

setCellProperties(cellPropertiesData: SettableCellProperties[][]): void;

Parámetros

cellPropertiesData: Excel.SettableCellProperties[][]

Una matriz 2D que representa qué propiedades establecer en cada celda.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

setColumnProperties(columnPropertiesData)

Novedades el rango en función de una matriz unidimensional de propiedades de columna, encapsulando elementos como la fuente, el relleno, los bordes y la alineación.

setColumnProperties(columnPropertiesData: SettableColumnProperties[]): void;

Parámetros

columnPropertiesData: Excel.SettableColumnProperties[]

Una matriz que representa qué propiedades establecer en cada columna.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

setDirty()

Establece un intervalo que se deberá actualizar cuando se realice la próxima actualización.

setDirty(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

setRowProperties(rowPropertiesData)

Novedades el rango en función de una matriz unidimensional de propiedades de fila, encapsulando elementos como fuente, relleno, bordes y alineación.

setRowProperties(rowPropertiesData: SettableRowProperties[]): void;

Parámetros

rowPropertiesData: Excel.SettableRowProperties[]

Una matriz que representa qué propiedades establecer en cada fila.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.9]

showCard()

Muestra la tarjeta de una celda activa si tiene contenido de valor enriquecido.

showCard(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.7]

showGroupDetails(groupOption)

Muestra los detalles del grupo de filas o columnas.

showGroupDetails(groupOption: Excel.GroupOption): void;

Parámetros

groupOption: Excel.GroupOption

Especifica si se mostrarán los detalles de las filas o columnas agrupadas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

showGroupDetails(groupOption)

Muestra los detalles del grupo de filas o columnas.

showGroupDetails(groupOption: "ByRows" | "ByColumns"): void;

Parámetros

groupOption: "ByRows" | "ByColumns"

Especifica si se mostrarán los detalles de las filas o columnas agrupadas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

toJSON()

Reemplaza el método JavaScript toJSON() para proporcionar una salida más útil cuando se pasa un objeto API a JSON.stringify(). (JSON.stringify, a su vez, llama al toJSON método del objeto que se le pasa). Mientras que el objeto original Excel.Range es un objeto API, el toJSON método devuelve un objeto JavaScript simple (escrito como Excel.Interfaces.RangeData) que contiene copias superficiales de cualquier propiedad secundaria cargada del objeto original.

toJSON(): Excel.Interfaces.RangeData;

Devoluciones

Excel.Interfaces.RangeData

track()

Realiza un seguimiento del objeto de ajuste automático según cambios adyacentes en el documento. Esta llamada es una abreviatura de context.trackedObjects.add(thisObject). Si usa este objeto entre .sync llamadas y fuera de la ejecución secuencial de un lote ".run" y recibe un error "InvalidObjectPath" al establecer una propiedad o invocar un método en el objeto, debe agregar el objeto a la colección de objetos objeto de seguimiento cuando se creó el objeto por primera vez.

track(): Excel.Range;

Devoluciones

Excel.Range

ungroup(groupOption)

Desagrupa las columnas y filas para obtener un esquema.

ungroup(groupOption: Excel.GroupOption): void;

Parámetros

groupOption: Excel.GroupOption

Especifica cómo se puede desagrupar el rango por filas o columnas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

ungroup(groupOption)

Desagrupa las columnas y filas para obtener un esquema.

ungroup(groupOption: "ByRows" | "ByColumns"): void;

Parámetros

groupOption: "ByRows" | "ByColumns"

Especifica cómo se puede desagrupar el rango por filas o columnas.

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.10]

unmerge()

Separa las celdas del intervalo en celdas independientes.

unmerge(): void;

Devoluciones

void

Comentarios

[Conjunto de API: ExcelApi 1.2]

untrack()

Libere la memoria asociada a este objeto, si se ha realizado un seguimiento de él anteriormente. Esta llamada es la abreviatura de context.trackedObjects.remove(thisObject). Tener muchos objetos marcados ralentiza la aplicación host, así que debe recordar liberar los objetos que agregue cuando haya terminado con ellos. Deberá llamar context.sync() antes de que la liberación de memoria surta efecto.

untrack(): Excel.Range;

Devoluciones

Excel.Range

Comentarios

Propiedades

Métodos

Detalles de las propiedades

address

Valor de propiedad

Comentarios

addressLocal

Valor de propiedad

Comentarios

cellCount

Valor de propiedad

Comentarios

columnCount

Valor de propiedad

Comentarios

columnHidden

Valor de propiedad

Comentarios

columnIndex

Valor de propiedad

Comentarios

conditionalFormats

Valor de propiedad

Comentarios

context

Valor de propiedad

control

Valor de propiedad

Comentarios

dataValidation

Valor de propiedad

Comentarios

format

Valor de propiedad

Comentarios

formulas

Valor de propiedad

Comentarios

formulasLocal

Valor de propiedad

Comentarios

formulasR1C1

Valor de propiedad

Comentarios

hasSpill

Valor de propiedad

Comentarios

height

Valor de propiedad

Comentarios

hidden

Valor de propiedad

Comentarios

hyperlink

Valor de propiedad

Comentarios

isEntireColumn

Valor de propiedad

Comentarios

isEntireRow

Valor de propiedad

Comentarios

left

Valor de propiedad

Comentarios

linkedDataTypeState

Valor de propiedad

Comentarios

numberFormat

Valor de propiedad

Comentarios

numberFormatCategories

Valor de propiedad

Comentarios

numberFormatLocal

Valor de propiedad

Comentarios

rowCount