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