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 en el rango.
row_countObtiene el recuento de filas en el rango.
column_countObtiene el recuento de columnas en el 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_fill(self, target)Rellene automáticamente el rango objetivo.
auto_fill(self, target, auto_fill_type)Rellene automáticamente el rango objetivo.
set_style(self, style, explicit_flag)Aplicar el estilo de celda.
set_style(self, style)Establece el estilo del rango.
set_outline_borders(self, border_style, border_color)Establece los bordes del contorno alrededor de un rango de celdas con el mismo estilo y color de borde.
set_outline_borders(self, border_style, border_color)Establece los bordes del contorno alrededor de un rango de celdas con el mismo estilo y color de borde.
set_outline_borders(self, border_styles, border_colors)Establece límites de líneas alrededor de un rango de celdas.
set_outline_border(self, border_edge, border_style, border_color)Establece un borde de contorno alrededor de un rango de celdas.
set_outline_border(self, border_edge, border_style, border_color)Establece un borde de contorno alrededor de un rango de celdas.
copy(self, range, options)Copiar el rango con opciones especiales de pegado.
copy(self, range)Copia datos (incluidas fórmulas), formatos, objetos de dibujo, etc. de un rango de origen.
add_hyperlink(self, address, text_to_display, screen_tip)Agrega un hipervínculo a una celda específica o a un rango de celdas.
is_intersect(self, range)Indica si el rango es de intersección.
intersect(self, range)Devuelve un objeto Range que representa la intersección rectangular de dos rangos.
union_rang(self, range)Devuelve el resultado de la unión de dos rangos.
union_ranges(self, ranges)Devuelve el resultado de la unión de dos rangos.
union(self, range)Devuelve la unión de dos rangos.
is_blank(self)Indica si el rango contiene valores.
merge(self)Combina un rango de celdas en una sola celda.
un_merge(self)Desfusiona las celdas fusionadas de este rango.
put_value(self, string_value, is_converted, set_style)Coloca un valor en el rango, si corresponde, el valor se convertirá a otro tipo de datos y se restablecerá el formato de número de la celda.
apply_style(self, style, flag)Aplica formatos para toda una gama.
set_inside_borders(self, border_edge, line_style, border_color)Situado dentro de los límites del rango.
move_to(self, dest_row, dest_column)Mueve el rango actual al rango de destino.
copy_data(self, range)Copia datos de celdas (incluidas fórmulas) de un rango de origen.
copy_value(self, range)Copia el valor de celda de un rango de origen.
copy_style(self, range)Copia configuraciones de estilo desde un rango de origen.
transpose(self)Transponer (rotar) datos de filas a columnas o viceversa.
get(self, row_offset, column_offset)Agregar API for Python a través de .Net.ya que este [int, int] no es compatible
get_cell_or_null(self, row_offset, column_offset)Obtiene el objeto Cell o nulo en este rango.
get_offset(self, row_offset, column_offset)Obtiene el rango Range por desplazamiento.
to_image(self, options)Convierte el rango en imagen.
to_json(self, options)Convierte el rango al valor JSON.
to_html(self, save_options)Convierte el rango a html.
clear(self)Borra este rango.
clear_contents(self)Borra el contenido de este rango.
clear_formats(self)Borra los formatos de este rango.
clear_comments(self)Borra los comentarios de este rango.
clear_hyperlinks(self, clear_format)Sólo elimina hipervínculos.

Observaciones

La clase Range denota una región de la hoja de cálculo de Excel. Con esto, puedes formatear y establecer el valor del rango. Y también puedes simplemente copiar un 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