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 в указанной легенде диаграммы.
Установка записей легенды поверхностной диаграммы не поддерживается. Таким образом, он вернет null, если тип диаграммы является типом поверхностной диаграммы. |
| legend_entries_labels | Получает метки записей легенды после вызова метода Chart.Calculate(). |
| is_over_lay | Получает или задает, разрешается ли другим элементам диаграммы перекрывать этот элемент диаграммы. |
Методы
| Метод | Описание |
|---|---|
| set_position_auto() | Установите положение кадра на автоматический |
| characters(start_index, length) | Возвращает объект Characters, представляющий диапазон символов в тексте. |
Пример
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