can_have_image property

ShapeBase.can_have_image property

Returns True if the shape type allows the shape to have an image.

@property
def can_have_image(self) -> bool:
    ...

Remarks

Although Microsoft Word has a special shape type for images, it appears that in Microsoft Word documents any shape except a group shape can have an image, therefore this property returns True for all shapes except GroupShape.

Examples

Shows how to insert and rotate an image.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)
# Insert a shape with an image.
shape = builder.insert_image(drawing.Image.from_file(IMAGE_DIR + 'Logo.jpg'))
self.assertTrue(shape.can_have_image)
self.assertTrue(shape.has_image)
# Rotate the image 45 degrees clockwise.
shape.rotation = 45
doc.save(ARTIFACTS_DIR + 'Shape.rotate.docx')

See Also

ShapeBase.bounds_with_effects property ShapeBase.coord_origin property