Range صف

Range صف

يقوم بتغليف الكائن الذي يمثل نطاقًا من الخلايا داخل جدول البيانات.

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

ملكيات

ملكيةوصف
current_regionتقوم بإرجاع كائن نطاق يمثل المنطقة الحالية.
المنطقة الحالية عبارة عن نطاق محاط بأي مجموعة من الصفوف والأعمدة الفارغة.
hyperlinksيحصل على كافة الارتباطات التشعبية في النطاق.
row_countالحصول على عدد الصفوف في النطاق.
column_countالحصول على عدد الأعمدة في النطاق.
nameالحصول على اسم النطاق أو تعيينه.
refers_toيحصل على إشارة النطاق إلى.
addressيحصل على عنوان النطاق.
leftيحصل على المسافة، بالنقاط، من الحافة اليسرى للعمود A إلى الحافة اليسرى للنطاق.
topيحصل على المسافة، بالنقاط، من الحافة العلوية للصف 1 إلى الحافة العلوية للنطاق.
widthالحصول على عرض النطاق بالنقاط.
heightالحصول على عرض النطاق بالنقاط.
first_rowالحصول على فهرس الصف الأول من النطاق.
first_columnالحصول على فهرس العمود الأول من النطاق.
valueالحصول على قيمة النطاق وتعيينها.
column_widthيضبط أو يحصل على عرض العمود لهذا النطاق
row_heightيضبط أو يحصل على ارتفاع الصفوف في هذا النطاق
entire_columnالحصول على كائن نطاق يمثل العمود (أو الأعمدة) بأكمله الذي يحتوي على النطاق المحدد.
entire_rowالحصول على كائن نطاق يمثل الصف (أو الصفوف) بأكمله الذي يحتوي على النطاق المحدد.
worksheetيحصل على الكائن Range.worksheet الذي يحتوي على هذا النطاق.

طُرق

طريقةوصف
auto_fillتعبئة النطاق المستهدف تلقائيًا.
auto_fillتعبئة النطاق المستهدف تلقائيًا.
set_styleتطبيق نمط الخلية.
set_styleيضبط نمط النطاق.
set_outline_bordersلتعيين حدود المخطط التفصيلي حول نطاق من الخلايا بنفس نمط الحدود واللون.
set_outline_bordersلتعيين حدود المخطط التفصيلي حول نطاق من الخلايا بنفس نمط الحدود واللون.
set_outline_bordersيحدد حدود الخط حول نطاق من الخلايا.
set_outline_borderيعين حدودًا تفصيلية حول نطاق من الخلايا.
set_outline_borderيعين حدودًا تفصيلية حول نطاق من الخلايا.
copyنسخ النطاق مع لصق الخيارات الخاصة.
copyنسخ البيانات (بما في ذلك الصيغ)، والتنسيق، والكائنات الرسومية وما إلى ذلك من نطاق مصدر.
add_hyperlinkإضافة ارتباط تشعبي إلى خلية محددة أو نطاق من الخلايا.
get_enumeratorالحصول على العداد للخلايا الموجودة في هذا النطاق.
is_intersectيشير إلى ما إذا كان النطاق متقاطعًا.
intersectتقوم بإرجاع كائن Range الذي يمثل التقاطع المستطيل لنطاقين.
union_rangإرجاع نتيجة الاتحاد لنطاقين.
unionإرجاع اتحاد النطاقين.
is_blankالإشارة إلى ما إذا كان النطاق يحتوي على قيم.
mergeيجمع نطاقًا من الخلايا في خلية واحدة.
un_mergeإلغاء دمج الخلايا المدمجة في هذا النطاق.
put_valueيضع قيمة في النطاق، إذا كان ذلك مناسبًا، فسيتم تحويل القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق أرقام الخلية.
apply_styleيطبق التنسيقات على نطاق كامل.
set_inside_bordersتعيين داخل حدود النطاق.
move_toانقل النطاق الحالي إلى النطاق الأقل.
copy_dataنسخ بيانات الخلية (بما في ذلك الصيغ) من نطاق مصدر.
copy_valueنسخ قيمة الخلية من نطاق المصدر.
copy_styleنسخ إعدادات النمط من نطاق مصدر.
get_cell_or_nullيحصل على Cell كائنًا أو خاليًا في هذا النطاق.
get_offsetيحصل على نطاق Range عن طريق الإزاحة.

ملاحظات

تشير الفئة Range إلى منطقة جدول بيانات Excel. مع هذا، يمكنك تنسيق وتعيين قيمة النطاق. ويمكنك ببساطة نسخ نطاق Excel أيضًا.

مثال

يوضح المثال التالي كيفية إنشاء نطاق وتعيين قيمة نطاق Excel.

from aspose.cells import Workbook

# Instantiating a Workbook object
workbook = Workbook()
#  Get the first Worksheet Cells.
cells = workbook.worksheets[0].cells
#  Create a range (A1:D3).
range = cells.create_range("A1", "D3")
#  Set value to the range.
range.value = "Hello"
# Save the Excel file
workbook.save("book1.xlsm")

أنظر أيضا