Legend класс
Legend класс
Инкапсулирует объект, представляющий легенду диаграммы.
Наследование: Legend →
ChartTextFrame →
ChartFrame
Тип Legend предоставляет следующие элементы:
Характеристики
| Свойство | Описание |
|---|---|
| is_inner_mode | Указывает, включает ли размер области графика деления и метки осей. Значение False указывает, что размер должен определять размер области графика, делений и меток осей. |
| border | Получает Line. |
| area | Получает ChartFrame.area. |
| text_font | Получает объект ChartFrame.font указанного объекта ChartFrame. |
| text_options | Получает и задает параметры текста. |
| font | Получает объект ChartFrame.font указанного объекта ChartFrame. |
| 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 | Получает или задает значение, указывающее, должна ли фигура автоматически подгоняться, чтобы полностью содержать описанный в ней текст. Автоподбор когда текст внутри фигуры масштабируется, чтобы вместить весь текст внутри. |
| position | Получает или задает тип положения легенды. |
| legend_entries | Получает коллекцию всех объектов LegendEntry в указанной легенде диаграммы. Установка записей легенды поверхностной диаграммы не поддерживается. Таким образом, он вернет ноль, если тип диаграммы является типом поверхностной диаграммы. |
| legend_entries_labels | Получает метки записей легенды после вызова метода Chart.Calculate(). |
| is_over_lay | Получает или задает, разрешено ли другим элементам диаграммы перекрывать этот элемент диаграммы. |
Методы
| Метод | Описание |
|---|---|
| set_position_auto | Установить положение рамки на автоматическое |
| characters | Возвращает объект символов, представляющий диапазон символов в тексте. |
| get_legend_labels | Получает метки записей легенды после вызова метода Chart.Calculate(). |
Пример
from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType
workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT
Смотрите также
- модуль
aspose.cells.charts - класс
ChartFrame - класс
ChartTextFrame - класс
Legend - класс
Line
