Range classe

Range classe

Incapsula l’oggetto che rappresenta un intervallo di celle all’interno di un foglio di calcolo.

Il tipo Range espone i seguenti membri:

Proprietà

Proprietà	Descrizione
current_region	Restituisce un oggetto Range che rappresenta la regione corrente. La regione corrente è un intervallo delimitato da qualsiasi combinazione di righe e colonne vuote.
hyperlinks	Ottiene tutti i collegamenti ipertestuali nell’intervallo.
row_count	Ottiene il conteggio delle righe nell’intervallo.
column_count	Ottiene il conteggio delle colonne nell’intervallo.
name	Ottiene o imposta il nome dell’intervallo.
refers_to	Ottiene l’intervallo a cui si riferisce.
address	Ottiene l’indirizzo dell’intervallo.
left	Ottiene la distanza, in punti, dal bordo sinistro della colonna A al bordo sinistro dell’intervallo.
top	Ottiene la distanza, in punti, dal bordo superiore della riga 1 al bordo superiore dell’intervallo.
width	Ottiene la larghezza di un intervallo in punti.
height	Ottiene la larghezza di un intervallo in punti.
first_row	Ottiene l’indice della prima riga dell’intervallo.
first_column	Ottiene l’indice della prima colonna dell’intervallo.
value	Ottiene e imposta il valore dell’intervallo.
column_width	Imposta o ottiene la larghezza della colonna di questo intervallo
row_height	Imposta o ottiene l’altezza delle righe in questo intervallo
entire_column	Ottiene un oggetto Range che rappresenta l’intera colonna (o le colonne) che contiene l’intervallo specificato.
entire_row	Ottiene un oggetto Range che rappresenta l’intera riga (o righe) che contiene l’intervallo specificato.
worksheet	Ottiene l’oggetto Range.worksheet che contiene questo intervallo.

Metodi

Metodo	Descrizione
auto_fill	Riempie automaticamente l’intervallo target.
auto_fill	Riempie automaticamente l’intervallo target.
set_style	Applicare lo stile della cella.
set_style	Imposta lo stile dell’intervallo.
set_outline_borders	Imposta i bordi del contorno attorno a un intervallo di celle con lo stesso stile e colore del bordo.
set_outline_borders	Imposta i bordi del contorno attorno a un intervallo di celle con lo stesso stile e colore del bordo.
set_outline_borders	Definisce i bordi della linea attorno a un intervallo di celle.
set_outline_border	Imposta il bordo del contorno attorno a un intervallo di celle.
set_outline_border	Imposta il bordo del contorno attorno a un intervallo di celle.
copy	Copia dell’intervallo con le opzioni speciali Incolla.
copy	Copia dati (incluse formule), formattazione, oggetti di disegno, ecc. da un intervallo di origine.
add_hyperlink	Aggiunge un collegamento ipertestuale a una cella specifica o a un intervallo di celle.
get_enumerator	Ottiene l’enumeratore per le celle in questo Range.
is_intersect	Indica se l’intervallo è intersecato.
intersect	Restituisce un oggetto Range che rappresenta l’intersezione rettangolare di due intervalli.
union_rang	Restituisce il risultato dell’unione di due intervalli.
union	Restituisce l’unione di due intervalli.
is_blank	Indica se l’intervallo contiene valori.
merge	Combina un intervallo di celle in un’unica cella.
un_merge	Separa le celle unite di questo intervallo.
put_value	Inserisce un valore nell’intervallo, se appropriato il valore verrà convertito in un altro tipo di dati e il formato del numero della cella verrà ripristinato.
apply_style	Applica i formati per un’intera gamma.
set_inside_borders	Impostato all’interno dei confini dell’intervallo.
move_to	Sposta l’intervallo corrente nell’intervallo di destinazione.
copy_data	Copia i dati della cella (comprese le formule) da un intervallo di origine.
copy_value	Copia il valore della cella da un intervallo di origine.
copy_style	Copia le impostazioni di stile da un intervallo di origine.
get_cell_or_null	Ottiene l’oggetto Cell o null in questo intervallo.
get_offset	Ottiene l’intervallo Range per offset.

Osservazioni

La classe Range denota una regione del foglio di calcolo Excel. Con questo, puoi formattare e impostare il valore dell’intervallo. E puoi semplicemente copiare anche l’intervallo di Excel.

Esempio

L’esempio seguente mostra come creare un intervallo e impostare il valore dell’intervallo di 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")

Guarda anche

• modulo aspose.cells
• classe Cell
• classe Range