Cell صف
Cell صف
يقوم بتغليف الكائن الذي يمثل خلية مصنف واحدة.
يكشف النوع Cell عن الأعضاء التاليين:
ملكيات
| ملكية | وصف |
|---|---|
| worksheet | يحصل على ورقة العمل الأصلية. |
| date_time_value | يحصل على قيمة DateTime الموجودة في الخلية. |
| row | يحصل على رقم الصف (على أساس الصفر) للخلية. |
| column | يحصل على رقم العمود (على أساس الصفر) للخلية. |
| is_formula | يمثل ما إذا كانت الخلية المحددة تحتوي على صيغة. |
| has_custom_function | يتحقق ما إذا كانت هناك وظيفة مخصصة (وظيفة غير مدعومة) في صيغة هذه الخلية. |
| type | يمثل نوع قيمة الخلية. |
| name | يحصل على اسم الخلية. |
| is_error_value | التحقق مما إذا كانت قيمة هذه الخلية خطأ. |
| is_numeric_value | يشير إلى ما إذا كانت قيمة هذه الخلية رقمية (int وdouble وdatetime) |
| string_value | احصل على قيمة السلسلة النصية الموجودة في الخلية. إذا كان نوع هذه الخلية سلسلة نصية، فأرجع قيمة السلسلة النصية نفسها. بالنسبة لأنواع الخلايا الأخرى، سيتم إرجاع قيمة السلسلة المنسقة (المنسقة بالنمط المحدد لهذه الخلية). قيمة الخلية المنسقة هي نفسها ما يمكنك الحصول عليه من Excel عند نسخ خلية كنص (مثل نسخ الخلية إلى محرر النصوص أو تصديرها إلى ملف csv). |
| string_value_without_format | يحصل على قيمة الخلية كسلسلة بدون أي تنسيق. |
| number_category_type | يمثل نوع الفئة لتنسيق الأرقام في هذه الخلية. |
| display_string_value | يحصل على قيمة السلسلة المنسقة لهذه الخلية حسب نمط عرض الخلية. |
| int_value | يحصل على القيمة الصحيحة الموجودة في الخلية. |
| double_value | يحصل على القيمة المزدوجة الموجودة في الخلية. |
| float_value | يحصل على القيمة العائمة الموجودة في الخلية. |
| bool_value | يحصل على القيمة المنطقية الموجودة في الخلية. |
| has_custom_style | يشير إلى ما إذا كانت هذه الخلية تحتوي على إعدادات نمط مخصصة (تختلف عن الإعدادات الافتراضية الموروثة من الصف أو العمود أو المصنف المقابل). |
| shared_style_index | يحصل على مؤشر النمط المشترك للخلية في مجموعة الأنماط. |
| formula | يحصل على صيغة Cell أو يعينها. |
| formula_local | احصل على صيغة تنسيق اللغة المحلية للخلية. |
| r1c1_formula | يحصل على صيغة R1C1 الخاصة بـ Cell أو يعينها. |
| contains_external_link | يشير إلى ما إذا كانت هذه الخلية تحتوي على رابط خارجي. ينطبق فقط عندما تكون الخلية عبارة عن خلية صيغة. |
| is_array_header | يشير إلى أن صيغة الخلية هي صيغة مصفوفة وهي الخلية الأولى للمصفوفة. |
| is_dynamic_array_formula | يشير إلى ما إذا كانت صيغة الخلية عبارة عن صيغة مصفوفة ديناميكية (صحيح) أو صيغة مصفوفة قديمة (خطأ). |
| is_array_formula | يشير إلى ما إذا كانت صيغة الخلية عبارة عن صيغة مصفوفة. |
| is_in_array | يشير إلى ما إذا كانت صيغة الخلية عبارة عن صيغة مصفوفة. |
| is_shared_formula | يشير إلى ما إذا كانت صيغة الخلية جزءًا من الصيغة المشتركة. |
| is_table_formula | يشير إلى ما إذا كانت هذه الخلية جزءًا من صيغة الجدول. |
| is_in_table | يشير إلى ما إذا كانت هذه الخلية جزءًا من صيغة الجدول. |
| value | يحصل على/يحدد القيمة الموجودة في هذه الخلية. |
| is_style_set | يشير إلى ما إذا كان نمط الخلية مُعيّنًا. إذا كانت القيمة “خطأ”، فهذا يعني أن تنسيق الخلية الافتراضي مُحدّد. |
| is_merged | التحقق مما إذا كانت الخلية جزءًا من نطاق مدمج أم لا. |
| comment | يحصل على تعليق هذه الخلية. |
| html_string | يحصل على سلسلة HTML التي تحتوي على البيانات وبعض التنسيقات في هذه الخلية ويقوم بتعيينها. |
| is_check_box_style | يشير إلى ما إذا كان يتم تعيين هذه الخلية كصندوق اختيار. |
| embedded_image | يحصل على الصورة المضمنة في الخلية ويضبطها. |
طُرق
| طريقة | وصف |
|---|---|
put_value(self, bool_value) | وضع قيمة منطقية في الخلية. |
put_value(self, int_value) | وضع قيمة عددية في الخلية. |
put_value(self, double_value) | وضع قيمة مضاعفة في الخلية. |
put_value(self, string_value, is_converted, set_style) | يضع قيمة في الخلية، وإذا كان ذلك مناسبًا، فسيتم تحويل القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق رقم الخلية. |
put_value(self, string_value, is_converted) | يضع قيمة سلسلة في الخلية ويحول القيمة إلى نوع بيانات آخر إذا لزم الأمر. |
put_value(self, string_value) | يضع قيمة سلسلة في الخلية. |
put_value(self, date_time) | يضع قيمة DateTime في الخلية. |
put_value(self, object_value) | وضع قيمة الكائن في الخلية. |
get_display_style(self) | يحصل على نمط العرض لهذه الخلية. |
get_display_style(self, include_merged_borders) | يحصل على نمط العرض لهذه الخلية. |
get_display_style(self, adjacent_borders) | يحصل على نمط العرض لهذه الخلية. |
get_style(self) | يحصل على نمط الخلية. |
get_style(self, check_borders) | إذا كانت checkBorders صحيحة، فتحقق ما إذا كانت حدود الخلايا الأخرى ستؤثر على نمط هذه الخلية. |
set_style(self, style) | تعيين نمط الخلية. |
set_style(self, style, explicit_flag) | تطبيق خاصية النمط المتغيرة على الخلية. |
set_style(self, style, flag) | تطبيق نمط الخلية بناءً على العلامات. |
set_formula(self, formula, value) | قم بتعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة. |
set_formula(self, formula, options) | قم بتعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة. |
set_formula(self, formula, is_r1c1, is_local, value) | تعيين الصيغة وقيمة الصيغة. |
set_formula(self, formula, options, value) | قم بتعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة. |
set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local) | تعيين صيغة المصفوفة لمجموعة من الخلايا. |
set_array_formula(self, array_formula, row_number, column_number) | تعيين صيغة المصفوفة (صيغة المصفوفة القديمة التي تم إدخالها عبر CTRL+SHIFT+ENTER في ms excel) إلى نطاق من الخلايا. |
set_array_formula(self, array_formula, row_number, column_number, options) | تعيين صيغة المصفوفة لمجموعة من الخلايا. |
set_array_formula(self, array_formula, row_number, column_number, options, values) | تعيين صيغة المصفوفة لمجموعة من الخلايا. |
set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local) | تعيين صيغة لمجموعة من الخلايا. |
set_shared_formula(self, shared_formula, row_number, column_number) | تعيين الصيغ المشتركة لمجموعة من الخلايا. |
set_shared_formula(self, shared_formula, row_number, column_number, options) | تعيين الصيغ المشتركة لمجموعة من الخلايا. |
set_shared_formula(self, shared_formula, row_number, column_number, options, values) | تعيين الصيغ المشتركة لمجموعة من الخلايا. |
get_leafs(self) | احصل على جميع الخلايا التي تشير إلى هذه الخلية بشكل مباشر وتحتاج إلى التحديث عند تعديل هذه الخلية. |
get_leafs(self, recursive) | احصل على جميع الخلايا التي سيتم تحديثها عند تعديل هذه الخلية. |
set_dynamic_array_formula(self, array_formula, options, calculate_value) | تعيين صيغة المصفوفة الديناميكية وجعل الصيغة تنتشر في الخلايا المجاورة إذا كان ذلك ممكنًا. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value) | تعيين صيغة المصفوفة الديناميكية وجعل الصيغة تنتشر في الخلايا المجاورة إذا كان ذلك ممكنًا. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts) | تعيين صيغة المصفوفة الديناميكية وجعل الصيغة تنتشر في الخلايا المجاورة إذا كان ذلك ممكنًا. |
set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values) | قم بإنشاء جدول بيانات مكون من متغيرين للنطاق المحدد بدءًا من هذه الخلية. |
set_table_formula(self, row_number, column_number, input_cell, is_row_input, values) | قم بإنشاء جدول بيانات مكون من متغير واحد للنطاق المحدد بدءًا من هذه الخلية. |
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) | قم بإنشاء جدول بيانات مكون من متغيرين للنطاق المحدد بدءًا من هذه الخلية. |
set_table_formula(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values) | قم بإنشاء جدول بيانات مكون من متغير واحد للنطاق المحدد بدءًا من هذه الخلية. |
get_characters(self) | إرجاع جميع كائنات الأحرف وهو ما يمثل نطاقًا من الأحرف داخل نص الخلية. |
get_characters(self, flag) | إرجاع جميع كائنات الأحرف وهو ما يمثل نطاقًا من الأحرف داخل نص الخلية. |
calculate(self, options) | يحسب صيغة الخلية. |
get_string_value(self, format_strategy) | يحصل على قيمة السلسلة حسب استراتيجية منسقة محددة. |
get_width_of_value(self) | يحصل على عرض القيمة بوحدة البكسل. |
get_height_of_value(self) | يحصل على ارتفاع القيمة بوحدة البكسل. |
get_format_conditions(self) | يحصل على شروط التنسيق التي تنطبق على هذه الخلية. |
get_formula(self, is_r1c1, is_local) | احصل على صيغة هذه الخلية. |
get_precedents(self) | يحصل على جميع المراجع التي تظهر في صيغة هذه الخلية. |
get_dependents(self, is_all) | احصل على جميع الخلايا التي تشير صيغتها إلى هذه الخلية بشكل مباشر. |
get_precedents_in_calculation(self) | يحصل على جميع السوابق (الإشارة إلى الخلايا في المصنف الحالي) التي تستخدمها صيغة هذه الخلية أثناء حسابها. |
get_dependents_in_calculation(self, recursive) | يحصل على جميع الخلايا التي تعتمد نتيجتها المحسوبة على هذه الخلية. |
get_array_range(self) | يحصل على نطاق المصفوفة إذا كانت صيغة الخلية عبارة عن صيغة مصفوفة. |
remove_array_formula(self, leave_normal_formula) | إزالة صيغة المصفوفة. |
copy(self, cell) | نسخ البيانات من خلية المصدر. |
characters(self, start_index, length) | يقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل نص الخلية. |
replace(self, place_holder, new_value, options) | استبدال نص الخلية بالخيارات. |
insert_text(self, index, text) | أدخل بعض الأحرف في الخلية. إذا كانت الخلية ذات تنسيق غني، فقد تتمكن هذه الطريقة من الاحتفاظ بالتنسيق الأصلي. |
is_rich_text(self) | يشير إلى ما إذا كانت قيمة السلسلة لهذه الخلية عبارة عن نص منسق. |
set_characters(self, characters) | تعيين تنسيق النص الغني للخلية. |
get_merged_range(self) | يقوم بإرجاع الكائن Range الذي يمثل نطاقًا مدمجًا. |
get_html_string(self, html5) | يحصل على سلسلة HTML التي تحتوي على البيانات وبعض التنسيقات في هذه الخلية. |
to_json(self) | تحويل بيانات الهيكل Cell إلى JSON. |
equals(self, cell) | التحقق مما إذا كان هذا الكائن يشير إلى نفس الخلية مع كائن خلية آخر. |
get_conditional_formatting_result(self) | احصل على نتيجة التنسيق الشرطي. |
get_validation(self) | يحصل على التحقق المطبق على هذه الخلية. |
get_validation_value(self) | يحصل على قيمة التحقق التي تم تطبيقها على هذه الخلية. |
get_table(self) | يحصل على الجدول الذي يحتوي على هذه الخلية. |
get_rich_value(self) | يحصل على قيمة غنية للخلية. |
مثال
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)
أنظر أيضا
- الوحدة
aspose.cells - فئة
Cell - فئة
Range
