A logical group of objects. This object implements some methods that help deal with object groups.

<q ref="core.gml:Object">Object</q><h2>How does the clone work?</h2> The clone operation behaves as follows: <ol><li>First you select a group of elements through the Storyboard's UI either by marking each element, or by marking rectangular area. </li><li>You copy the selection into the clipboard and then select "paste". alternatively, select "duplicate". </li><li>The group of visual elements is translated to a group of base objects. <BR/> At this point it is also expanded to include additional elements (e.g. members of selected states, links connecting members of selected states) <BR/> </li><li>The selected elements are tested whether each can be cloned, using the canCloneElement. Some elements may be removed from the collection of elements to clone <BR/> (e.g. a selected link whose target interactor was not selected) </li><li>The following events and callbacks are then called: <ol><li><b>onClone()</b> - to actually clone every member of the selected elements.<BR/> This callback is responsible to update a collection that stores the mapping between IDs of the original elements and the newly cloned elements.<BR/> This mapping collection is required for the onFixClonedReferences callback.<BR/> </li><li><b>onFixClonedReferences()</b> - every object goes over its properties and recognizes every property that actually points to another element. <BR/> If this element is one of the cloned, it updates the property to point to the newly cloned element. <BR/> <q ref="core.gml:GmlObject">GmlObject</q> provides a default implementation for this method, and derived classes may enhance it to deal with specific properties.<BR/> </li><li><b>onLoad()</b> - the onLoad callback is called for every cloned element, and markes the end of the clone operation. </li></ol> </li></ol>(c) SAP AG 2003-2006. All rights reserved.