Cell Klasse

Cell Klasse

Kapselt das Objekt, das eine einzelne Arbeitsmappenzelle darstellt.

Der Typ Cell macht die folgenden Member verfügbar:

Eigenschaften

EigentumBeschreibung
worksheetRuft das übergeordnete Arbeitsblatt ab.
date_time_valueRuft den in der Zelle enthaltenen DateTime-Wert ab.
rowRuft die Zeilennummer (nullbasiert) der Zelle ab.
columnRuft die Spaltennummer (nullbasiert) der Zelle ab.
is_formulaGibt an, ob die angegebene Zelle eine Formel enthält.
has_custom_functionÜberprüft, ob die Formel dieser Zelle eine benutzerdefinierte Funktion (nicht unterstützte Funktion) enthält.
typeStellt den Zellenwerttyp dar.
nameRuft den Namen der Zelle ab.
is_error_valueÜberprüft, ob der Wert dieser Zelle ein Fehler ist.
is_numeric_valueGibt an, ob der Wert dieser Zelle numerisch ist (int, double und datetime)
string_valueRuft den in der Zelle enthaltenen Zeichenfolgenwert ab. Wenn der Zellentyp Zeichenfolge ist, wird der Zeichenfolgenwert selbst zurückgegeben.
Für andere Zelltypen wird der formatierte Zeichenfolgenwert (formatiert mit dem angegebenen Stil dieser Zelle) zurückgegeben.
Der formatierte Zellenwert ist derselbe wie der, den Sie in Excel erhalten, wenn Sie eine Zelle als Text kopieren (z. B.
Zelle in Texteditor kopieren oder in CSV exportieren).
string_value_without_formatRuft den Zellenwert als Zeichenfolge ohne Format ab.
number_category_typeStellt den Kategorietyp der Zahlenformatierung dieser Zelle dar.
display_string_valueRuft den formatierten Zeichenfolgenwert dieser Zelle anhand des Anzeigestils der Zelle ab.
int_valueRuft den in der Zelle enthaltenen Ganzzahlwert ab.
double_valueRuft den in der Zelle enthaltenen Double-Wert ab.
float_valueRuft den in der Zelle enthaltenen Gleitkommawert ab.
bool_valueRuft den in der Zelle enthaltenen Booleschen Wert ab.
has_custom_styleGibt an, ob diese Zelle benutzerdefinierte Stileinstellungen hat (anders als die übernommenen Standardeinstellungen).
aus der entsprechenden Zeile, Spalte oder Arbeitsmappe).
shared_style_indexRuft den gemeinsamen Stilindex der Zelle im Stilpool ab.
formulaRuft eine Formel vom Typ Cell ab oder legt diese fest.
formula_localRuft die lokal formatierte Formel der Zelle ab.
r1c1_formulaRuft eine R1C1-Formel des Cell ab oder legt diese fest.
contains_external_linkGibt an, ob diese Zelle einen externen Link enthält.
Gilt nur, wenn die Zelle eine Formelzelle ist.
is_array_headerGibt an, dass die Formel der Zelle eine Array-Formel ist
und es ist die erste Zelle des Arrays.
is_dynamic_array_formulaGibt an, ob es sich bei der Formel der Zelle um eine dynamische Arrayformel (true) oder eine herkömmliche Arrayformel (false) handelt.
is_array_formulaGibt an, ob es sich bei der Zellenformel um eine Arrayformel handelt.
is_in_arrayGibt an, ob es sich bei der Zellenformel um eine Arrayformel handelt.
is_shared_formulaGibt an, ob die Zellformel Teil einer gemeinsam genutzten Formel ist.
is_table_formulaGibt an, ob diese Zelle Teil einer Tabellenformel ist.
is_in_tableGibt an, ob diese Zelle Teil einer Tabellenformel ist.
valueRuft den in dieser Zelle enthaltenen Wert ab/legt ihn fest.
is_style_setGibt an, ob der Stil der Zelle festgelegt ist. Wenn „false“ zurückgegeben wird, bedeutet dies, dass diese Zelle ein Standardzellenformat hat.
is_mergedÜberprüft, ob eine Zelle Teil eines zusammengeführten Bereichs ist oder nicht.
commentRuft den Kommentar dieser Zelle ab.
html_stringRuft die HTML-Zeichenfolge ab und legt sie fest, die Daten und einige Formate in dieser Zelle enthält.
is_check_box_styleGibt an, ob diese Zelle als Kontrollkästchen festgelegt werden soll.
embedded_imageRuft das eingebettete Bild in der Zelle ab und legt es fest.

Methoden

MethodeBeschreibung
put_value(self, bool_value)Fügt einen Booleschen Wert in die Zelle ein.
put_value(self, int_value)Fügt einen ganzzahligen Wert in die Zelle ein.
put_value(self, double_value)Fügt einen doppelten Wert in die Zelle ein.
put_value(self, string_value, is_converted, set_style)Fügt einen Wert in die Zelle ein. Gegebenenfalls wird der Wert in einen anderen Datentyp konvertiert und das Zahlenformat der Zelle wird zurückgesetzt.
put_value(self, string_value, is_converted)Fügt einen Zeichenfolgenwert in die Zelle ein und konvertiert den Wert gegebenenfalls in einen anderen Datentyp.
put_value(self, string_value)Fügt einen Zeichenfolgenwert in die Zelle ein.
put_value(self, date_time)Fügt einen DateTime-Wert in die Zelle ein.
put_value(self, object_value)Fügt einen Objektwert in die Zelle ein.
get_display_style(self)Ruft den Anzeigestil dieser Zelle ab.
get_display_style(self, include_merged_borders)Ruft den Anzeigestil dieser Zelle ab.
get_display_style(self, adjacent_borders)Ruft den Anzeigestil dieser Zelle ab.
get_style(self)Ruft den Zellenstil ab.
get_style(self, check_borders)Wenn checkBorders wahr ist, prüfen Sie, ob die Ränder anderer Zellen den Stil dieser Zelle beeinflussen.
set_style(self, style)Legt den Zellenstil fest.
set_style(self, style, explicit_flag)Wenden Sie die geänderte Stileigenschaft auf die Zelle an.
set_style(self, style, flag)Wenden Sie den Zellenstil basierend auf Flaggen an.
set_formula(self, formula, value)Legen Sie die Formel und den Wert (berechnetes Ergebnis) der Formel fest.
set_formula(self, formula, options)Legen Sie die Formel und den Wert (berechnetes Ergebnis) der Formel fest.
set_formula(self, formula, is_r1c1, is_local, value)Legen Sie die Formel und den Wert der Formel fest.
set_formula(self, formula, options, value)Legen Sie die Formel und den Wert (berechnetes Ergebnis) der Formel fest.
set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local)Legt eine Matrixformel für einen Zellbereich fest.
set_array_formula(self, array_formula, row_number, column_number)Legt eine Arrayformel (alte Arrayformel, die in MS Excel über STRG+UMSCHALT+EINGABE eingegeben wurde) für einen Zellbereich fest.
set_array_formula(self, array_formula, row_number, column_number, options)Legt eine Matrixformel für einen Zellbereich fest.
set_array_formula(self, array_formula, row_number, column_number, options, values)Legt eine Matrixformel für einen Zellbereich fest.
set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local)Legt eine Formel für einen Zellbereich fest.
set_shared_formula(self, shared_formula, row_number, column_number)Legt gemeinsame Formeln für einen Zellbereich fest.
set_shared_formula(self, shared_formula, row_number, column_number, options)Legt gemeinsame Formeln für einen Zellbereich fest.
set_shared_formula(self, shared_formula, row_number, column_number, options, values)Legt gemeinsame Formeln für einen Zellbereich fest.
get_leafs(self)Rufen Sie alle Zellen ab, die direkt auf diese Zelle verweisen und aktualisiert werden müssen, wenn diese Zelle geändert wird.
get_leafs(self, recursive)Ruft alle Zellen ab, die aktualisiert werden, wenn diese Zelle geändert wird.
set_dynamic_array_formula(self, array_formula, options, calculate_value)Legt eine dynamische Array-Formel fest und sorgt dafür, dass die Formel, wenn möglich, in benachbarte Zellen überläuft.
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value)Legt eine dynamische Array-Formel fest und sorgt dafür, dass die Formel, wenn möglich, in benachbarte Zellen überläuft.
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts)Legt eine dynamische Array-Formel fest und sorgt dafür, dass die Formel, wenn möglich, in benachbarte Zellen überläuft.
set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values)Erstellen Sie ausgehend von dieser Zelle eine Datentabelle mit zwei Variablen für den angegebenen Bereich.
set_table_formula(self, row_number, column_number, input_cell, is_row_input, values)Erstellen Sie eine Datentabelle mit einer Variable für einen bestimmten Bereich, beginnend mit dieser Zelle.
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)Erstellen Sie ausgehend von dieser Zelle eine Datentabelle mit zwei Variablen für den angegebenen Bereich.
set_table_formula(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values)Erstellen Sie eine Datentabelle mit einer Variable für einen bestimmten Bereich, beginnend mit dieser Zelle.
get_characters(self)Gibt alle Characters-Objekte zurück
das einen Zeichenbereich innerhalb des Zellentextes darstellt.
get_characters(self, flag)Gibt alle Characters-Objekte zurück
das einen Zeichenbereich innerhalb des Zellentextes darstellt.
calculate(self, options)Berechnet die Formel der Zelle.
get_string_value(self, format_strategy)Ruft den Zeichenfolgenwert anhand einer bestimmten Formatierungsstrategie ab.
get_width_of_value(self)Ruft die Breite des Werts in Pixeln ab.
get_height_of_value(self)Ruft die Höhe des Werts in Pixeln ab.
get_format_conditions(self)Ruft die Formatierungsbedingungen ab, die für diese Zelle gelten.
get_formula(self, is_r1c1, is_local)Holen Sie sich die Formel dieser Zelle.
get_precedents(self)Ruft alle Referenzen ab, die in der Formel dieser Zelle vorkommen.
get_dependents(self, is_all)Holen Sie sich alle Zellen, deren Formel direkt auf diese Zelle verweist.
get_precedents_in_calculation(self)Ruft alle Präzedenzfälle (Verweise auf Zellen in der aktuellen Arbeitsmappe) ab, die von der Formel dieser Zelle während der Berechnung verwendet werden.
get_dependents_in_calculation(self, recursive)Ruft alle Zellen ab, deren Berechnungsergebnis von dieser Zelle abhängt.
get_array_range(self)Ruft den Arraybereich ab, wenn die Formel der Zelle eine Arrayformel ist.
remove_array_formula(self, leave_normal_formula)Array-Formel entfernen.
copy(self, cell)Kopiert Daten aus einer Quellzelle.
characters(self, start_index, length)Gibt ein Zeichenobjekt zurück, das einen Zeichenbereich innerhalb des Zellentextes darstellt.
replace(self, place_holder, new_value, options)Ersetzen Sie den Text der Zelle durch Optionen.
insert_text(self, index, text)Fügen Sie einige Zeichen in die Zelle ein.
Wenn die Zelle reich formatiert ist, kann mit dieser Methode die ursprüngliche Formatierung beibehalten werden.
is_rich_text(self)Gibt an, ob der Zeichenfolgenwert dieser Zelle ein Rich-Format-Text ist.
set_characters(self, characters)Legt das Rich-Text-Format der Zelle fest.
get_merged_range(self)Gibt ein Range-Objekt zurück, das einen zusammengeführte Bereich darstellt.
get_html_string(self, html5)Ruft die HTML-Zeichenfolge ab, die Daten und einige Formate in dieser Zelle enthält.
to_json(self)Konvertieren Sie Cell in JSON Strukturdaten.
equals(self, cell)Überprüft, ob dieses Objekt mit einem anderen Zellobjekt auf dieselbe Zelle verweist.
get_conditional_formatting_result(self)Holen Sie sich das Ergebnis der bedingten Formatierung.
get_validation(self)Ruft die auf diese Zelle angewendete Validierung ab.
get_validation_value(self)Ruft den Wert der Validierung ab, die auf diese Zelle angewendet wurde.
get_table(self)Ruft die Tabelle ab, die diese Zelle enthält.
get_rich_value(self)Ruft den Gesamtwert der Zelle ab.

Beispiel

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)

Siehe auch