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. L’area 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 le righe) che contengono l’intervallo specificato.
worksheet	Ottiene l’oggetto `Range.worksheet` che contiene questo intervallo.

Metodi

Metodo	Descrizione
`auto_fill(self, target)`	Riempi automaticamente l’intervallo di destinazione.
`auto_fill(self, target, auto_fill_type)`	Riempi automaticamente l’intervallo di destinazione.
`set_style(self, style, explicit_flag)`	Applica lo stile della cella.
`set_style(self, style)`	Imposta lo stile dell’intervallo.
`set_outline_borders(self, border_style, border_color)`	Imposta i bordi del contorno attorno a un intervallo di celle con lo stesso stile e colore.
`set_outline_borders(self, border_style, border_color)`	Imposta i bordi del contorno attorno a un intervallo di celle con lo stesso stile e colore.
`set_outline_borders(self, border_styles, border_colors)`	Imposta i bordi delle linee attorno a un intervallo di celle.
`set_outline_border(self, border_edge, border_style, border_color)`	Imposta il bordo attorno a un intervallo di celle.
`set_outline_border(self, border_edge, border_style, border_color)`	Imposta il bordo attorno a un intervallo di celle.
`copy(self, range, options)`	Copia dell’intervallo con le opzioni Incolla speciale.
`copy(self, range)`	Copia dati (incluse formule), formattazione, oggetti di disegno ecc. da un intervallo di origine.
`add_hyperlink(self, address, text_to_display, screen_tip)`	Aggiunge un collegamento ipertestuale a una cella specificata o a un intervallo di celle.
`is_intersect(self, range)`	Indica se l’intervallo è intersecato.
`intersect(self, range)`	Restituisce un oggetto `Range` che rappresenta l’intersezione rettangolare di due intervalli.
`union_rang(self, range)`	Restituisce il risultato dell’unione di due intervalli.
`union_ranges(self, ranges)`	Restituisce il risultato dell’unione di due intervalli.
`union(self, range)`	Restituisce l’unione di due intervalli.
`is_blank(self)`	Indica se l’intervallo contiene valori.
`merge(self)`	Combina un intervallo di celle in un’unica cella.
`un_merge(self)`	Annulla l’unione delle celle unite di questo intervallo.
`put_value(self, string_value, is_converted, set_style)`	Inserisce un valore nell’intervallo; se appropriato, il valore verrà convertito in un altro tipo di dati e il formato numerico della cella verrà reimpostato.
`apply_style(self, style, flag)`	Applica formati per un intervallo intero.
`set_inside_borders(self, border_edge, line_style, border_color)`	Impostato all’interno dei confini dell’intervallo.
`move_to(self, dest_row, dest_column)`	Sposta l’intervallo corrente nell’intervallo di destinazione.
`copy_data(self, range)`	Copia i dati delle celle (incluse le formule) da un intervallo di origine.
`copy_value(self, range)`	Copia il valore della cella da un intervallo di origine.
`copy_style(self, range)`	Copia le impostazioni di stile da un intervallo sorgente.
`transpose(self)`	Trasporre (ruotare) i dati dalle righe alle colonne o viceversa.
`get(self, row_offset, column_offset)`	Aggiungi API for Python tramite .Net. poiché questo [int, int] non è supportato
`get_cell_or_null(self, row_offset, column_offset)`	Ottiene `Cell` oggetto o null in questo intervallo.
`get_offset(self, row_offset, column_offset)`	Ottiene l’intervallo `Range` tramite offset.
`to_image(self, options)`	Converte l’intervallo in immagine.
`to_json(self, options)`	Convertire l’intervallo nel valore JSON.
`to_html(self, save_options)`	Converti l’intervallo in html.
`clear(self)`	Cancella questo intervallo.
`clear_contents(self)`	Cancella il contenuto di questo intervallo.
`clear_formats(self)`	Cancella i formati di questo intervallo.
`clear_comments(self)`	Cancella i commenti di questo intervallo.
`clear_hyperlinks(self, clear_format)`	Rimuove solo i collegamenti ipertestuali.

Osservazioni

La classe Range indica una parte del foglio di calcolo Excel. Con questo è possibile formattare e impostare il valore dell’intervallo. Puoi anche semplicemente copiare un intervallo di dati 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

QueryTableCollection classe RangeCollection classe