#
CwRemoveObjectFromGroup

### Syntax:

    call CwRemoveObjectFromGroup hObject

            hObject         (handle) The object to remove from its group.

### Description:

This procedure removes the specified object (hObject) from the group it occupies. If the object is not a member of a group, nothing happens. If the object is the last member of a group, the group is destroyed.

### Example:

    /* Create a bunch of objects, group them, then ungroup them. */
    a = CwCreateEffect("rectangle", "solid color")
    b = CwCreateEffect("rectangle", "solid color")
    c = CwCreateEffect("rectangle", "solid color")

    gh = CwAddObjectToGroup(a,0)
    call CwAddObjectToGroup b, gh
    call CwAddObjectToGroup c, gh

    call CwRemoveObjectFromGroup(a)
    call CwRemoveObjectFromGroup(b)
    call CwRemoveObjectFromGroup(c)

### Remarks:

Note that this procedure only affects one level of grouping. That is, if the object is in a group which is itself grouped, the object will be moved to the parent group. Use CwGetParent to determine if an object is grouped.

Functions by NAME | Index | Functions by PURPOSE