Cell
Example
Example Cell الفئة تمثل خلية واحدة في ورقة العمل وتوفر الوصول إلى سماتها الأساسية. وتكشف عن خصائص قراءة/كتابة لـ value, formula, و style, إلى جانب طرق مساعدة put_value(), get_style(), و apply_style().
| Example | Example | Example |
|---|---|---|
value | خاصية | تحصل أو تعين قيمة الخلية |
formula | خاصية | تحصل أو تعين سلسلة صيغة الخلية |
style | خاصية | تحصل على Style object (للقراءة فقط) |
comment | property | يحصل على cell’s comment (للقراءة فقط) |
data_type | property | يحصل على cell’s data type (للقراءة فقط) |
put_value(val) | method | يضبط cell’s value من Python scalar |
get_style() | method | يرجع نسخة mutable copy من cell’s style |
apply_style(style) | method | يطبق تعديلًا Style إرجاع الكائن إلى الخلية |
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
worksheet.cells["A1"].value = "Hello"
worksheet.cells["B1"].formula = "=A1"Example
Example Cell منشئ الفئة غير مكشوف للجمهور. يتم الحصول على الخلايا عبر Cells مجموعة من ورقة العمل باستخدام تدوين A1 أو مؤشرات الصف/العمود التي تبدأ من الصفر.
| Example | Example | Example |
|---|---|---|
| (لا شيء) | N/A | المنشئ غير عام؛ يتم الوصول إلى الخلايا عبر worksheet.cells["A1"] أو worksheet.cells[row, col] |
from aspose.cells_foss import Workbook
workbook = Workbook()
worksheet = workbook.worksheets[0]
cell = worksheet.cells["A1"]Example
Example Cell الفئة تكشف عن الخصائص التالية. value و formula قابلة للقراءة/الكتابة؛; style, comment,، و data_type هي للقراءة فقط (استخدم get_style() / apply_style() لتعديل النمط).
| Example | Example | قراءة/كتابة | Example |
|---|---|---|---|
value | كائن | قراءة/كتابة | القيمة الحالية للخلية (سلسلة، عدد صحيح، عدد عشري، منطقية، تاريخ/وقت، أو لا شيء) |
formula | str | قراءة/كتابة | سلسلة صيغة الخلية، بما في ذلك البادئة = |
style | Style | للقراءة فقط | كائن نمط الخلية؛ عدّل عبر get_style() / apply_style() |
comment | str | للقراءة فقط | نص تعليق الخلية |
data_type | str | للقراءة فقط | معرّف نوع بيانات الخلية |
Example
| Example | نوع الإرجاع | Example |
|---|---|---|
put_value(val) | Example | يضبط قيمة الخلية إلى القيمة العددية المعطاة |
get_style() | Style | يعيد نسخة قابلة للتعديل من نمط الخلية للتحرير |
apply_style(style) | Example | يطبق نسخة معدلة Style كائن إلى الخلية |
Example
يوضح المثال التالي قراءة وكتابة خصائص الخلية باستخدام Cell الفئة. لاحظ أن value و formula هي خصائص يتم الوصول إليها باستخدام صيغة الإسناد، وليس استدعاءات الدوال.
from aspose.cells_foss import Workbook
# Create a new workbook and access the first worksheet
workbook = Workbook()
worksheet = workbook.worksheets[0]
# Set a cell value using property assignment
cell_a1 = worksheet.cells["A1"]
cell_a1.value = "Hello World"
# Set a formula using property assignment
cell_b1 = worksheet.cells["B1"]
cell_b1.formula = "=LEN(A1)"
# Read cell properties using the property (no parentheses)
value = cell_a1.value
formula = cell_b1.formula
print(f"Value: {value}")
print(f"Formula: {formula}")
# Modify style via get_style / apply_style
style = cell_a1.get_style()
style.font.bold = True
style.font.size = 14
cell_a1.apply_style(style)
workbook.save("output.xlsx")