alternative_text property

ShapeBase.alternative_text property

Defines alternative text to be displayed instead of a graphic.

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

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

Remarks

The default value is an empty string.

Examples

Shows how to use a shape’s alternative text.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)
shape = builder.insert_shape(aw.drawing.ShapeType.CUBE, 150, 150)
shape.name = "MyCube"

shape.alternative_text = "Alt text for MyCube."

# We can access the alternative text of a shape by right-clicking it, and then via "Format AutoShape" -> "Alt Text".
doc.save(ARTIFACTS_DIR + "Shape.alt_text.docx")

# Save the document to HTML, and then delete the linked image that belongs to our shape.
# The browser that is reading our HTML will display the alt text in place of the missing image.
doc.save(ARTIFACTS_DIR + "Shape.alt_text.html")
os.remove(ARTIFACTS_DIR + "Shape.alt_text.001.png")

See Also