Cell صف

Cell صف

يقوم بتغليف الكائن الذي يمثل خلية مصنف واحدة.

يكشف النوع Cell عن الأعضاء التاليين:

ملكيات

ملكية	وصف
worksheet	يحصل على ورقة العمل الأصل.
date_time_value	الحصول على قيمة DateTime الموجودة في الخلية.
row	الحصول على رقم الصف (على أساس صفر) للخلية.
column	الحصول على رقم العمود (على أساس صفر) للخلية.
is_formula	يمثل ما إذا كانت الخلية المحددة تحتوي على صيغة.
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 التي تحتوي على البيانات وبعض التنسيقات في هذه الخلية وتعيينها.
embedded_image	الحصول على الصورة المضمنة في الخلية وتعيينها.

طُرق

طريقة	وصف
put_value	يضع قيمة منطقية في الخلية.
put_value	يضع قيمة عددية في الخلية.
put_value	يضع قيمة مزدوجة في الخلية.
put_value	يضع قيمة في الخلية، وإذا كان ذلك مناسبًا، فسيتم تحويل القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق أرقام الخلية.
put_value	يضع قيمة سلسلة في الخلية ويحول القيمة إلى نوع بيانات آخر إذا كان ذلك مناسبًا.
put_value	يضع قيمة سلسلة في الخلية.
put_value	يضع قيمة DateTime في الخلية.
put_value	يضع قيمة كائن في الخلية.
get_display_style	الحصول على نمط عرض الخلية. إذا تأثرت هذه الخلية أيضًا بإعدادات أخرى مثل التنسيق الشرطي وكائنات القائمة وما إلى ذلك، فقد يكون نمط العرض مختلفًا عن cell.GetStyle().
get_display_style	الحصول على نمط عرض الخلية. إذا كانت الخلية منسقة شرطيًا، فإن نمط العرض ليس هو نفسه cell.GetStyle().
get_style	الحصول على نمط الخلية.
get_style	إذا كانت قيمة checkBorders صحيحة، فتحقق مما إذا كانت حدود الخلايا الأخرى ستؤثر على نمط هذه الخلية.
set_style	يضبط نمط الخلية.
set_style	قم بتطبيق خاصية النمط المتغيرة على الخلية.
set_style	قم بتطبيق نمط الخلية بناءً على الأعلام.
set_formula	قم بتعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة.
set_formula	قم بتعيين الصيغة وقيمة الصيغة.
set_formula	قم بتعيين الصيغة وقيمة (النتيجة المحسوبة) للصيغة.
set_array_formula	تعيين صيغة صفيف لنطاق من الخلايا.
set_array_formula	يعين صيغة صفيف (تم إدخال صيغة الصفيف القديمة عبر CTRL + SHIFT + ENTER في مللي إكسل) إلى نطاق من الخلايا.
set_array_formula	تعيين صيغة صفيف لنطاق من الخلايا.
set_array_formula	تعيين صيغة صفيف لنطاق من الخلايا.
set_shared_formula	تعيين صيغة لنطاق من الخلايا.
set_shared_formula	تعيين الصيغ المشتركة لنطاق من الخلايا.
set_shared_formula	تعيين الصيغ المشتركة لنطاق من الخلايا.
set_shared_formula	تعيين الصيغ المشتركة لنطاق من الخلايا.
get_leafs	احصل على كافة الخلايا التي تشير إلى هذه الخلية مباشرة وتحتاج إلى التحديث عند تعديل هذه الخلية.
get_leafs	الحصول على جميع الخلايا التي سيتم تحديثها عند تعديل هذه الخلية.
set_dynamic_array_formula	يضبط صيغة الصفيف الديناميكي ويجعل الصيغة تمتد إلى الخلايا المجاورة إن أمكن.
set_dynamic_array_formula	يضبط صيغة الصفيف الديناميكي ويجعل الصيغة تمتد إلى الخلايا المجاورة إن أمكن.
set_dynamic_array_formula	يضبط صيغة الصفيف الديناميكي ويجعل الصيغة تمتد إلى الخلايا المجاورة إن أمكن.
set_table_formula	قم بإنشاء جدول بيانات ذو متغيرين لنطاق معين بدءًا من هذه الخلية.
set_table_formula	قم بإنشاء جدول بيانات ذو متغير واحد لنطاق معين بدءًا من هذه الخلية.
set_table_formula	قم بإنشاء جدول بيانات ذو متغيرين لنطاق معين بدءًا من هذه الخلية.
set_table_formula	قم بإنشاء جدول بيانات ذو متغير واحد لنطاق معين بدءًا من هذه الخلية.
get_characters	إرجاع كافة كائنات الأحرف يمثل نطاقًا من الأحرف داخل نص الخلية.
get_characters	إرجاع كافة كائنات الأحرف يمثل نطاقًا من الأحرف داخل نص الخلية.
calculate	يحسب صيغة الخلية.
get_string_value	يحصل على قيمة السلسلة من خلال استراتيجية منسقة محددة.
get_width_of_value	يحصل على عرض القيمة بوحدة البكسل.
get_height_of_value	يحصل على ارتفاع القيمة بوحدة البكسل.
get_format_conditions	يحصل على شروط التنسيق التي تنطبق على هذه الخلية.
get_formula	الحصول على صيغة هذه الخلية.
get_precedents	يحصل على كافة المراجع التي تظهر في صيغة هذه الخلية.
get_dependents	احصل على كافة الخلايا التي تشير صيغتها إلى هذه الخلية مباشرة.
get_precedents_in_calculation	الحصول على كافة السوابق (مرجع إلى الخلايا الموجودة في المصنف الحالي) التي تستخدمها صيغة هذه الخلية أثناء حسابها.
get_dependents_in_calculation	يحصل على كافة الخلايا التي تعتمد نتائجها المحسوبة على هذه الخلية.
get_array_range	يحصل على نطاق الصفيف إذا كانت صيغة الخلية عبارة عن صيغة صفيف.
remove_array_formula	إزالة صيغة الصفيف.
copy	نسخ البيانات من الخلية المصدر.
characters	تقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل نص الخلية.
replace	استبدال نص الخلية بالخيارات.
insert_text	أدخل بعض الأحرف في الخلية. إذا كانت الخلية منسقة بشكل منسق، فيمكن أن تحتفظ هذه الطريقة بالتنسيق الأصلي.
is_rich_text	الإشارة إلى ما إذا كانت قيمة السلسلة لهذه الخلية عبارة عن نص منسق منسق.
set_characters	يضبط تنسيق النص المنسق للخلية.
get_merged_range	تقوم بإرجاع كائن Range الذي يمثل نطاقًا مدمجًا.
get_html_string	يحصل على سلسلة html التي تحتوي على البيانات وبعض التنسيقات في هذه الخلية.
to_json	تحويل Cell إلى JSON بيانات الهيكل.
equals	التحقق مما إذا كان هذا الكائن يشير إلى نفس الخلية مع كائن خلية آخر.
get_conditional_formatting_result	الحصول على نتيجة التنسيق الشرطي.
get_validation	الحصول على التحقق المطبق على هذه الخلية.
get_validation_value	يحصل على قيمة التحقق من الصحة التي تنطبق على هذه الخلية.
get_table	الحصول على الجدول الذي يحتوي على هذه الخلية.

مثال

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