Range clase

Range clase

Encapsula el objeto que representa un rango de celdas dentro de una hoja de cálculo.

El tipo Range expone los siguientes miembros:

Propiedades

PropiedadDescripción
current_regionDevuelve un objeto Range que representa la región actual.
La región actual es un rango delimitado por cualquier combinación de filas y columnas en blanco.
hyperlinksObtiene todos los hipervínculos del rango.
row_countObtiene el recuento de filas del rango.
column_countObtiene el recuento de columnas del rango.
nameObtiene o establece el nombre del rango.
refers_toObtiene el rango al que se refiere.
addressObtiene la dirección del rango.
leftObtiene la distancia, en puntos, desde el borde izquierdo de la columna A hasta el borde izquierdo del rango.
topObtiene la distancia, en puntos, desde el borde superior de la fila 1 hasta el borde superior del rango.
widthObtiene el ancho de un rango en puntos.
heightObtiene el ancho de un rango en puntos.
first_rowObtiene el índice de la primera fila del rango.
first_columnObtiene el índice de la primera columna del rango.
valueObtiene y establece el valor del rango.
column_widthEstablece u obtiene el ancho de columna de este rango
row_heightEstablece u obtiene la altura de las filas en este rango
entire_columnObtiene un objeto Range que representa la columna (o columnas) completa que contiene el rango especificado.
entire_rowObtiene un objeto Range que representa la fila (o filas) completa que contiene el rango especificado.
worksheetObtiene el objeto Range.worksheet que contiene este rango.

Métodos

MétodoDescripción
auto_fillCompleta automáticamente el rango objetivo.
auto_fillCompleta automáticamente el rango objetivo.
set_styleAplicar el estilo de celda.
set_styleEstablece el estilo del rango.
set_outline_bordersEstablece los bordes del contorno alrededor de un rango de celdas con el mismo estilo y color de borde.
set_outline_bordersEstablece los bordes del contorno alrededor de un rango de celdas con el mismo estilo y color de borde.
set_outline_bordersEstablece límites de línea alrededor de un rango de celdas.
set_outline_borderEstablece el borde del contorno alrededor de un rango de celdas.
set_outline_borderEstablece el borde del contorno alrededor de un rango de celdas.
copyCopiando el rango con opciones especiales de pegado.
copyCopia datos (incluidas fórmulas), formateo, objetos de dibujo, etc. desde un rango de origen.
add_hyperlinkAgrega un hipervínculo a una celda específica o a un rango de celdas.
get_enumeratorObtiene el enumerador de las celdas de este rango.
is_intersectIndica si el rango se cruza.
intersectDevuelve un objeto Range que representa la intersección rectangular de dos rangos.
union_rangDevuelve el resultado de la unión de dos rangos.
unionDevuelve la unión de dos rangos.
is_blankIndica si el rango contiene valores.
mergeCombina una variedad de celdas en una sola celda.
un_mergeDesintegra las celdas fusionadas de este rango.
put_valueColoca un valor en el rango; si corresponde, el valor se convertirá a otro tipo de datos y se restablecerá el formato del número de celda.
apply_styleAplica formatos para toda una gama.
set_inside_bordersEstablecer dentro de los límites del rango.
move_toMueve el rango actual al rango de destino.
copy_dataCopia datos de celda (incluidas fórmulas) de un rango de origen.
copy_valueCopia el valor de la celda de un rango de origen.
copy_styleCopia la configuración de estilo de un rango de origen.
get_cell_or_nullObtiene Cell objeto o nulo en este rango.
get_offsetObtiene el rango Range por desplazamiento.

Observaciones

La clase Range denota una región de la hoja de cálculo de Excel. Con esto, puede formatear y establecer el valor del rango. Y también puedes simplemente copiar el rango de Excel.

Ejemplo

El siguiente ejemplo muestra cómo crear un rango y establecer el valor del rango de Excel.

from aspose.cells import Workbook

# Instantiating a Workbook object
workbook = Workbook()
#  Get the first Worksheet Cells.
cells = workbook.worksheets[0].cells
#  Create a range (A1:D3).
range = cells.create_range("A1", "D3")
#  Set value to the range.
range.value = "Hello"
# Save the Excel file
workbook.save("book1.xlsm")

Ver también