:: com :: sun :: star :: drawing ::

interface XShapeGrouper
Description
specifies the group/ungroup functionality.
Developers Guide
Drawings - Grouping, Combining and Binding

Methods' Summary
group groups the Shapes inside a collection.  
ungroup ungroups a given GroupShape.  
Methods' Details
group
XShapeGroup
group( [in] XShapes  xShapes );

Description
groups the Shapes inside a collection.

Grouping of objects in text documents works only if none of the objects has an anchor of type AS_CHARACTER

.
Parameter xShapes
the Shapes that will be grouped. They must all be inserted into the same GenericDrawPage.
Returns
a newly created GroupShape that contains all Shapes from xShapes and is also added to the GenericDrawPage of the Shapes in xShapes.
ungroup
void
ungroup( [in] XShapeGroup  aGroup );

Description
ungroups a given GroupShape.
Parameter aGroup
moves all Shapes from this GroupShape to the parent XShapes of the GroupShape. The GroupShape is than removed from the GenericDrawPage and disposed.
Top of Page