DataLabels класс

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

Наследование: DataLabels → ChartTextFrame → ChartFrame

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

Характеристики

Свойство	Описание
is_inner_mode	Указывает, включает ли размер области графика деления и метки осей. Значение False указывает, что размер должен определять размер области графика, делений и меток осей.
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 позиции по умолчанию
default_y	Представляет y позиции по умолчанию
default_width	Представляет ширину позиции по умолчанию
default_height	Представляет высоту позиции по умолчанию
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	Представляет поведение отображения значений меток данных указанной диаграммы. True отображает значения. Ложь, чтобы скрыть.
show_cell_range	Указывает, отображается ли диапазон ячеек в качестве меток данных.
show_percentage	Представляет поведение отображения процентного значения метки данных указанной диаграммы. True отображает процентное значение. Ложь, чтобы скрыть.
show_bubble_size	Представляет поведение отображения процентного значения метки данных указанной диаграммы. True отображает процентное значение. Ложь, чтобы скрыть.
show_category_name	Представляет поведение отображения имени категории метки данных указанной диаграммы. Значение True для отображения имени категории для меток данных на диаграмме. Ложь, чтобы скрыть.
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	Установить положение рамки на автоматическое
characters	Возвращает объект символов, представляющий диапазон символов в тексте.

Пример

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

ChartTextFrame класс DisplayUnitLabel класс