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

interface XShapeGrouper
Description
specifies the group/ungroup functionality.
Developers Guide
10.3.2 Drawing Documents and Presentation Documents - Working with Drawing Documents - Shapes - Shape Operations - Grouping, Combining and Binding

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

Description
groups the Shape s 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 Shape s that will be grouped. They must all be inserted into the same GenericDrawPage .
Returns
a newly created GroupShape that contains all Shape s from xShapes and is also added to the GenericDrawPage of the Shape s in xShapes.
ungroup
void
ungroup( [in] XShapeGroup  aGroup );

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