Cell classe

Cell classe

Incapsula l’oggetto che rappresenta una singola cella della cartella di lavoro.

Il tipo Cell espone i seguenti membri:

Proprietà

ProprietàDescrizione
worksheetOttiene il foglio di lavoro padre.
date_time_valueOttiene il valore DateTime contenuto nella cella.
rowOttiene il numero di riga (in base zero) della cella.
columnOttiene il numero di colonna (in base zero) della cella.
is_formulaRappresenta se la cella specificata contiene una formula.
typeRappresenta il tipo di valore della cella.
nameOttiene il nome della cella.
is_error_valueControlla se il valore di questa cella è un errore.
is_numeric_valueIndica se il valore di questa cella è numerico (int, double e datetime)
string_valueOttiene il valore stringa contenuto nella cella. Se il tipo di questa cella è stringa, restituisce il valore stringa stesso.
Per gli altri tipi di cella, verrà restituito il valore stringa formattato (formattato con lo stile specificato di questa cella).
Il valore della cella formattata è lo stesso di quello che puoi ottenere da Excel quando copi una cella come testo (come
copiare la cella nell’editor di testo o esportarla in CSV).
string_value_without_formatOttiene il valore della cella come stringa senza alcun formato.
number_category_typeRappresenta il tipo di categoria della formattazione numerica di questa cella.
display_string_valueOttiene il valore della stringa formattata di questa cella in base allo stile di visualizzazione della cella.
int_valueOttiene il valore intero contenuto nella cella.
double_valueOttiene il valore double contenuto nella cella.
float_valueOttiene il valore float contenuto nella cella.
bool_valueOttiene il valore booleano contenuto nella cella.
has_custom_styleIndica se questa cella ha impostazioni di stile personalizzate (diverse da quella predefinita ereditata
dalla riga, colonna o cartella di lavoro corrispondente).
shared_style_indexOttiene l’indice di stile condiviso della cella nel pool di stili.
formulaOttiene o imposta una formula pari a Cell.
formula_localOttieni la formula formattata in base alle impostazioni locali della cella.
r1c1_formulaOttiene o imposta una formula R1C1 di Cell.
contains_external_linkIndica se questa cella contiene un collegamento esterno.
Si applica solo quando la cella è una cella formula.
is_array_headerIndica che la formula della cella è una formula di matrice
ed è la prima cella dell’array.
is_dynamic_array_formulaIndica se la formula della cella è una formula in matrice dinamica (true) o una formula in matrice legacy (false).
is_array_formulaIndica se la formula della cella è una formula di matrice.
is_in_arrayIndica se la formula della cella è una formula di matrice.
is_shared_formulaIndica se la formula della cella fa parte di una formula condivisa.
is_table_formulaIndica se questa cella fa parte della formula della tabella.
is_in_tableIndica se questa cella fa parte della formula della tabella.
valueOttiene/imposta il valore contenuto in questa cella.
is_style_setIndica se lo stile della cella è impostato. Se restituisce false, significa che questa cella ha un formato di cella predefinito.
is_mergedControlla se una cella fa parte di un intervallo unito o meno.
commentOttiene il commento di questa cella.
html_stringOttiene e imposta la stringa html che contiene dati e alcuni formati in questa cella.
embedded_imageOttiene e imposta l’immagine incorporata nella cella.

Metodi

MetodoDescrizione
put_valueInserisce un valore booleano nella cella.
put_valueInserisce un valore intero nella cella.
put_valueInserisce un valore doppio nella cella.
put_valueInserisce un valore nella cella, se appropriato il valore verrà convertito in un altro tipo di dati e il formato numerico della cella verrà ripristinato.
put_valueInserisce un valore stringa nella cella e, se appropriato, converte il valore in un altro tipo di dati.
put_valueInserisce un valore stringa nella cella.
put_valueInserisce un valore DateTime nella cella.
put_valueInserisce un valore oggetto nella cella.
get_display_styleOttiene lo stile di visualizzazione della cella.
Se questa cella è influenzata anche da altre impostazioni come formattazione condizionale, elenco oggetti, ecc.,
quindi lo stile di visualizzazione potrebbe essere diverso da cell.GetStyle().
get_display_styleOttiene lo stile di visualizzazione della cella.
Se la cella è formattata in modo condizionale, lo stile di visualizzazione non è lo stesso di cell.GetStyle().
get_styleOttiene lo stile della cella.
get_styleSe checkBorders è vero, controlla se i bordi di altre celle influenzeranno lo stile di questa cella.
set_styleImposta lo stile della cella.
set_styleApplica la proprietà modificata di style alla cella.
set_styleApplica lo stile della cella in base ai flag.
set_formulaImposta la formula e il valore (risultato calcolato) della formula.
set_formulaImposta la formula e il valore della formula.
set_formulaImposta la formula e il valore (risultato calcolato) della formula.
set_array_formulaImposta una formula di matrice su un intervallo di celle.
set_array_formulaImposta una formula di matrice (formula di matrice legacy inserita tramite CTRL+MAIUSC+INVIO in ms Excel) su un intervallo di celle.
set_array_formulaImposta una formula di matrice su un intervallo di celle.
set_array_formulaImposta una formula di matrice su un intervallo di celle.
set_shared_formulaImposta una formula su un intervallo di celle.
set_shared_formulaImposta le formule condivise su un intervallo di celle.
set_shared_formulaImposta le formule condivise su un intervallo di celle.
set_shared_formulaImposta le formule condivise su un intervallo di celle.
get_leafsOttieni tutte le celle che fanno riferimento direttamente a questa cella e devono essere aggiornate quando questa cella viene modificata.
get_leafsOttieni tutte le celle che verranno aggiornate quando questa cella viene modificata.
set_dynamic_array_formulaImposta la formula di matrice dinamica e, se possibile, fa in modo che la formula si diffonda nelle celle vicine.
set_dynamic_array_formulaImposta la formula di matrice dinamica e, se possibile, fa in modo che la formula si diffonda nelle celle vicine.
set_dynamic_array_formulaImposta la formula di matrice dinamica e, se possibile, fa in modo che la formula si diffonda nelle celle vicine.
set_table_formulaCrea una tabella dati a due variabili per un determinato intervallo a partire da questa cella.
set_table_formulaCrea una tabella dati a una variabile per un determinato intervallo a partire da questa cella.
set_table_formulaCrea una tabella dati a due variabili per un determinato intervallo a partire da questa cella.
set_table_formulaCrea una tabella dati a una variabile per un determinato intervallo a partire da questa cella.
get_charactersRestituisce tutti gli oggetti Characters
che rappresenta un intervallo di caratteri all’interno del testo della cella.
get_charactersRestituisce tutti gli oggetti Characters
che rappresenta un intervallo di caratteri all’interno del testo della cella.
calculateCalcola la formula della cella.
get_string_valueOttiene il valore della stringa in base a una strategia formattata specifica.
get_width_of_valueOttiene la larghezza del valore in unità di pixel.
get_height_of_valueOttiene l’altezza del valore in unità di pixel.
get_format_conditionsOttiene le condizioni di formato che si applicano a questa cella.
get_formulaOttieni la formula di questa cella.
get_precedentsOttiene tutti i riferimenti visualizzati nella formula di questa cella.
get_dependentsOttieni tutte le celle la cui formula fa riferimento direttamente a questa cella.
get_precedents_in_calculationOttiene tutti i precedenti (riferimento alle celle nella cartella di lavoro corrente) utilizzati dalla formula di questa cella durante il calcolo.
get_dependents_in_calculationOttiene tutte le celle il cui risultato calcolato dipende da questa cella.
get_array_rangeOttiene l’intervallo di matrice se la formula della cella è una formula di matrice.
remove_array_formulaRimuovi la formula di matrice.
copyCopia i dati da una cella di origine.
charactersRestituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo della cella.
replaceSostituisci il testo della cella con le opzioni.
insert_textInserisci alcuni caratteri nella cella.
Se la cella è in formato RTF, questo metodo potrebbe mantenere la formattazione originale.
is_rich_textIndica se il valore stringa di questa cella è un testo in formato RTF.
set_charactersImposta il formato RTF della cella.
get_merged_rangeRestituisce un oggetto Range che rappresenta un intervallo unito.
get_html_stringOttiene la stringa html che contiene i dati e alcuni formati in questa cella.
to_jsonConverti i dati della struttura da Cell a JSON.
equalsControlla se questo oggetto si riferisce alla stessa cella con un altro oggetto cella.
get_conditional_formatting_resultOttieni il risultato della formattazione condizionale.
get_validationOttiene la convalida applicata a questa cella.
get_validation_valueOttiene il valore di convalida applicato a questa cella.
get_tableOttiene la tabella che contiene questa cella.

Esempio

from aspose.cells import TextAlignmentType, Workbook
from aspose.pydrawing import Color

excel = Workbook()
cells = excel.worksheets[0].cells
# Put a string into a cell
cell = cells.get(0, 0)
cell.put_value("Hello")
first = cell.string_value
# Put an integer into a cell
cell = cells.get("B1")
cell.put_value(12)
second = cell.int_value
# Put a double into a cell
cell = cells.get(0, 2)
cell.put_value(-1.234)
third = cell.double_value
# Put a formula into a cell
cell = cells.get("D1")
cell.formula = "=B1 + C1"
# Put a combined formula: "sum(average(b1,c1), b1)" to cell at b2
cell = cells.get("b2")
cell.formula = "=sum(average(b1,c1), b1)"
# Set style of a cell
style = cell.get_style()
# Set background color
style.background_color = Color.yellow
# Set format of a cell
style.font.name = "Courier New"
style.vertical_alignment = TextAlignmentType.TOP
cell.set_style(style)

Guarda anche