Chart صف
Chart صف
يقوم بتغليف الكائن الذي يمثل مخطط Excel واحد.
يكشف النوع Chart عن الأعضاء التاليين:
ملكيات
| ملكية | وصف |
|---|---|
| style | يحصل على النمط المدمج ويحدده. |
| chart_object | يمثل شكل الرسم البياني؛ |
| hide_pivot_field_buttons | يشير إلى ما إذا كان سيتم إخفاء أزرار حقل مخطط المحور فقط عندما يكون المخطط عبارة عن مخطط محوري. |
| pivot_options | يحدد عناصر التحكم المحورية التي تظهر على الرسم البياني |
| pivot_source | المصدر هو بيانات PivotTable. إذا لم يكن PivotSource فارغًا، فسيكون الرسم البياني هو PivotChart. |
| plot_by | يحصل ويحدد ما إذا كان سيتم رسمه حسب الصف أو العمود. |
| plot_empty_cells_type | يحصل ويحدد كيفية رسم الخلايا الفارغة. |
| plot_visible_cells | يشير إلى ما إذا كان سيتم رسم الخلايا المرئية فقط. |
| plot_visible_cells_only | يشير إلى ما إذا كان الرسم البياني يعرض الخلايا المرئية فقط. |
| display_na_as_blank | يشير إلى ما إذا كان سيتم عرض #N/A كقيمة فارغة. |
| name | يحصل على اسم الرسم البياني ويحدده. |
| size_with_window | صحيح إذا كان Microsoft يقوم Excel بتغيير حجم الرسم البياني ليتناسب مع حجم نافذة ورقة الرسم البياني. |
| worksheet | يحصل على ورقة العمل التي تحتوي على هذا الرسم البياني. |
| shapes | إرجاع كافة أشكال الرسم في هذا الرسم البياني. |
| print_size | يحصل على حجم الرسم البياني المطبوع ويحدده. |
| type | يحصل على نوع الرسم البياني أو يحدده. |
| n_series | يحصل على مجموعة SeriesCollection تمثل سلسلة البيانات في الرسم البياني. |
| filtered_n_series | يحصل على مجموعة SeriesCollection تمثل سلسلة البيانات التي تم تصفيتها في الرسم البياني. |
| title | يحصل على عنوان الرسم البياني. |
| sub_title | يحصل على العنوان الفرعي للرسم البياني. فقط لملف تنسيق ODS. |
| plot_area | يحصل على منطقة رسم المخطط التي تتضمن تسميات علامات المحور. |
| chart_area | يحصل على منطقة الرسم البياني في ورقة العمل. |
| category_axis | يحصل على المحور X للرسم البياني. |
| value_axis | يحصل على المحور Y للرسم البياني. |
| second_value_axis | يحصل على المحور Y الثاني للرسم البياني. |
| second_category_axis | يحصل على المحور X الثاني للرسم البياني. |
| series_axis | يحصل على محور السلسلة للرسم البياني. |
| legend | يحصل على أسطورة الرسم البياني. |
| chart_data_table | يمثل جدول بيانات الرسم البياني. |
| show_legend | يحصل على قيمة أو يعيّنها لتحديد ما إذا كان سيتم عرض أسطورة الرسم البياني. القيمة الافتراضية هي “صحيح”. |
| is_rectangular_cornered | يحصل على قيمة أو يعينها تشير إلى ما إذا كانت منطقة الرسم البياني ذات زاوية مستطيلة. الإفتراضي هو الصحيح. |
| show_data_table | يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان الرسم البياني يعرض جدول بيانات. |
| first_slice_angle | يحصل على زاوية شريحة الرسم البياني الدائري أو الرسم البياني الدائري الأول أو يضبطها، بالدرجات (في اتجاه عقارب الساعة من العمودي). ينطبق فقط على المخططات الدائرية، والمخططات الدائرية ثلاثية الأبعاد، والمخططات الدائرية الدائرية، من 0 إلى 360. |
| gap_width | إرجاع أو تعيين المسافة بين مجموعات الشريط أو العمود، كنسبة مئوية من عرض الشريط أو العمود. يجب أن تكون قيمة هذه الخاصية بين 0 و 500. |
| gap_depth | يحصل على المسافة بين سلسلة البيانات في مخطط ثلاثي الأبعاد أو يعينها، كنسبة مئوية من عرض العلامة. يجب أن تكون قيمة هذه الخاصية بين 0 و 500. |
| floor | يقوم بإرجاع الكائن Chart.floor الذي يمثل جدران مخطط ثلاثي الأبعاد. |
| walls | يقوم بإرجاع الكائن Chart.walls الذي يمثل جدران مخطط ثلاثي الأبعاد. |
| back_wall | يقوم بإرجاع الكائن Chart.walls الذي يمثل الجدار الخلفي لمخطط ثلاثي الأبعاد. |
| side_wall | يقوم بإرجاع الكائن Chart.walls الذي يمثل الجدار الجانبي لمخطط ثلاثي الأبعاد. |
| walls_and_gridlines_2d | صحيح إذا تم رسم خطوط الشبكة ثنائية الأبعاد على مخطط ثلاثي الأبعاد. |
| rotation_angle | يمثل دوران عرض الرسم البياني ثلاثي الأبعاد (دوران منطقة الرسم البياني حول المحور z، بالدرجات). |
| elevation | يمثل ارتفاع عرض الرسم البياني ثلاثي الأبعاد، بالدرجات. |
| right_angle_axes | صحيح إذا كانت محاور الرسم البياني بزوايا قائمة. ينطبق فقط على الرسوم البيانية ثلاثية الأبعاد (باستثناء الرسوم البيانية العمودية ثلاثية الأبعاد والرسوم البيانية الدائرية ثلاثية الأبعاد). |
| auto_scaling | صحيح إذا كان Microsoft يقوم Excel بتغيير مقياس الرسم البياني ثلاثي الأبعاد بحيث يكون حجمه أقرب إلى الرسم البياني ثنائي الأبعاد المكافئ. يجب أن تكون خاصية RightAngleAxes صحيحة. |
| height_percent | إرجاع أو تعيين ارتفاع الرسم البياني ثلاثي الأبعاد كنسبة مئوية من عرض الرسم البياني (بين 5 و500 بالمائة). |
| perspective | يُرجع أو يُحدد منظور عرض الرسم البياني ثلاثي الأبعاد. يجب أن يكون بين ٠ و١٠٠. سيتم تجاهل هذه الخاصية إذا كانت الخاصية RightAngleAxes هي True. |
| is_3d | يشير إلى ما إذا كان الرسم البياني عبارة عن رسم بياني ثلاثي الأبعاد. |
| depth_percent | يمثل عمق الرسم البياني ثلاثي الأبعاد كنسبة مئوية من عرض الرسم البياني (بين 20 و2000 بالمائة). |
| actual_chart_size | يحصل على الحجم الفعلي للرسم البياني بوحدة البكسل. |
| placement | يمثل الطريقة التي يتم بها ربط الرسم البياني بالخلايا الموجودة أسفله. |
| page_setup | يمثل وصف إعداد الصفحة في هذا الرسم البياني. |
| line | يحصل على الخط. |
طُرق
| طريقة | وصف |
|---|---|
calculate(self) | يحسب الموضع المخصص لمنطقة الرسم البياني، والمحاور إذا تم تعيين موضعها تلقائيًا. |
calculate(self, calculate_options) | يحسب الموضع المخصص لمنطقة الرسم البياني، والمحاور إذا تم تعيين موضعها تلقائيًا، باستخدام خيارات حساب الرسم البياني. |
to_image(self, image_file) | إنشاء صورة الرسم البياني وحفظها في ملف. يحدد امتداد اسم الملف تنسيق الصورة. |
to_image(self, image_file, image_type) | إنشاء صورة الرسم البياني وحفظها في ملف بنوع الصورة المحدد. |
to_image(self, image_file, jpeg_quality) | إنشاء صورة الرسم البياني وحفظها في ملف بتنسيق Jpeg. |
to_image(self, stream, jpeg_quality) | إنشاء صورة الرسم البياني وحفظها في مجرى بتنسيق Jpeg. |
to_image(self, stream, image_type) | إنشاء صورة الرسم البياني وحفظها في مجرى بالتنسيق المحدد. |
to_image(self, image_file, options) | إنشاء صورة الرسم البياني وحفظها في ملف. يحدد امتداد اسم الملف تنسيق الصورة. |
to_image(self, stream, options) | إنشاء صورة الرسم البياني وحفظها في مجرى بالتنسيق المحدد. |
to_pdf(self, file_name) | يحفظ الرسم البياني في ملف pdf. |
to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | يحفظ الرسم البياني في ملف pdf. |
to_pdf(self, stream) | يقوم بإنشاء مخطط pdf ويحفظه في مجرى. |
to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type) | يقوم بإنشاء مخطط pdf ويحفظه في مجرى. |
is_refered_by_chart(self, row_index, column_index) | إرجاع ما إذا كانت الخلية المشار إليها بواسطة الرسم البياني. |
is_cell_refered_by_chart(self, sheet_index, row_index, column_index) | إرجاع ما إذا كانت الخلية المشار إليها بواسطة الرسم البياني. |
is_chart_data_changed(self) | يكتشف ما إذا كان مصدر بيانات الرسم البياني قد تغير. |
refresh_pivot_data(self) | تحديث بيانات الرسم البياني من جدول المحور. |
change_template(self, data) | تغيير نوع الرسم البياني باستخدام القالب المحدد مسبقًا. |
move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column) | نقل الرسم البياني إلى موقع محدد. |
get_actual_size(self) | يحصل على الحجم الفعلي للرسم البياني بوحدة البكسل. |
has_axis(self, aixs_type, is_primary) | إرجاع المحاور الموجودة على الرسم البياني. |
switch_row_column(self) | تبديل الصف/العمود. |
get_chart_data_range(self) | يحصل على نطاق مصدر البيانات للرسم البياني. |
set_chart_data_range(self, area, is_vertical) | يحدد نطاق البيانات للرسم البياني. |
مثال
تُظهر الرموز التالية كيفية إنشاء مخطط باستخدام رموز .Net.
from aspose.cells import Workbook
from aspose.cells.charts import ChartType
workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"
أنظر أيضا
- الوحدة
aspose.cells.charts - فئة
SeriesCollection
