##  DataLabels صف
يقوم بتغليف مجموعة من كافة كائنات DataLabel للسلسلة المحددة.



**الميراث:** [`DataLabels`](/cells/python-net/aspose.cells.charts/datalabels) → 
[`ChartTextFrame`](/cells/python-net/aspose.cells.charts/charttextframe) → 
[`ChartFrame`](/cells/python-net/ar/aspose.cells.charts/chartframe)



يكشف النوع DataLabels عن الأعضاء التاليين:

###  ملكيات
| ملكية| وصف|
| :- | :- |
| [is_inner_mode](/cells/python-net/ar/aspose.cells.charts/datalabels/is_inner_mode) | يشير إلى ما إذا كان حجم مساحة الرسم البياني يتضمن علامات التجزئة وعلامات المحور.
<br/> يشير "خطأ" إلى أن الحجم يجب أن يحدد حجم منطقة الرسم البياني وعلامات التجزئة وعلامات المحور.|
| [border](/cells/python-net/ar/aspose.cells.charts/datalabels/border) | يحصل على [`Line`](/cells/python-net/ar/aspose.cells.drawing/line).|
| [area](/cells/python-net/ar/aspose.cells.charts/datalabels/area) | يحصل على [`DataLabels.area`](/cells/python-net/ar/aspose.cells.charts/datalabels#area).|
| [text_font](/cells/python-net/ar/aspose.cells.charts/datalabels/text_font) |يحصل على كائن [`ChartFrame.font`](/cells/python-net/ar/aspose.cells.charts/chartframe#font) من كائن ChartFrame المحدد.|
| [text_options](/cells/python-net/ar/aspose.cells.charts/datalabels/text_options) | يحصل على خيارات النص ويحددها.|
| [font](/cells/python-net/ar/aspose.cells.charts/datalabels/font) | يحصل على الخط الخاص بـ DataLabels؛|
| [auto_scale_font](/cells/python-net/ar/aspose.cells.charts/datalabels/auto_scale_font) | صحيح إذا تغير حجم خط النص في الكائن عند تغيير حجم الكائن. القيمة الافتراضية هي صحيح.|
| [background_mode](/cells/python-net/ar/aspose.cells.charts/datalabels/background_mode) | يحصل على وضع عرض الخلفية ويحدده|
| [background](/cells/python-net/ar/aspose.cells.charts/datalabels/background) | يحصل على وضع عرض الخلفية ويحدده|
| [is_automatic_size](/cells/python-net/ar/aspose.cells.charts/datalabels/is_automatic_size) | يشير إلى ما إذا كان إطار الرسم البياني يتم تغيير حجمه تلقائيًا.|
| [x](/cells/python-net/ar/aspose.cells.charts/datalabels/x) | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العلوية بوحدات مقدارها 1/4000 من مساحة الرسم البياني.|
| [y](/cells/python-net/ar/aspose.cells.charts/datalabels/y) | يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات مقدارها 1/4000 من مساحة الرسم البياني.|
| [height](/cells/python-net/ar/aspose.cells.charts/datalabels/height) | يحصل على أو يضبط ارتفاع الإطار بوحدات مقدارها 1/4000 من مساحة الرسم البياني.|
| [width](/cells/python-net/ar/aspose.cells.charts/datalabels/width) | يحصل على عرض الإطار أو يضبطه بوحدات مقدارها 1/4000 من مساحة الرسم البياني.|
| [shadow](/cells/python-net/ar/aspose.cells.charts/datalabels/shadow) | صحيح إذا كان الإطار يحتوي على ظل.|
| [shape_properties](/cells/python-net/ar/aspose.cells.charts/datalabels/shape_properties) | يحصل على الكائن [`ChartFrame.shape_properties`](/cells/python-net/ar/aspose.cells.charts/chartframe#shape_properties).|
| [is_default_pos_be_set](/cells/python-net/ar/aspose.cells.charts/datalabels/is_default_pos_be_set) |يشير إلى ما إذا كان الموضع الافتراضي (DefaultX وDefaultY وDefaultWidth وDefaultHeight) مضبوطًا.|
| [default_x](/cells/python-net/ar/aspose.cells.charts/datalabels/default_x) | يمثل x للموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني.|
| [default_y](/cells/python-net/ar/aspose.cells.charts/datalabels/default_y) | يمثل y للموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني.|
| [default_width](/cells/python-net/ar/aspose.cells.charts/datalabels/default_width) | يمثل عرض الموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني.|
| [default_height](/cells/python-net/ar/aspose.cells.charts/datalabels/default_height) | يمثل ارتفاع الموضع الافتراضي بوحدات 1/4000 من مساحة الرسم البياني.|
| [default_x_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/default_x_ratio_to_chart) | يمثل x للموضع الافتراضي بوحدات جزء من مساحة الرسم البياني.|
| [default_y_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/default_y_ratio_to_chart) | يمثل y للموضع الافتراضي بوحدات جزء من مساحة الرسم البياني.|
| [default_width_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/default_width_ratio_to_chart) | يمثل عرض الموضع الافتراضي بوحدات جزء من مساحة الرسم البياني.|
| [default_height_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/default_height_ratio_to_chart) | يمثل ارتفاع الموضع الافتراضي بوحدات جزء من مساحة الرسم البياني.|
| [x_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/x_ratio_to_chart) | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العليا بوحدات نسبة مساحة الرسم البياني.|
| [y_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/y_ratio_to_chart) |يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات نسبة مساحة الرسم البياني.|
| [width_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/width_ratio_to_chart) | يحصل على عرض الإطار أو يعينه بوحدات نسبة مساحة الرسم البياني.|
| [height_ratio_to_chart](/cells/python-net/ar/aspose.cells.charts/datalabels/height_ratio_to_chart) | يحصل على أو يضبط ارتفاع الإطار بوحدات نسبة مساحة الرسم البياني.|
| [x_pixel](/cells/python-net/ar/aspose.cells.charts/datalabels/x_pixel) | يحصل على أو يضبط إحداثيات x للزاوية اليسرى العليا بوحدات البكسل.|
| [y_pixel](/cells/python-net/ar/aspose.cells.charts/datalabels/y_pixel) | يحصل على أو يضبط إحداثيات y للزاوية اليسرى العلوية بوحدات البكسل.|
| [width_pixel](/cells/python-net/ar/aspose.cells.charts/datalabels/width_pixel) | يحصل على عرض الإطار بوحدات البكسل أو يعينه.|
| [height_pixel](/cells/python-net/ar/aspose.cells.charts/datalabels/height_pixel) | يحصل على أو يضبط ارتفاع الإطار بوحدات البكسل.|
| [is_auto_text](/cells/python-net/ar/aspose.cells.charts/datalabels/is_auto_text) | يشير إلى أن النص تم إنشاؤه تلقائيًا.|
| [is_deleted](/cells/python-net/ar/aspose.cells.charts/datalabels/is_deleted) | يشير إلى ما إذا كان سيتم حذف علامات البيانات هذه.|
| [text_horizontal_alignment](/cells/python-net/ar/aspose.cells.charts/datalabels/text_horizontal_alignment) | يحصل على محاذاة النص الأفقية ويضبطها.|
| [text_vertical_alignment](/cells/python-net/ar/aspose.cells.charts/datalabels/text_vertical_alignment) | يحصل على محاذاة النص الرأسية أو يعينها.|
| [rotation_angle](/cells/python-net/ar/aspose.cells.charts/datalabels/rotation_angle) | يمثل زاوية دوران النص.|
| [is_automatic_rotation](/cells/python-net/ar/aspose.cells.charts/datalabels/is_automatic_rotation) | يشير إلى ما إذا كان يتم تدوير نص الرسم البياني تلقائيًا.|
| [text](/cells/python-net/ar/aspose.cells.charts/datalabels/text) | يحصل على نص تسمية البيانات أو يعينه.|
| [linked_source](/cells/python-net/ar/aspose.cells.charts/datalabels/linked_source) | يحصل على مرجع إلى ورقة العمل ويعينه.|
| [text_direction](/cells/python-net/ar/aspose.cells.charts/datalabels/text_direction) | يمثل ترتيب قراءة النص.|
| [reading_order](/cells/python-net/ar/aspose.cells.charts/datalabels/reading_order) | يمثل ترتيب قراءة النص.|
| [direction_type](/cells/python-net/ar/aspose.cells.charts/datalabels/direction_type) | يحصل على اتجاه النص ويحدده.|
| [is_text_wrapped](/cells/python-net/ar/aspose.cells.charts/datalabels/is_text_wrapped) | يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان النص ملفوفًا أم لا.|
| [is_resize_shape_to_fit_text](/cells/python-net/ar/aspose.cells.charts/datalabels/is_resize_shape_to_fit_text) | يحصل أو يضبط ما إذا كان يجب ملاءمة الشكل تلقائيًا لاحتواء النص الموصوف فيه بالكامل. الملاءمة التلقائية هي
<br/> عندما يتم تغيير حجم النص داخل الشكل لاحتواء النص بأكمله بالداخل.|
| [show_value](/cells/python-net/ar/aspose.cells.charts/datalabels/show_value) | يُمثل سلوك عرض قيم بيانات مخطط مُحدد. يُظهر "صحيح" القيم، ويُخفيها "خطأ".|
| [show_cell_range](/cells/python-net/ar/aspose.cells.charts/datalabels/show_cell_range) | يشير إلى ما إذا كان سيتم عرض نطاق الخلايا كعلامات بيانات.|
| [show_percentage](/cells/python-net/ar/aspose.cells.charts/datalabels/show_percentage) |يُمثل سلوك عرض قيمة النسبة المئوية لعلامة بيانات مخطط مُحدد. يُظهر "صحيح" قيمة النسبة المئوية. يُخفي "خطأ".|
| [show_bubble_size](/cells/python-net/ar/aspose.cells.charts/datalabels/show_bubble_size) |يُمثل سلوك عرض قيمة النسبة المئوية لعلامة بيانات مخطط مُحدد. يُظهر "صحيح" قيمة النسبة المئوية. يُخفي "خطأ".|
| [show_category_name](/cells/python-net/ar/aspose.cells.charts/datalabels/show_category_name) | يُمثل سلوك عرض اسم فئة بيانات مخطط مُحدد. استخدم "صحيح" لعرض اسم الفئة لعناوين البيانات على المخطط. استخدم "خطأ" لإخفائه.|
| [show_series_name](/cells/python-net/ar/aspose.cells.charts/datalabels/show_series_name) | يشير إلى ما إذا كان اسم السلسلة يظهر لملصقات البيانات على الرسم البياني.
<br/> صحيح لإظهار اسم السلسلة. خطأ لإخفائه.|
| [show_legend_key](/cells/python-net/ar/aspose.cells.charts/datalabels/show_legend_key) | يمثل سلوك عرض مفتاح تسمية بيانات الرسم البياني المحدد.
<br/> صحيح إذا كان مفتاح أسطورة تسمية البيانات مرئيًا.|
| [number_format](/cells/python-net/ar/aspose.cells.charts/datalabels/number_format) | يمثل سلسلة التنسيق لكائن DataLabels.|
| [number](/cells/python-net/ar/aspose.cells.charts/datalabels/number) | يحصل على تنسيق الرقم المدمج ويقوم بتعيينه.|
| [number_format_linked](/cells/python-net/ar/aspose.cells.charts/datalabels/number_format_linked) | صحيح إذا كان تنسيق الرقم مرتبطًا بالخلايا
<br/> (بحيث يتغير تنسيق الأرقام في التسميات عند تغيرها في الخلايا).|
| [separator_type](/cells/python-net/ar/aspose.cells.charts/datalabels/separator_type) | يحصل على نوع الفاصل المستخدم لعناوين البيانات على الرسم البياني أو يعينه.|
| [separator_value](/cells/python-net/ar/aspose.cells.charts/datalabels/separator_value) | يحصل على قيمة الفاصل المستخدمة لعلامات البيانات على الرسم البياني أو يعينها.|
| [position](/cells/python-net/ar/aspose.cells.charts/datalabels/position) |يمثل موضع تسمية البيانات.|
| [is_never_overlap](/cells/python-net/ar/aspose.cells.charts/datalabels/is_never_overlap) | يشير إلى ما إذا كانت علامات البيانات المعروضة لا تتداخل أبدًا. (للمخطط الدائري)|
| [shape_type](/cells/python-net/ar/aspose.cells.charts/datalabels/shape_type) | يحصل على نوع شكل تسمية البيانات أو يعينه.|


###  طُرق
| طريقة| وصف|
| :- | :- |
| [`set_position_auto(self)`](/cells/python-net/ar/aspose.cells.charts/datalabels/set_position_auto/#) | ضبط موضع الإطار إلى الوضع التلقائي|
| [`characters(self, start_index, length)`](/cells/python-net/ar/aspose.cells.charts/datalabels/characters/#int-int) |يقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص.|
| [`apply_font(self)`](/cells/python-net/ar/aspose.cells.charts/datalabels/apply_font/#) | قم بتطبيق خط تسميات البيانات على جميع العقد الفرعية.|



###  مثال

```python
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`](/cells/python-net/ar/aspose.cells.charts/chartframe)
* فئة [`ChartTextFrame`](/cells/python-net/ar/aspose.cells.charts/charttextframe)
* فئة [`DataLabels`](/cells/python-net/ar/aspose.cells.charts/datalabels)
* فئة [`Line`](/cells/python-net/ar/aspose.cells.drawing/line)