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_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 Возвращает или задает логическое значение, указывающее поведение отображения имени ряда для меток данных на диаграмме.
Значение true, чтобы показать название серии. Ложь скрывать.
show_legend_key Представляет поведение отображения ключа легенды метки данных указанной диаграммы.
Истинно, если ключ легенды метки данных виден.
number_format Представляет строку формата для объекта DataLabels.
number Получает и задает встроенный числовой формат.
number_format_linked Истинно, если числовой формат связан с ячейками
(чтобы формат числа менялся в метках при изменении в ячейках).
separator Получает или задает тип разделителя, используемый для меток данных на диаграмме.
separator_type Получает или задает тип разделителя, используемый для меток данных на диаграмме.
separator_value Получает или задает значение разделителя, используемое для меток данных на диаграмме.
position Представляет положение метки данных.
is_never_overlap Указывает, не перекрываются ли отображаемые метки данных. (Для круговой диаграммы)
shape_type Получает или задает тип формы метки данных.

Методы

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