##  DataLabels класс
Инкапсулирует коллекцию всех объектов DataLabel для указанной серии.



**Наследование:** [`DataLabels`](/cells/python-net/aspose.cells.charts/datalabels) → 
[`ChartTextFrame`](/cells/python-net/aspose.cells.charts/charttextframe) → 
[`ChartFrame`](/cells/python-net/ru/aspose.cells.charts/chartframe)



Тип DataLabels предоставляет следующие элементы:

###  Характеристики
| Свойство| Описание|
| :- | :- |
| [is_inner_mode](/cells/python-net/ru/aspose.cells.charts/datalabels/is_inner_mode) | Указывает, включает ли размер области графика деления и подписи осей.
<br/> Значение False указывает, что размер будет определять размер области графика, отметок и подписей осей.|
| [border](/cells/python-net/ru/aspose.cells.charts/datalabels/border) | Получает [`Line`](/cells/python-net/ru/aspose.cells.drawing/line).|
| [area](/cells/python-net/ru/aspose.cells.charts/datalabels/area) | Получает [`DataLabels.area`](/cells/python-net/ru/aspose.cells.charts/datalabels#area).|
| [text_font](/cells/python-net/ru/aspose.cells.charts/datalabels/text_font) |Получает объект [`ChartFrame.font`](/cells/python-net/ru/aspose.cells.charts/chartframe#font) указанного объекта ChartFrame.|
| [text_options](/cells/python-net/ru/aspose.cells.charts/datalabels/text_options) | Получает и задает параметры текста.|
| [font](/cells/python-net/ru/aspose.cells.charts/datalabels/font) | Получает шрифт DataLabels;|
| [auto_scale_font](/cells/python-net/ru/aspose.cells.charts/datalabels/auto_scale_font) | True, если размер шрифта текста в объекте изменяется при изменении размера объекта. Значение по умолчанию — True.|
| [background_mode](/cells/python-net/ru/aspose.cells.charts/datalabels/background_mode) | Получает и задает режим отображения фона|
| [background](/cells/python-net/ru/aspose.cells.charts/datalabels/background) | Получает и задает режим отображения фона|
| [is_automatic_size](/cells/python-net/ru/aspose.cells.charts/datalabels/is_automatic_size) | Указывает, автоматически ли изменяется размер рамки диаграммы.|
| [x](/cells/python-net/ru/aspose.cells.charts/datalabels/x) | Возвращает или задает координату x верхнего левого угла в единицах 1/4000 области диаграммы.|
| [y](/cells/python-net/ru/aspose.cells.charts/datalabels/y) | Возвращает или задает координату Y верхнего левого угла в единицах 1/4000 области диаграммы.|
| [height](/cells/python-net/ru/aspose.cells.charts/datalabels/height) | Возвращает или задает высоту кадра в единицах 1/4000 области диаграммы.|
| [width](/cells/python-net/ru/aspose.cells.charts/datalabels/width) | Возвращает или задает ширину рамки в единицах 1/4000 области диаграммы.|
| [shadow](/cells/python-net/ru/aspose.cells.charts/datalabels/shadow) | Истина, если у рамки есть тень.|
| [shape_properties](/cells/python-net/ru/aspose.cells.charts/datalabels/shape_properties) | Получает объект [`ChartFrame.shape_properties`](/cells/python-net/ru/aspose.cells.charts/chartframe#shape_properties).|
| [is_default_pos_be_set](/cells/python-net/ru/aspose.cells.charts/datalabels/is_default_pos_be_set) |Указывает, задано ли положение по умолчанию (DefaultX, DefaultY, DefaultWidth и DefaultHeight).|
| [default_x](/cells/python-net/ru/aspose.cells.charts/datalabels/default_x) | Представляет x позиции по умолчанию в единицах, равных 1/4000 площади диаграммы.|
| [default_y](/cells/python-net/ru/aspose.cells.charts/datalabels/default_y) | Представляет y положения по умолчанию в единицах, равных 1/4000 площади диаграммы.|
| [default_width](/cells/python-net/ru/aspose.cells.charts/datalabels/default_width) | Представляет ширину позиции по умолчанию в единицах 1/4000 области диаграммы.|
| [default_height](/cells/python-net/ru/aspose.cells.charts/datalabels/default_height) | Представляет высоту позиции по умолчанию в единицах, равных 1/4000 площади диаграммы.|
| [default_x_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/default_x_ratio_to_chart) | Представляет x позиции по умолчанию в единицах доли области диаграммы.|
| [default_y_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/default_y_ratio_to_chart) | Представляет y положения по умолчанию в единицах доли области диаграммы.|
| [default_width_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/default_width_ratio_to_chart) | Представляет ширину позиции по умолчанию в единицах доли области диаграммы.|
| [default_height_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/default_height_ratio_to_chart) | Представляет высоту позиции по умолчанию в единицах доли области диаграммы.|
| [x_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/x_ratio_to_chart) | Возвращает или задает координату x верхнего левого угла в единицах отношения площади диаграммы.|
| [y_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/y_ratio_to_chart) |Возвращает или задает координату Y верхнего левого угла в единицах отношения площади диаграммы.|
| [width_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/width_ratio_to_chart) | Возвращает или задает ширину рамки в единицах отношения площади диаграммы.|
| [height_ratio_to_chart](/cells/python-net/ru/aspose.cells.charts/datalabels/height_ratio_to_chart) | Возвращает или задает высоту рамки в единицах отношения площади диаграммы.|
| [x_pixel](/cells/python-net/ru/aspose.cells.charts/datalabels/x_pixel) | Возвращает или задает координату x верхнего левого угла в пикселях.|
| [y_pixel](/cells/python-net/ru/aspose.cells.charts/datalabels/y_pixel) | Возвращает или задает координату Y верхнего левого угла в пикселях.|
| [width_pixel](/cells/python-net/ru/aspose.cells.charts/datalabels/width_pixel) | Возвращает или задает ширину кадра в пикселях.|
| [height_pixel](/cells/python-net/ru/aspose.cells.charts/datalabels/height_pixel) | Возвращает или задает высоту кадра в пикселях.|
| [is_auto_text](/cells/python-net/ru/aspose.cells.charts/datalabels/is_auto_text) | Указывает, что текст сгенерирован автоматически.|
| [is_deleted](/cells/python-net/ru/aspose.cells.charts/datalabels/is_deleted) | Указывает, удалены ли эти метки данных.|
| [text_horizontal_alignment](/cells/python-net/ru/aspose.cells.charts/datalabels/text_horizontal_alignment) | Получает и задает горизонтальное выравнивание текста.|
| [text_vertical_alignment](/cells/python-net/ru/aspose.cells.charts/datalabels/text_vertical_alignment) | Получает или задает вертикальное выравнивание текста.|
| [rotation_angle](/cells/python-net/ru/aspose.cells.charts/datalabels/rotation_angle) | Представляет угол поворота текста.|
| [is_automatic_rotation](/cells/python-net/ru/aspose.cells.charts/datalabels/is_automatic_rotation) | Указывает, поворачивается ли текст диаграммы автоматически.|
| [text](/cells/python-net/ru/aspose.cells.charts/datalabels/text) | Получает или задает текст метки данных.|
| [linked_source](/cells/python-net/ru/aspose.cells.charts/datalabels/linked_source) | Получает и задает ссылку на рабочий лист.|
| [text_direction](/cells/python-net/ru/aspose.cells.charts/datalabels/text_direction) | Представляет порядок чтения текста.|
| [reading_order](/cells/python-net/ru/aspose.cells.charts/datalabels/reading_order) | Представляет порядок чтения текста.|
| [direction_type](/cells/python-net/ru/aspose.cells.charts/datalabels/direction_type) | Получает и задает направление текста.|
| [is_text_wrapped](/cells/python-net/ru/aspose.cells.charts/datalabels/is_text_wrapped) | Возвращает или задает значение, указывающее, переносится ли текст.|
| [is_resize_shape_to_fit_text](/cells/python-net/ru/aspose.cells.charts/datalabels/is_resize_shape_to_fit_text) | Возвращает или задаёт, должна ли фигура автоматически подгоняться под размер текста, описанного внутри неё. Автоматическая подгонка — это
<br/> когда текст внутри фигуры масштабируется так, чтобы вместить весь текст внутри.|
| [show_value](/cells/python-net/ru/aspose.cells.charts/datalabels/show_value) | Определяет поведение отображения значений меток данных указанной диаграммы. Значение True отображает значения. Значение False скрывает значения.|
| [show_cell_range](/cells/python-net/ru/aspose.cells.charts/datalabels/show_cell_range) | Указывает, отображать ли диапазон ячеек в качестве меток данных.|
| [show_percentage](/cells/python-net/ru/aspose.cells.charts/datalabels/show_percentage) |Определяет поведение отображения процентного значения метки данных указанной диаграммы. Значение True отображает процентное значение. Значение False скрывает.|
| [show_bubble_size](/cells/python-net/ru/aspose.cells.charts/datalabels/show_bubble_size) |Определяет поведение отображения процентного значения метки данных указанной диаграммы. Значение True отображает процентное значение. Значение False скрывает.|
| [show_category_name](/cells/python-net/ru/aspose.cells.charts/datalabels/show_category_name) | Представляет поведение отображения имени категории меток данных указанной диаграммы. Значение True используется для отображения имени категории для меток данных на диаграмме. Значение False используется для скрытия.|
| [show_series_name](/cells/python-net/ru/aspose.cells.charts/datalabels/show_series_name) | Указывает, отображается ли название серии для меток данных на диаграмме.
<br/> True — отображать название серии. False — скрывать.|
| [show_legend_key](/cells/python-net/ru/aspose.cells.charts/datalabels/show_legend_key) | Представляет поведение отображения клавиши легенды метки данных указанной диаграммы.
<br/> True, если ключ легенды метки данных виден.|
| [number_format](/cells/python-net/ru/aspose.cells.charts/datalabels/number_format) | Представляет строку формата для объекта DataLabels.|
| [number](/cells/python-net/ru/aspose.cells.charts/datalabels/number) | Получает и задает встроенный числовой формат.|
| [number_format_linked](/cells/python-net/ru/aspose.cells.charts/datalabels/number_format_linked) | True, если числовой формат связан с ячейками
<br/> (чтобы формат чисел в надписях менялся при его изменении в ячейках).|
| [separator_type](/cells/python-net/ru/aspose.cells.charts/datalabels/separator_type) | Возвращает или задает тип разделителя, используемый для меток данных на диаграмме.|
| [separator_value](/cells/python-net/ru/aspose.cells.charts/datalabels/separator_value) | Возвращает или задает значение разделителя, используемого для меток данных на диаграмме.|
| [position](/cells/python-net/ru/aspose.cells.charts/datalabels/position) |Представляет положение метки данных.|
| [is_never_overlap](/cells/python-net/ru/aspose.cells.charts/datalabels/is_never_overlap) | Указывает, будут ли отображаемые метки данных никогда не перекрываться. (Для круговой диаграммы)|
| [shape_type](/cells/python-net/ru/aspose.cells.charts/datalabels/shape_type) | Возвращает или задает тип формы метки данных.|


###  Методы
| Метод| Описание|
| :- | :- |
| [`set_position_auto(self)`](/cells/python-net/ru/aspose.cells.charts/datalabels/set_position_auto/#) | Установить положение рамки на автоматическое|
| [`characters(self, start_index, length)`](/cells/python-net/ru/aspose.cells.charts/datalabels/characters/#int-int) |Возвращает объект Characters, представляющий диапазон символов в тексте.|
| [`apply_font(self)`](/cells/python-net/ru/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/ru/aspose.cells.charts/chartframe)
* класс [`ChartTextFrame`](/cells/python-net/ru/aspose.cells.charts/charttextframe)
* класс [`DataLabels`](/cells/python-net/ru/aspose.cells.charts/datalabels)
* класс [`Line`](/cells/python-net/ru/aspose.cells.drawing/line)