<RULES urn="#[FILE_URN]" language="GmlScript">

<define rule="doCut" transactive="true" protected="true" autodoc="true">
	<summary>Cuts a collection of elements to the clipboard</summary>

	<dependencies>
		<pre-condition test="@canRemove == true"/>
	</dependencies>

   <parameters>
   	<param name="unit"     type="gml2:Unit">The unit classifier</param>
   	<param name="board"    type="dev:IBoard">The board classifier</param>
   	<param name="parent"   type="gml2:Element">The parent classifier. This is the most immediate ancestor that contains all the elements to be cut</param>
   	<param name="elements" type="GmlObject[id]">The collection of element instances to cut</param>
   </parameters>

   <classifiers>
   	<classifier name="unit"/>
   	<classifier name="board"/>
   	<classifier name="parent"/>
   </classifiers>

   <return type="Boolean"/>

	<remarks>
	<title>Behavior</title>
	The default behavior is to cut the given elements collection to the clipboard.
	The behavior can be extended to perform custom actions when elements are cut to the clipboard.
	</remarks>
   <copyright>(c) SAP AG 2003-2006. All rights reserved.</copyright>
</define>

</RULES>
