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