Legend صف
Legend صف
يقوم بتغليف الكائن الذي يمثل أسطورة الرسم البياني.
الميراث: Legend →
ChartTextFrame →
ChartFrame
يكشف النوع Legend عن الأعضاء التاليين:
ملكيات
| ملكية | وصف |
|---|---|
| is_inner_mode | يشير إلى ما إذا كان حجم مساحة الرسم البياني يتضمن علامات التجزئة وعلامات المحور. يشير “خطأ” إلى أن الحجم يجب أن يحدد حجم منطقة الرسم البياني وعلامات التجزئة وعلامات المحور. |
| border | يحصل على Line. |
| area | يحصل على ChartFrame.area. |
| text_font | يحصل على كائن ChartFrame.font من كائن ChartFrame المحدد. |
| text_options | يحصل على خيارات النص ويحددها. |
| font | يحصل على كائن ChartFrame.font من كائن ChartFrame المحدد. |
| auto_scale_font | صحيح إذا تغير حجم خط النص في الكائن عند تغيير حجم الكائن. القيمة الافتراضية هي صحيح. |
| background_mode | يحصل على وضع عرض الخلفية ويحدده |
| background | يحصل على وضع عرض الخلفية ويحدده |
| is_automatic_size | يشير إلى ما إذا كان إطار الرسم البياني يتم تغيير حجمه تلقائيًا. |
| x | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العلوية بوحدات مقدارها 1/4000 من مساحة الرسم البياني. |
| y | يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات مقدارها 1/4000 من مساحة الرسم البياني. |
| height | يحصل على أو يضبط ارتفاع الإطار بوحدات مقدارها 1/4000 من مساحة الرسم البياني. |
| width | يحصل على عرض الإطار أو يضبطه بوحدات مقدارها 1/4000 من مساحة الرسم البياني. |
| shadow | صحيح إذا كان الإطار يحتوي على ظل. |
| shape_properties | يحصل على الكائن ChartFrame.shape_properties. |
| is_default_pos_be_set | يشير إلى ما إذا كان الموضع الافتراضي (DefaultX وDefaultY وDefaultWidth وDefaultHeight) مضبوطًا. |
| default_x | يمثل x للموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني. |
| default_y | يمثل y للموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني. |
| default_width | يمثل عرض الموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني. |
| default_height | يمثل ارتفاع الموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني. |
| default_x_ratio_to_chart | يمثل x للموضع الافتراضي بوحدات جزء من مساحة الرسم البياني. |
| default_y_ratio_to_chart | يمثل y للموضع الافتراضي بوحدات جزء من مساحة الرسم البياني. |
| default_width_ratio_to_chart | يمثل عرض الموضع الافتراضي بوحدات جزء من مساحة الرسم البياني. |
| default_height_ratio_to_chart | يمثل ارتفاع الموضع الافتراضي بوحدات جزء من مساحة الرسم البياني. |
| x_ratio_to_chart | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العليا بوحدات نسبة مساحة الرسم البياني. |
| y_ratio_to_chart | يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات نسبة مساحة الرسم البياني. |
| width_ratio_to_chart | يحصل على عرض الإطار أو يعينه بوحدات نسبة مساحة الرسم البياني. |
| height_ratio_to_chart | يحصل على أو يضبط ارتفاع الإطار بوحدات نسبة مساحة الرسم البياني. |
| x_pixel | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العليا بوحدات البكسل. |
| y_pixel | يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات البكسل. |
| width_pixel | يحصل على عرض الإطار بوحدات البكسل أو يعينه. |
| height_pixel | يحصل على أو يضبط ارتفاع الإطار بوحدات البكسل. |
| is_auto_text | يشير إلى أن النص تم إنشاؤه تلقائيًا. |
| is_deleted | يشير إلى ما إذا كان سيتم حذف علامات البيانات هذه. |
| text_horizontal_alignment | يحصل على محاذاة النص الأفقية ويضبطها. |
| text_vertical_alignment | يحصل على محاذاة النص الرأسية أو يعينها. |
| rotation_angle | يمثل زاوية دوران النص. |
| is_automatic_rotation | يشير إلى ما إذا كان يتم تدوير نص الرسم البياني تلقائيًا. |
| text | يحصل على نص عنوان الإطار أو يعينه. |
| linked_source | يحصل على مرجع إلى ورقة العمل ويعينه. |
| text_direction | يمثل ترتيب قراءة النص. |
| reading_order | يمثل ترتيب قراءة النص. |
| direction_type | يحصل على اتجاه النص ويحدده. |
| is_text_wrapped | يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان النص ملفوفًا أم لا. |
| is_resize_shape_to_fit_text | يحصل أو يضبط ما إذا كان يجب ملاءمة الشكل تلقائيًا لاحتواء النص الموصوف فيه بالكامل. الملاءمة التلقائية هي عندما يتم تغيير حجم النص داخل الشكل لاحتواء النص بأكمله بالداخل. |
| position | يحصل على نوع موضع الأسطورة أو يعينه. |
| legend_entries | يحصل على مجموعة من كل كائنات LegendEntry الموجودة في أسطورة الرسم البياني المحددة. لا يتم دعم تعيين إدخالات الأسطورة لمخطط السطح. لذلك سيتم إرجاع قيمة null إذا كان نوع الرسم البياني هو نوع الرسم البياني السطحي. |
| legend_entries_labels | يحصل على تسميات إدخالات الأسطورة بعد استدعاء طريقة Chart.Calculate(). |
| is_over_lay | يحصل أو يعين ما إذا كان سيتم عرض الأسطورة دون تداخل الرسم البياني. |
طُرق
| طريقة | وصف |
|---|---|
set_position_auto(self) | ضبط موضع الإطار إلى الوضع التلقائي |
characters(self, start_index, length) | يقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص. |
get_legend_labels(self) | يحصل على تسميات إدخالات الأسطورة بعد استدعاء طريقة Chart.Calculate(). |
مثال
from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType
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)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT
أنظر أيضا
- الوحدة
aspose.cells.charts - فئة
ChartFrame - فئة
ChartTextFrame - فئة
Legend - فئة
Line
