Cell sınıfı

Cell sınıfı

Tek bir Çalışma Kitabı hücresini temsil eden nesneyi kapsüller.

Cell türü aşağıdaki üyeleri ortaya çıkarır:

Özellikler

MülkTanım
worksheetEbeveyn çalışma sayfasını alır.
date_time_valueHücrede bulunan DateTime değerini alır.
rowHücrenin satır numarasını (sıfırdan başlayarak) alır.
columnHücrenin sütun numarasını (sıfırdan başlayarak) alır.
is_formulaBelirtilen hücrenin formül içerip içermediğini gösterir.
has_custom_functionBu hücrenin formülünde özel bir fonksiyon(desteklenmeyen fonksiyon) olup olmadığını kontrol eder.
typeHücre değer türünü temsil eder.
nameHücrenin adını alır.
is_error_valueBu hücrenin değerinin hatalı olup olmadığını kontrol eder.
is_numeric_valueBu hücrenin değerinin numeric(int, double ve datetime) olup olmadığını gösterir
string_valueHücrede bulunan dize değerini alır. Eğer bu hücrenin türü dize ise, dize değerinin kendisini döndürür.
Diğer hücre tipleri için biçimlendirilmiş dize değeri (bu hücrenin belirtilen stiliyle biçimlendirilmiş) döndürülecektir.
Biçimlendirilmiş hücre değeri, bir hücreyi metin olarak kopyaladığınızda Excel’den alabileceğiniz değerle aynıdır (örneğin
(hücreyi metin düzenleyicisine kopyalama veya csv’ye aktarma).
string_value_without_formatHücrenin değerini herhangi bir formata tabi tutmadan string olarak alır.
number_category_typeBu hücrenin sayı biçimlendirmesinin kategori türünü temsil eder.
display_string_valueBu hücrenin biçimlendirilmiş dize değerini hücrenin görüntüleme stiline göre alır.
int_valueHücrede bulunan tam sayı değerini alır.
double_valueHücrede bulunan double değerini alır.
float_valueHücrede bulunan float değerini alır.
bool_valueHücrede bulunan boolean değerini alır.
has_custom_styleBu hücrenin özel stil ayarlarına sahip olup olmadığını gösterir (devralınan varsayılan ayarlardan farklı)
(ilgili satırdan, sütundan veya çalışma kitabından).
shared_style_indexStil havuzundaki hücrenin paylaşılan stil indeksini alır.
formulaCell formülünü alır veya ayarlar.
formula_localHücrenin yerel biçimlendirilmiş formülünü alın.
r1c1_formulaCell‘in R1C1 formülünü alır veya ayarlar.
contains_external_linkBu hücrenin harici bir bağlantı içerip içermediğini belirtir.
Yalnızca hücre bir formül hücresi olduğunda geçerlidir.
is_array_headerHücrenin formülünün bir dizi formülü olduğunu gösterir
ve dizinin ilk hücresidir.
is_dynamic_array_formulaHücrenin formülünün dinamik dizi formülü (doğru) veya eski dizi formülü (yanlış) olduğunu gösterir.
is_array_formulaHücre formülünün bir dizi formülü olup olmadığını gösterir.
is_in_arrayHücre formülünün bir dizi formülü olup olmadığını gösterir.
is_shared_formulaHücre formülünün paylaşılan formülün parçası olup olmadığını gösterir.
is_table_formulaBu hücrenin tablo formülünün parçası olup olmadığını gösterir.
is_in_tableBu hücrenin tablo formülünün parçası olup olmadığını gösterir.
valueBu hücrede bulunan değeri alır/ayarlar.
is_style_setHücrenin stilinin ayarlanıp ayarlanmadığını gösterir. Eğer false döndürülürse, bu hücrenin varsayılan bir hücre biçimine sahip olduğu anlamına gelir.
is_mergedBir hücrenin birleştirilmiş aralığın parçası olup olmadığını kontrol eder.
commentBu hücrenin yorumunu alır.
html_stringBu hücrede veri ve bazı formatları içeren html dizesini alır ve ayarlar.
is_check_box_styleBu hücrenin onay kutusu olarak ayarlanıp ayarlanmadığını belirtir.
embedded_imageHücredeki gömülü resmi alır ve ayarlar.

Yöntemler

YöntemTanım
put_value(self, bool_value)Hücreye bir Boole değeri koyar.
put_value(self, int_value)Hücreye tam sayı değeri koyar.
put_value(self, double_value)Hücreye çift değer koyar.
put_value(self, string_value, is_converted, set_style)Hücreye bir değer koyar, uygunsa değer başka bir veri türüne dönüştürülür ve hücrenin sayı biçimi sıfırlanır.
put_value(self, string_value, is_converted)Hücreye bir dize değeri koyar ve uygunsa değeri başka bir veri türüne dönüştürür.
put_value(self, string_value)Hücreye bir dize değeri koyar.
put_value(self, date_time)Hücreye bir DateTime değeri koyar.
put_value(self, object_value)Hücreye bir nesne değeri koyar.
get_display_style(self)Bu hücrenin görüntüleme stilini alır.
get_display_style(self, include_merged_borders)Bu hücrenin görüntüleme stilini alır.
get_display_style(self, adjacent_borders)Bu hücrenin görüntüleme stilini alır.
get_style(self)Hücre stilini alır.
get_style(self, check_borders)checkBorders true ise, diğer hücrelerin kenarlıklarının bu hücrenin stilini etkileyip etkilemeyeceğini kontrol edin.
set_style(self, style)Hücre stilini ayarlar.
set_style(self, style, explicit_flag)Hücreye style’ın değiştirilen özelliğini uygula.
set_style(self, style, flag)Bayraklara dayalı hücre stilini uygulayın.
set_formula(self, formula, value)Formülü ve formülün değerini (hesaplanan sonucu) ayarlayın.
set_formula(self, formula, options)Formülü ve formülün değerini (hesaplanan sonucu) ayarlayın.
set_formula(self, formula, is_r1c1, is_local, value)Formülü ve formülün değerini ayarlayın.
set_formula(self, formula, options, value)Formülü ve formülün değerini (hesaplanan sonucu) ayarlayın.
set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local)Bir dizi formülünü bir hücre aralığına ayarlar.
set_array_formula(self, array_formula, row_number, column_number)Bir dizi formülünü (MS Excel’de CTRL+SHIFT+ENTER ile girilen eski dizi formülü) bir hücre aralığına ayarlar.
set_array_formula(self, array_formula, row_number, column_number, options)Bir dizi formülünü bir hücre aralığına ayarlar.
set_array_formula(self, array_formula, row_number, column_number, options, values)Bir dizi formülünü bir hücre aralığına ayarlar.
set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local)Bir formülü bir hücre aralığına ayarlar.
set_shared_formula(self, shared_formula, row_number, column_number)Paylaşılan formülleri bir hücre aralığına ayarlar.
set_shared_formula(self, shared_formula, row_number, column_number, options)Paylaşılan formülleri bir hücre aralığına ayarlar.
set_shared_formula(self, shared_formula, row_number, column_number, options, values)Paylaşılan formülleri bir hücre aralığına ayarlar.
get_leafs(self)Bu hücreye doğrudan referans veren ve bu hücre değiştirildiğinde güncellenmesi gereken tüm hücreleri al.
get_leafs(self, recursive)Bu hücre değiştirildiğinde güncellenecek tüm hücreleri al.
set_dynamic_array_formula(self, array_formula, options, calculate_value)Dinamik dizi formülü ayarlar ve mümkünse formülün komşu hücrelere yayılmasını sağlar.
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value)Dinamik dizi formülü ayarlar ve mümkünse formülün komşu hücrelere yayılmasını sağlar.
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts)Dinamik dizi formülü ayarlar ve mümkünse formülün komşu hücrelere yayılmasını sağlar.
set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values)Bu hücreden başlayarak verilen aralık için iki değişkenli veri tablosu oluşturun.
set_table_formula(self, row_number, column_number, input_cell, is_row_input, values)Bu hücreden başlayarak verilen aralık için tek değişkenli veri tablosu oluşturun.
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)Bu hücreden başlayarak verilen aralık için iki değişkenli veri tablosu oluşturun.
set_table_formula(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values)Bu hücreden başlayarak verilen aralık için tek değişkenli veri tablosu oluşturun.
get_characters(self)Tüm Karakter nesnelerini döndürür
hücre metni içindeki karakter aralığını temsil eder.
get_characters(self, flag)Tüm Karakter nesnelerini döndürür
hücre metni içindeki karakter aralığını temsil eder.
calculate(self, options)Hücrenin formülünü hesaplar.
get_string_value(self, format_strategy)Belirli biçimlendirilmiş stratejiye göre dize değerini alır.
get_width_of_value(self)Değerin genişliğini piksel cinsinden alır.
get_height_of_value(self)Değerin yüksekliğini piksel cinsinden alır.
get_format_conditions(self)Bu hücreye uygulanan biçim koşullarını alır.
get_formula(self, is_r1c1, is_local)Bu hücrenin formülünü alın.
get_precedents(self)Bu hücrenin formülünde görünen tüm referansları alır.
get_dependents(self, is_all)Formülü doğrudan bu hücreye referans veren tüm hücreleri al.
get_precedents_in_calculation(self)Bu hücrenin formülü hesaplanırken kullanılan tüm emsalleri (geçerli çalışma kitabındaki hücrelere yapılan referanslar) alır.
get_dependents_in_calculation(self, recursive)Hesaplanan sonucu bu hücreye bağlı olan tüm hücreleri alır.
get_array_range(self)Hücrenin formülü bir dizi formülü ise dizi aralığını alır.
remove_array_formula(self, leave_normal_formula)Dizi formülünü kaldır.
copy(self, cell)Kaynak hücreden veri kopyalar.
characters(self, start_index, length)Hücre metnindeki karakter aralığını temsil eden bir Characters nesnesi döndürür.
replace(self, place_holder, new_value, options)Hücrenin metnini seçeneklerle değiştirin.
insert_text(self, index, text)Hücreye birkaç karakter ekleyin.
Hücre zengin biçimlendirilmişse, bu yöntem orijinal biçimlendirmeyi koruyabilir.
is_rich_text(self)Bu hücrenin dize değerinin zengin biçimlendirilmiş metin olup olmadığını gösterir.
set_characters(self, characters)Hücrenin zengin metin biçimini ayarlar.
get_merged_range(self)Birleştirilmiş bir aralığı temsil eden Range nesnesini döndürür.
get_html_string(self, html5)Bu hücrede veri ve bazı formatları içeren html dizesini alır.
to_json(self)Cell yapı verisini JSON yapı verisine dönüştürün.
equals(self, cell)Bu nesnenin başka bir hücre nesnesiyle aynı hücreye başvurup başvurmadığını kontrol eder.
get_conditional_formatting_result(self)Koşullu biçimlendirmenin sonucunu alın.
get_validation(self)Bu hücreye uygulanan doğrulamayı alır.
get_validation_value(self)Bu hücreye uygulanan doğrulama değerini alır.
get_table(self)Bu hücreyi içeren tabloyu alır.
get_rich_value(self)Hücrenin zengin değerini alır.

Örnek

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)

Ayrıca bakınız