ChartTitle class

ChartTitle class

Provides access to the chart title properties. To learn more, visit the Working with Charts documentation article.

Properties

NameDescription
fontProvides access to the font formatting of the chart title.
formatProvides access to fill and line formatting of the chart title.
overlayDetermines whether other chart elements shall be allowed to overlap title. By default overlay is False.
showDetermines whether the title shall be shown for this chart. Default value is True.
textGets or sets the text of the chart title. If None or empty value is specified, auto generated title will be shown.

Examples

Shows how to insert a chart and set a title.

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

# Insert a chart shape with a document builder and get its chart.
chart_shape = builder.insert_chart(aw.drawing.charts.ChartType.BAR, 400, 300)
chart = chart_shape.chart

# Use the "title" property to give our chart a title, which appears at the top center of the chart area.
title = chart.title
title.text = "My Chart"
title.font.size = 15
title.font.color = drawing.Color.blue

# Set the "show" property to "True" to make the title visible.
title.show = True

# Set the "overlay" property to "True" Give other chart elements more room by allowing them to overlap the title
title.overlay = True

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

See Also