#
CwGroupObjects

### Syntax:

    hGroup = CwGroupObjects()

            hGroup          (handle) The handle to the new group.

### Description:

This function groups all of the objects within the current selection rectangle and returns a handle to the group. If there are no objects within the selection rectangle, an error is raised. Using this function is roughly equivalent to using the "Group objects" menu item in the user interface.

### Example:

    /* Group all objects within the current cropping rectangle. */
    ah=CwGetAppHandle('output settings')
    maxwidth=CwGetProperty(ah, 'output size:width')
    maxheight=CwGetProperty(ah, 'output size:height')

    call CwSetSelectionRectangle maxwidth/2, maxheight/2, maxwidth*2, maxheight*2
    gh = CwGroupObjects()

Functions by NAME | Index | Functions by PURPOSE