<doc>

<legacy_id>1586</legacy_id>

<name>cut</name>

<type>command</type>

<syntax>

<example>cut [<i>object</i>]</example>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

</synonyms>

<classification>

<category>User Interaction</category>

</classification>

<references>

<command tag="delete">delete Command</command>

<command tag="copy">copy Command</command>

<function tag="clipboard">clipboard Function</function>

<message tag="cutKey">cutKey Message</message>

</references>

<history>

<introduced version="1.0">Added.</introduced>

</history>

<platforms>

<mac/>

<windows/>

<linux/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

</classes>

<security>

</security>

<summary>Copies the <property tag="selected">selected</property> text or the <property tag="selected">selected</property> section of an <keyword tag="image">image</keyword>, or an <glossary tag="object">object</glossary>, and deletes it from the <keyword tag="selection">selection</keyword>.</summary>

<examples>

<example>cut <code><i>-- cuts whatever is selected</i></code></example>

<example>cut player "Quivering Apple" from recent card</example>

<example>cut the selectedObject</example>

</examples>

<description>

<p>Use the <b>cut</b> command to place <glossary tag="object">objects</glossary> or text on the <function tag="clipboard">clipboard</function> while removing them from the <object tag="stack">stack</object>.</p><p/><p><b>Parameters:</b></p><p>The <i>object</i> is any available <glossary tag="object">object</glossary>. If no <i>object</i> is specified, the <b>cut</b> <glossary tag="command">command</glossary> cuts whatever is currently <property tag="selected">selected</property> to the <function tag="clipboard">clipboard</function>.</p><p/><p><b>Comments:</b></p><p>If no object is specified, the <b>cut</b> <glossary tag="command">command</glossary> is equivalent to choosing <a/><b/>Edit menu<img src="202656"/>Cut<important/>.</p>

</description>

</doc>