text property

ChartAxisTitle.text property

Gets or sets the text of the axis title. If None or empty value is specified, auto generated title will be shown.

@property
def text(self) -> str:
    ...

@text.setter
def text(self, value: str):
    ...

Remarks

Use ChartAxisTitle.show option if you need to show the title.

Examples

Shows how to set chart axis title.

doc = Document()

builder = DocumentBuilder(doc)
shape = builder.insert_chart(ChartType.COLUMN, 432, 252)

chart = shape.chart

series_coll = chart.series
# Delete default generated series.
series_coll.clear()

series_coll.add("AW Series 1", ["AW Category 1", "AW Category 2"], [1, 2])

# Set axis title.
chart.axis_x.title.text = "Categories"
chart.axis_x.title.show = True
chart.axis_y.title.text = "Values"
chart.axis_y.title.show = True
chart.axis_y.title.overlay = True
chart.axis_y.title.font.size = 12
chart.axis_y.title.font.color = drawing.Color.blue

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

See Also

ChartAxisTitle.show property