is_top_level property

ShapeBase.is_top_level property

Returns True if this shape is not a child of a group shape.

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

Examples

Shows how to tell whether a shape is a part of a group shape.

doc = aw.Document()
shape = aw.drawing.Shape(doc, aw.drawing.ShapeType.RECTANGLE)
shape.width = 200
shape.height = 200
shape.wrap_type = aw.drawing.WrapType.NONE
# A shape by default is not part of any group shape, and therefore has the "IsTopLevel" property set to "true".
self.assertTrue(shape.is_top_level)
group = aw.drawing.GroupShape(doc)
group.append_child(shape)
# Once we assimilate a shape into a group shape, the "IsTopLevel" property changes to "false".
self.assertFalse(shape.is_top_level)

See Also

ShapeBase.is_signature_line property ShapeBase.is_word_art property