Range classe

Range classe

Encapsule l’objet qui représente une plage de cellules dans une feuille de calcul.

Le type Range expose les membres suivants :

Propriétés

Propriété Description
current_region Renvoie un objet Range qui représente la région actuelle.
La région actuelle est une plage délimitée par n’importe quelle combinaison de lignes vides et de colonnes vides.
hyperlinks Obtient tous les liens hypertexte de la plage.
row_count Obtient le nombre de lignes dans la plage.
column_count Obtient le nombre de colonnes dans la plage.
cell_count Obtient tout le nombre de cellules dans la plage.
name Obtient ou définit le nom de la plage.
refers_to Obtient les références de la plage.
address Obtient l’adresse de la plage.
left Obtient la distance, en points, entre le bord gauche de la colonne A et le bord gauche de la plage.
top Obtient la distance, en points, entre le bord supérieur de la ligne 1 et le bord supérieur de la plage.
width Obtient la largeur d’une plage en points.
height Obtient la largeur d’une plage en points.
first_row Obtient l’index de la première ligne de la plage.
first_column Obtient l’index de la première colonne de la plage.
value Obtient et définit la valeur de la plage.
column_width Définit ou obtient la largeur de colonne de cette plage
row_height Définit ou obtient la hauteur des lignes dans cette plage
entire_column Obtient un objet Range qui représente la ou les colonnes entières contenant la plage spécifiée.
entire_row Obtient un objet Range qui représente la ligne entière (ou les lignes) contenant la plage spécifiée.
worksheet Obtient l’objet Range.worksheet qui contient cette plage.

Méthodes

Méthode Description
auto_fill(target) Remplit automatiquement la plage cible.
auto_fill(target, auto_fill_type) Remplit automatiquement la plage cible.
set_style(style, explicit_flag) Appliquez le style de cellule.
set_style(style) Définit le style de la plage.
set_outline_borders(border_style, border_color) Définit les bordures de contour autour d’une plage de cellules avec le même style et la même couleur de bordure.
set_outline_borders(border_style, border_color) Définit les bordures de contour autour d’une plage de cellules avec le même style et la même couleur de bordure.
set_outline_borders(border_styles, border_colors) Définit des bordures de ligne autour d’une plage de cellules.
set_outline_border(border_edge, border_style, border_color) Définit une bordure de contour autour d’une plage de cellules.
set_outline_border(border_edge, border_style, border_color) Définit une bordure de contour autour d’une plage de cellules.
copy(range, options) Copie de la plage avec des options spéciales de collage.
copy(range) Copie les données (y compris les formules), la mise en forme, les objets de dessin, etc. à partir d’une plage source.
get_enumerator() Obtient l’énumérateur des cellules de cette plage.
is_intersect(range) Indique si la plage est intersectée.
intersect(range) Renvoie un objet Range qui représente l’intersection rectangulaire de deux plages.
union(range) Renvoie l’union de deux plages.
merge() Combine une plage de cellules en une seule cellule.
un_merge() Annule la fusion des cellules fusionnées de cette plage.
put_value(string_value, is_converted, set_style) Met une valeur dans la plage, le cas échéant, la valeur sera convertie en un autre type de données et le format numérique de la cellule sera réinitialisé.
apply_style(style, flag) Applique des formats pour toute une gamme.
set_inside_borders(border_edge, line_style, border_color) Définir les bordures intérieures de la plage.
move_to(dest_row, dest_column) Déplacez la plage actuelle vers la plage de destination.
copy_data(range) Copie les données de cellule (y compris les formules) à partir d’une plage source.
copy_value(range) Copie la valeur de la cellule à partir d’une plage source.
copy_style(range) Copie les paramètres de style d’une plage source.
get_cell_or_null(row_offset, column_offset) Obtient Cell objet ou null dans cette plage.
get_offset(row_offset, column_offset) Obtient la plage Range par décalage.

Exemple

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

Voir également