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

• module aspose.words.drawing
• class ShapeBase