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

Propiedad	Descripción
current_region	Devuelve 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.
hyperlinks	Obtiene todos los hipervínculos en el rango.
row_count	Obtiene el recuento de filas en el rango.
column_count	Obtiene el recuento de columnas en el rango.
name	Obtiene o establece el nombre del rango.
refers_to	Obtiene el rango al que se refiere.
address	Obtiene la dirección del rango.
left	Obtiene la distancia, en puntos, desde el borde izquierdo de la columna A hasta el borde izquierdo del rango.
top	Obtiene la distancia, en puntos, desde el borde superior de la fila 1 hasta el borde superior del rango.
width	Obtiene el ancho de un rango en puntos.
height	Obtiene el ancho de un rango en puntos.
first_row	Obtiene el índice de la primera fila del rango.
first_column	Obtiene el índice de la primera columna del rango.
value	Obtiene y establece el valor del rango.
column_width	Establece u obtiene el ancho de columna de este rango
row_height	Establece u obtiene la altura de las filas en este rango
entire_column	Obtiene un objeto Range que representa la columna (o columnas) completa que contiene el rango especificado.
entire_row	Obtiene un objeto Range que representa la fila (o filas) completa que contiene el rango especificado.
worksheet	Obtiene el objeto `Range.worksheet` que contiene este rango.

Métodos

Método	Descripció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

módulo aspose.cells
clase Cell
clase Range

QueryTableCollection clase RangeCollection clase