LegendPosition enumeration

LegendPosition enumeration

Specifies the possible positions for a chart legend.

Members

NameDescription
NONENo legend will be shown for the chart.
BOTTOMSpecifies that the legend shall be drawn at the bottom of the chart.
LEFTSpecifies that the legend shall be drawn at the left of the chart.
RIGHTSpecifies that the legend shall be drawn at the right of the chart.
TOPSpecifies that the legend shall be drawn at the top of the chart.
TOP_RIGHTSpecifies that the legend shall be drawn at the top right of the chart.

Examples

Shows how to edit the appearance of a chart’s legend.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 450, 300)
chart = shape.chart

self.assertEqual(3, chart.series.count)
self.assertEqual("Series 1", chart.series[0].name)
self.assertEqual("Series 2", chart.series[1].name)
self.assertEqual("Series 3", chart.series[2].name)

# Move the chart's legend to the top right corner.
legend = chart.legend
legend.position = aw.drawing.charts.LegendPosition.TOP_RIGHT

# Give other chart elements, such as the graph, more room by allowing them to overlap the legend.
legend.overlay = True

doc.save(ARTIFACTS_DIR + "Charts.chart_legend.docx")

See Also