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_regionRenvoie 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.
hyperlinksObtient tous les liens hypertexte de la plage.
row_countObtient le nombre de lignes dans la plage.
column_countObtient le nombre de colonnes dans la plage.
nameObtient ou définit le nom de la plage.
refers_toObtient la référence à la plage.
addressObtient l’adresse de la plage.
leftObtient la distance, en points, entre le bord gauche de la colonne A et le bord gauche de la plage.
topObtient la distance, en points, entre le bord supérieur de la ligne 1 et le bord supérieur de la plage.
widthObtient la largeur d’une plage en points.
heightObtient la largeur d’une plage en points.
first_rowObtient l’index de la première ligne de la plage.
first_columnObtient l’index de la première colonne de la plage.
valueObtient et définit la valeur de la plage.
column_widthDéfinit ou obtient la largeur de colonne de cette plage
row_heightDéfinit ou obtient la hauteur des lignes dans cette plage
entire_columnObtient un objet Range qui représente la ou les colonnes entières contenant la plage spécifiée.
entire_rowObtient un objet Range qui représente la ou les lignes entières contenant la plage spécifiée.
worksheetObtient l’objet Range.worksheet qui contient cette plage.

Méthodes

MéthodeDescription
auto_fillRemplissez automatiquement la plage cible.
auto_fillRemplissez automatiquement la plage cible.
set_styleAppliquez le style de cellule.
set_styleDéfinit le style de la plage.
set_outline_bordersDé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_bordersDé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_bordersDéfinit les bordures de ligne autour d’une plage de cellules.
set_outline_borderDéfinit la bordure du contour autour d’une plage de cellules.
set_outline_borderDéfinit la bordure du contour autour d’une plage de cellules.
copyCopie de la plage avec les options spéciales de collage.
copyCopie les données (y compris les formules), le formatage, les objets de dessin, etc. à partir d’une plage source.
add_hyperlinkAjoute un lien hypertexte vers une cellule spécifiée ou une plage de cellules.
get_enumeratorObtient l’énumérateur pour les cellules de cette plage.
is_intersectIndique si la plage est intersectée.
intersectRenvoie un objet Range qui représente l’intersection rectangulaire de deux plages.
union_rangRenvoie le résultat de l’union de deux plages.
unionRenvoie l’union de deux plages.
is_blankIndique si la plage contient des valeurs.
mergeCombine une plage de cellules en une seule cellule.
un_mergeAnnule la fusion des cellules fusionnées de cette plage.
put_valuePlace 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_styleApplique des formats pour toute une gamme.
set_inside_bordersDéfinir les limites intérieures de la plage.
move_toDéplacez la plage actuelle vers la plage de destination.
copy_dataCopie les données de cellule (y compris les formules) à partir d’une plage source.
copy_valueCopie la valeur de cellule à partir d’une plage source.
copy_styleCopie les paramètres de style à partir d’une plage source.
get_cell_or_nullObtient l’objet Cell ou null dans cette plage.
get_offsetObtient la plage Range par décalage.

Remarques

La classe Range désigne une région de la feuille de calcul Excel. Avec cela, vous pouvez formater et définir la valeur de la plage. Et vous pouvez également simplement copier une plage d’Excel.

Exemple

L’exemple suivant montre comment créer une plage et définir la valeur de la plage d’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")

Voir également