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 |
|---|---|
| worksheet | Ottiene il foglio di lavoro padre. |
| date_time_value | Ottiene il valore DateTime contenuto nella cella. |
| row | Ottiene il numero di riga (a partire da zero) della cella. |
| column | Ottiene il numero di colonna (a partire da zero) della cella. |
| is_formula | Indica se la cella specificata contiene una formula. |
| has_custom_function | Controlla se nella formula di questa cella è presente una funzione personalizzata (funzione non supportata). |
| type | Rappresenta il tipo di valore della cella. |
| name | Ottiene il nome della cella. |
| is_error_value | Controlla se il valore di questa cella è un errore. |
| is_numeric_value | Indica se il valore di questa cella è numerico (int, double e datetime) |
| string_value | Restituisce il valore stringa contenuto nella cella. Se il tipo di questa cella è stringa, restituisce il valore stringa stesso. Per altri tipi di cella, verrà restituito il valore stringa formattato (formattato con lo stile specificato per questa cella). Il valore della cella formattata è lo stesso che puoi ottenere da Excel quando copi una cella come testo (ad esempio copia della cella nell’editor di testo o esportazione in csv). |
| string_value_without_format | Ottiene il valore della cella come stringa senza alcun formato. |
| number_category_type | Rappresenta il tipo di categoria della formattazione numerica di questa cella. |
| display_string_value | Ottiene il valore stringa formattato di questa cella in base allo stile di visualizzazione della cella. |
| int_value | Ottiene il valore intero contenuto nella cella. |
| double_value | Ottiene il valore double contenuto nella cella. |
| float_value | Ottiene il valore float contenuto nella cella. |
| bool_value | Ottiene il valore booleano contenuto nella cella. |
| has_custom_style | Indica se questa cella ha impostazioni di stile personalizzate (diverse da quelle predefinite ereditate dalla riga, colonna o cartella di lavoro corrispondente). |
| shared_style_index | Ottiene l’indice di stile condiviso della cella nel pool di stili. |
| formula | Ottiene o imposta una formula di Cell. |
| formula_local | Ottieni la formula formattata localmente della cella. |
| r1c1_formula | Ottiene o imposta una formula R1C1 di Cell. |
| contains_external_link | Indica se questa cella contiene un collegamento esterno. Si applica solo quando la cella è una cella formula. |
| is_array_header | Indica che la formula della cella è una formula di matrice ed è la prima cella della matrice. |
| is_dynamic_array_formula | Indica se la formula della cella è una formula di matrice dinamica (true) o una formula di matrice legacy (false). |
| is_array_formula | Indica se la formula della cella è una formula di matrice. |
| is_in_array | Indica se la formula della cella è una formula di matrice. |
| is_shared_formula | Indica se la formula della cella fa parte di una formula condivisa. |
| is_table_formula | Indica se questa cella fa parte della formula della tabella. |
| is_in_table | Indica se questa cella fa parte della formula della tabella. |
| value | Ottiene/imposta il valore contenuto in questa cella. |
| is_style_set | Indica se lo stile della cella è impostato. Se restituisce “false”, significa che questa cella ha un formato predefinito. |
| is_merged | Controlla se una cella fa parte o meno di un intervallo unito. |
| comment | Ottiene il commento di questa cella. |
| html_string | Ottiene e imposta la stringa HTML che contiene dati e alcuni formati in questa cella. |
| is_check_box_style | Indica se impostare questa cella come casella di controllo. |
| embedded_image | Ottiene e imposta l’immagine incorporata nella cella. |
Metodi
| Metodo | Descrizione |
|---|---|
put_value(self, bool_value) | Inserisce un valore booleano nella cella. |
put_value(self, int_value) | Inserisce un valore intero nella cella. |
put_value(self, double_value) | Inserisce un valore doppio nella cella. |
put_value(self, string_value, is_converted, set_style) | Inserisce un valore nella cella. Se appropriato, il valore verrà convertito in un altro tipo di dati e il formato numerico della cella verrà reimpostato. |
put_value(self, string_value, is_converted) | Inserisce un valore stringa nella cella e, se appropriato, converte il valore in un altro tipo di dati. |
put_value(self, string_value) | Inserisce un valore stringa nella cella. |
put_value(self, date_time) | Inserisce un valore DateTime nella cella. |
put_value(self, object_value) | Inserisce un valore oggetto nella cella. |
get_display_style(self) | Ottiene lo stile di visualizzazione di questa cella. |
get_display_style(self, include_merged_borders) | Ottiene lo stile di visualizzazione di questa cella. |
get_display_style(self, adjacent_borders) | Ottiene lo stile di visualizzazione di questa cella. |
get_style(self) | Ottiene lo stile della cella. |
get_style(self, check_borders) | Se checkBorders è impostato su true, controlla se i bordi delle altre celle influenzeranno lo stile di questa cella. |
set_style(self, style) | Imposta lo stile della cella. |
set_style(self, style, explicit_flag) | Applica la proprietà di stile modificata alla cella. |
set_style(self, style, flag) | Applica lo stile della cella in base ai flag. |
set_formula(self, formula, value) | Imposta la formula e il valore (risultato calcolato) della formula. |
set_formula(self, formula, options) | Imposta la formula e il valore (risultato calcolato) della formula. |
set_formula(self, formula, is_r1c1, is_local, value) | Imposta la formula e il valore della formula. |
set_formula(self, formula, options, value) | Imposta la formula e il valore (risultato calcolato) della formula. |
set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local) | Imposta una formula di matrice su un intervallo di celle. |
set_array_formula(self, array_formula, row_number, column_number) | Imposta una formula di matrice (formula di matrice legacy immessa tramite CTRL+MAIUSC+INVIO in MS Excel) su un intervallo di celle. |
set_array_formula(self, array_formula, row_number, column_number, options) | Imposta una formula di matrice su un intervallo di celle. |
set_array_formula(self, array_formula, row_number, column_number, options, values) | Imposta una formula di matrice su un intervallo di celle. |
set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local) | Imposta una formula su un intervallo di celle. |
set_shared_formula(self, shared_formula, row_number, column_number) | Imposta le formule condivise su un intervallo di celle. |
set_shared_formula(self, shared_formula, row_number, column_number, options) | Imposta le formule condivise su un intervallo di celle. |
set_shared_formula(self, shared_formula, row_number, column_number, options, values) | Imposta le formule condivise su un intervallo di celle. |
get_leafs(self) | Ottieni tutte le celle che fanno riferimento direttamente a questa cella e che devono essere aggiornate quando questa cella viene modificata. |
get_leafs(self, recursive) | Ottieni tutte le celle che verranno aggiornate quando questa cella viene modificata. |
set_dynamic_array_formula(self, array_formula, options, calculate_value) | Imposta una formula di matrice dinamica e, se possibile, fa sì che la formula si estenda alle celle adiacenti. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value) | Imposta una formula di matrice dinamica e, se possibile, fa sì che la formula si estenda alle celle adiacenti. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts) | Imposta una formula di matrice dinamica e, se possibile, fa sì che la formula si estenda alle celle adiacenti. |
set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values) | Crea una tabella dati a due variabili per l’intervallo specificato a partire da questa cella. |
set_table_formula(self, row_number, column_number, input_cell, is_row_input, values) | Crea una tabella dati a una variabile per l’intervallo specificato a partire da questa cella. |
set_table_formula(self, row_number, column_number, row_index_of_row_input_cell, column_index_of_row_input_cell, row_index_of_column_input_cell, column_index_of_column_input_cell, values) | Crea una tabella dati a due variabili per l’intervallo specificato a partire da questa cella. |
set_table_formula(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values) | Crea una tabella dati a una variabile per l’intervallo specificato a partire da questa cella. |
get_characters(self) | Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo della cella. |
get_characters(self, flag) | Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo della cella. |
calculate(self, options) | Calcola la formula della cella. |
get_string_value(self, format_strategy) | Ottiene il valore stringa tramite una strategia di formattazione specifica. |
get_width_of_value(self) | Ottiene la larghezza del valore in unità di pixel. |
get_height_of_value(self) | Ottiene l’altezza del valore in unità di pixel. |
get_format_conditions(self) | Ottiene le condizioni di formato che si applicano a questa cella. |
get_formula(self, is_r1c1, is_local) | Ottieni la formula di questa cella. |
get_precedents(self) | Ottiene tutti i riferimenti presenti nella formula di questa cella. |
get_dependents(self, is_all) | Ottieni tutte le celle la cui formula fa riferimento direttamente a questa cella. |
get_precedents_in_calculation(self) | Ottiene tutti i precedenti (riferimenti alle celle nella cartella di lavoro corrente) utilizzati dalla formula di questa cella durante il calcolo. |
get_dependents_in_calculation(self, recursive) | Ottiene tutte le celle il cui risultato calcolato dipende da questa cella. |
get_array_range(self) | Ottiene l’intervallo della matrice se la formula della cella è una formula di matrice. |
remove_array_formula(self, leave_normal_formula) | Rimuovi la formula matrice. |
copy(self, cell) | Copia i dati da una cella sorgente. |
characters(self, start_index, length) | Restituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo della cella. |
replace(self, place_holder, new_value, options) | Sostituisci il testo della cella con le opzioni. |
insert_text(self, index, text) | Inserire alcuni caratteri nella cella. Se la cella è formattata in modo avanzato, questo metodo potrebbe mantenere la formattazione originale. |
is_rich_text(self) | Indica se il valore stringa di questa cella è un testo formattato. |
set_characters(self, characters) | Imposta il formato RTF della cella. |
get_merged_range(self) | Restituisce un oggetto Range che rappresenta un intervallo unito. |
get_html_string(self, html5) | Ottiene la stringa HTML che contiene dati e alcuni formati in questa cella. |
to_json(self) | Converti i dati della struttura Cell in JSON. |
equals(self, cell) | Controlla se questo oggetto fa riferimento alla stessa cella con un altro oggetto cella. |
get_conditional_formatting_result(self) | Ottieni il risultato della formattazione condizionale. |
get_validation(self) | Ottiene la convalida applicata a questa cella. |
get_validation_value(self) | Ottiene il valore di convalida applicato a questa cella. |
get_table(self) | Ottiene la tabella che contiene questa cella. |
get_rich_value(self) | Ottiene il valore aggiunto della 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
- modulo
aspose.cells - classe
Cell - classe
Range
