DataLabels صف
DataLabels صف
يقوم بتغليف مجموعة من كافة كائنات DataLabel للسلسلة المحددة.
الميراث: DataLabels →
ChartTextFrame →
ChartFrame
يكشف النوع DataLabels عن الأعضاء التاليين:
ملكيات
| ملكية | وصف |
|---|---|
| is_inner_mode | يشير إلى ما إذا كان حجم مساحة الرسم البياني يتضمن علامات التجزئة وعلامات المحور. يشير “خطأ” إلى أن الحجم يجب أن يحدد حجم منطقة الرسم البياني وعلامات التجزئة وعلامات المحور. |
| border | يحصل على Line. |
| area | يحصل على DataLabels.area. |
| text_font | يحصل على كائن ChartFrame.font من كائن ChartFrame المحدد. |
| text_options | يحصل على خيارات النص ويحددها. |
| font | يحصل على الخط الخاص بـ DataLabels؛ |
| 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 | يحصل أو يضبط ما إذا كان يجب ملاءمة الشكل تلقائيًا لاحتواء النص الموصوف فيه بالكامل. الملاءمة التلقائية هي عندما يتم تغيير حجم النص داخل الشكل لاحتواء النص بأكمله بالداخل. |
| show_value | يُمثل سلوك عرض قيم بيانات مخطط مُحدد. يُظهر “صحيح” القيم، ويُخفيها “خطأ”. |
| show_cell_range | يشير إلى ما إذا كان سيتم عرض نطاق الخلايا كعلامات بيانات. |
| show_percentage | يُمثل سلوك عرض قيمة النسبة المئوية لعلامة بيانات مخطط مُحدد. يُظهر “صحيح” قيمة النسبة المئوية. يُخفي “خطأ”. |
| show_bubble_size | يُمثل سلوك عرض قيمة النسبة المئوية لعلامة بيانات مخطط مُحدد. يُظهر “صحيح” قيمة النسبة المئوية. يُخفي “خطأ”. |
| show_category_name | يُمثل سلوك عرض اسم فئة بيانات مخطط مُحدد. استخدم “صحيح” لعرض اسم الفئة لعناوين البيانات على المخطط. استخدم “خطأ” لإخفائه. |
| show_series_name | يشير إلى ما إذا كان اسم السلسلة يظهر لملصقات البيانات على الرسم البياني. صحيح لإظهار اسم السلسلة. خطأ لإخفائه. |
| show_legend_key | يمثل سلوك عرض مفتاح تسمية بيانات الرسم البياني المحدد. صحيح إذا كان مفتاح أسطورة تسمية البيانات مرئيًا. |
| number_format | يمثل سلسلة التنسيق لكائن DataLabels. |
| number | يحصل على تنسيق الرقم المدمج ويقوم بتعيينه. |
| number_format_linked | صحيح إذا كان تنسيق الرقم مرتبطًا بالخلايا (بحيث يتغير تنسيق الأرقام في التسميات عند تغيرها في الخلايا). |
| separator_type | يحصل على نوع الفاصل المستخدم لعناوين البيانات على الرسم البياني أو يعينه. |
| separator_value | يحصل على قيمة الفاصل المستخدمة لعلامات البيانات على الرسم البياني أو يعينها. |
| position | يمثل موضع تسمية البيانات. |
| is_never_overlap | يشير إلى ما إذا كانت علامات البيانات المعروضة لا تتداخل أبدًا. (للمخطط الدائري) |
| shape_type | يحصل على نوع شكل تسمية البيانات أو يعينه. |
طُرق
| طريقة | وصف |
|---|---|
set_position_auto(self) | ضبط موضع الإطار إلى الوضع التلقائي |
characters(self, start_index, length) | يقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص. |
apply_font(self) | قم بتطبيق خط تسميات البيانات على جميع العقد الفرعية. |
مثال
from aspose.cells import Workbook
from aspose.cells.charts import LabelPositionType
# Set the DataLabels in the chart
wb = Workbook("chart.xlsx")
chart = wb.worksheets[0].charts[0]
for i in range(len(chart.n_series)):
datalabels = chart.n_series[i].data_labels
# Set the position of DataLabels
datalabels.position = LabelPositionType.INSIDE_BASE
# Show the category name in the DataLabels
datalabels.show_category_name = True
# Show the value in the DataLabels
datalabels.show_value = True
# Not show the percentage in the DataLabels
datalabels.show_percentage = False
# Not show the legend key.
datalabels.show_legend_key = False
أنظر أيضا
- الوحدة
aspose.cells.charts - فئة
ChartFrame - فئة
ChartTextFrame - فئة
DataLabels - فئة
Line