<doc>
	<legacy_id>1091</legacy_id>
	<name>delete</name>
	<type>command</type>

	<syntax>
		<example>delete [<i>object</i>]</example>
	</syntax>

	<synonyms>
		<synonym>clear</synonym>
	</synonyms>

	<summary>Removes 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>.</summary>

	<examples>
<example>delete</example>
<example>delete this card</example>
<example><p>delete button 1</p></example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Objects &amp; Messages</category>
		<category>User Interaction</category>
	</classification>

	<references>
		<function tag="deleteResource">deleteResource Function</function>
		<command tag="ungroup">ungroup Command</command>
		<command tag="cut">cut Command</command>
		<command tag="delete chunk">delete chunk Command</command>
		<command tag="delete file">delete file Command</command>
		<command tag="delete stack">delete stack Command</command>
		<command tag="delete variable">delete variable Command</command>
		<command tag="remove">remove Command</command>
		<command tag="undo">undo Command</command>
		<command tag="compact">compact Command</command>
		<property tag="cantDelete">cantDelete Property</property>
		<message tag="deleteBackground">deleteBackground Message</message>
		<message tag="deleteButton">deleteButton Message</message>
		<message tag="deleteCard">deleteCard Message</message>
		<message tag="deleteEPS">deleteEPS Message</message>
		<message tag="deleteField">deleteField Message</message>
		<message tag="deleteGraphic">deleteGraphic Message</message>
		<message tag="deleteGroup">deleteGroup Message</message>
		<message tag="deleteImage">deleteImage Message</message>
		<message tag="deletePlayer">deletePlayer Message</message>
	</references>

	<description>Use the <b>delete</b> <glossary tag="command">command</glossary> to remove <glossary tag="object">objects</glossary> or text 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>delete</b> <glossary tag="command">command</glossary> removes whatever is currently <property tag="selected">selected</property>.</p><p></p><p><b>Comments:</b></p><p>If no <i>object</i> is specified, the <b>delete</b> <glossary tag="command">command</glossary> is equivalent to pressing the Delete key. It removes the <keyword tag="selection">selection</keyword>.</p><p></p><p>Use the <b>delete</b> <glossary tag="command">command</glossary> to remove a <keyword tag="control">control</keyword>, <keyword tag="card">card</keyword>, or <command tag="group">group</command> permanently. To remove an <glossary tag="object">object</glossary> and place it on the <function tag="clipboard">clipboard</function> for pasting elsewhere, use the <command tag="cut">cut</command> <glossary tag="command">command</glossary> instead. To temporarily hide a <keyword tag="control">control</keyword>, use the <command tag="hide">hide</command> <glossary tag="command">command</glossary> instead.</p><p></p><p></p><important> You cannot delete the <glossary tag="object">object</glossary> whose <property tag="script">script</property> holds a currently <glossary tag="execute">executing</glossary><glossary tag="handler">handler</glossary>.</important></description>
</doc>