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