DataLabels класс

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_fontTrue, если размер шрифта текста в объекте изменяется при изменении размера объекта. Значение по умолчанию — True.
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Определяет поведение отображения значений меток данных указанной диаграммы. Значение True отображает значения. Значение False скрывает значения.
show_cell_rangeУказывает, отображать ли диапазон ячеек в качестве меток данных.
show_percentageОпределяет поведение отображения процентного значения метки данных указанной диаграммы. Значение True отображает процентное значение. Значение False скрывает.
show_bubble_sizeОпределяет поведение отображения процентного значения метки данных указанной диаграммы. Значение True отображает процентное значение. Значение False скрывает.
show_category_nameПредставляет поведение отображения имени категории меток данных указанной диаграммы. Значение True используется для отображения имени категории для меток данных на диаграмме. Значение False используется для скрытия.
show_series_nameУказывает, отображается ли название серии для меток данных на диаграмме.
True — отображать название серии. False — скрывать.
show_legend_keyПредставляет поведение отображения клавиши легенды метки данных указанной диаграммы.
True, если ключ легенды метки данных виден.
number_formatПредставляет строку формата для объекта DataLabels.
numberПолучает и задает встроенный числовой формат.
number_format_linkedTrue, если числовой формат связан с ячейками
(чтобы формат чисел в надписях менялся при его изменении в ячейках).
separator_typeВозвращает или задает тип разделителя, используемый для меток данных на диаграмме.
separator_valueВозвращает или задает значение разделителя, используемого для меток данных на диаграмме.
positionПредставляет положение метки данных.
is_never_overlapУказывает, будут ли отображаемые метки данных никогда не перекрываться. (Для круговой диаграммы)
shape_typeВозвращает или задает тип формы метки данных.

Методы

МетодОписание
set_position_auto(self)Установить положение рамки на автоматическое
characters(self, start_index, length)Возвращает объект Characters, представляющий диапазон символов в тексте.
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

Смотрите также

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