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(self, target)`	ملء النطاق المستهدف تلقائيًا.
`auto_fill(self, target, auto_fill_type)`	ملء النطاق المستهدف تلقائيًا.
`set_style(self, style, explicit_flag)`	تطبيق نمط الخلية.
`set_style(self, style)`	تعيين نمط النطاق.
`set_outline_borders(self, border_style, border_color)`	تعيين حدود المخطط التفصيلي حول نطاق من الخلايا بنفس نمط الحدود واللون.
`set_outline_borders(self, border_style, border_color)`	تعيين حدود المخطط التفصيلي حول نطاق من الخلايا بنفس نمط الحدود واللون.
`set_outline_borders(self, border_styles, border_colors)`	تعيين حدود الخطوط حول نطاق من الخلايا.
`set_outline_border(self, border_edge, border_style, border_color)`	تعيين حدود تفصيلية حول نطاق من الخلايا.
`set_outline_border(self, border_edge, border_style, border_color)`	تعيين حدود تفصيلية حول نطاق من الخلايا.
`copy(self, range, options)`	نسخ النطاق باستخدام خيارات اللصق الخاصة.
`copy(self, range)`	نسخ البيانات (بما في ذلك الصيغ)، والتنسيق، وكائنات الرسم وما إلى ذلك من نطاق المصدر.
`add_hyperlink(self, address, text_to_display, screen_tip)`	يضيف ارتباطًا تشعبيًا إلى خلية محددة أو نطاق من الخلايا.
`is_intersect(self, range)`	يشير إلى ما إذا كان النطاق متقاطعًا.
`intersect(self, range)`	يقوم بإرجاع الكائن `Range` الذي يمثل التقاطع المستطيلي بين نطاقين.
`union_rang(self, range)`	إرجاع نتيجة اتحاد نطاقين.
`union_ranges(self, ranges)`	إرجاع نتيجة اتحاد نطاقين.
`union(self, range)`	إرجاع اتحاد نطاقين.
`is_blank(self)`	يشير إلى ما إذا كان النطاق يحتوي على قيم.
`merge(self)`	دمج مجموعة من الخلايا في خلية واحدة.
`un_merge(self)`	إلغاء دمج الخلايا المدمجة في هذا النطاق.
`put_value(self, string_value, is_converted, set_style)`	يضع قيمة في النطاق، وإذا كان ذلك مناسبًا، فسيتم تحويل القيمة إلى نوع بيانات آخر وسيتم إعادة تعيين تنسيق رقم الخلية.
`apply_style(self, style, flag)`	ينطبق التنسيقات على نطاق كامل.
`set_inside_borders(self, border_edge, line_style, border_color)`	تعيين داخل حدود النطاق.
`move_to(self, dest_row, dest_column)`	نقل النطاق الحالي إلى نطاق الوجهة.
`copy_data(self, range)`	نسخ بيانات الخلية (بما في ذلك الصيغ) من نطاق المصدر.
`copy_value(self, range)`	نسخ قيمة الخلية من نطاق المصدر.
`copy_style(self, range)`	نسخ إعدادات النمط من نطاق المصدر.
`transpose(self)`	نقل (تدوير) البيانات من الصفوف إلى الأعمدة أو العكس.
`get(self, row_offset, column_offset)`	أضف API for Python عبر .Net. نظرًا لأن هذا [int، int] غير مدعوم
`get_cell_or_null(self, row_offset, column_offset)`	يحصل على الكائن `Cell` أو لا شيء في هذا النطاق.
`get_offset(self, row_offset, column_offset)`	يحصل على نطاق `Range` عن طريق الإزاحة.
`to_image(self, options)`	تحويل النطاق إلى صورة.
`to_json(self, options)`	تحويل النطاق إلى القيمة JSON.
`to_html(self, save_options)`	تحويل النطاق إلى html .
`clear(self)`	مسح هذا النطاق.
`clear_contents(self)`	مسح محتويات هذا النطاق.
`clear_formats(self)`	مسح تنسيقات هذا النطاق.
`clear_comments(self)`	مسح تعليقات هذا النطاق.
`clear_hyperlinks(self, clear_format)`	يزيل فقط الروابط التشعبية.

ملاحظات

تشير الفئة 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")

أنظر أيضا

الوحدة aspose.cells
فئة Cell
فئة Range

QueryTableCollection صف RangeCollection صف