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 | True, если размер шрифта текста в объекте изменяется при изменении размера объекта. Значение по умолчанию — 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_linked | True, если числовой формат связан с ячейками (чтобы формат чисел в надписях менялся при его изменении в ячейках). |
| 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
Смотрите также
- модуль
aspose.cells.charts - класс
ChartFrame - класс
ChartTextFrame - класс
DataLabels - класс
Line