<doc>
	<legacy_id>1536</legacy_id>
	<name>clone</name>
	<type>command</type>

	<syntax>
		<example>clone [invisible] <i>object</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Duplicates an <glossary tag="object">object</glossary>.</summary>

	<examples>
<example>clone field 1</example>
<example>clone the selectedObject</example>
<example><p>clone this card</p></example>
<example>clone invisible stack "myStack"</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/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<command tag="create stack">create stack Command</command>
		<command tag="create card">create card Command</command>
		<command tag="copy">copy Command</command>
		<command tag="paste">paste Command</command>
		<message tag="newButton">newButton Message</message>
		<message tag="newEPS">newEPS Message</message>
		<message tag="newPlayer">newPlayer Message</message>
		<message tag="newField">newField Message</message>
		<message tag="newScrollbar">newScrollbar Message</message>
		<message tag="newGraphic">newGraphic Message</message>
		<message tag="newImage">newImage Message</message>
		<message tag="newCard">newCard Message</message>
		<message tag="newGroup">newGroup Message</message>
	</references>

	<description>
	<overview>Use the <b>clone</b> <glossary tag="command">command</glossary> to create a copy of an existing <glossary tag="object">object</glossary>.</overview>

		<parameters>
<parameter>
<name>object</name>
<description>An object or stack reference or an expression that resolves to either.</description>
</parameter>		</parameters>

	<value>The <b>clone</b> command places the long id property of the newly created object in the <keyword tag="it">it Keyword</keyword>.</value>
	<comments>If the <i>object</i> is a <keyword tag="control">control</keyword>, its copy is placed on the <glossary tag="current card">current card</glossary>, 32 <property tag="pixels">pixels</property> below and to the right of the original <glossary tag="object">object</glossary>. The copy's <property tag="name">name</property> and other <property tag="properties">properties</property> are the same as those of the original. If the <i>object</i> is a <glossary tag="grouped control">grouped control</glossary>, the clone is also <glossary tag="owner">owned</glossary> by the <command tag="group">group</command>.<p></p><p></p><note> If invisible is specified the new object will have its visible property set to false.</note><p></p><p>If the <i>object</i> is a <keyword tag="card">card</keyword>, the copy becomes the <glossary tag="current card">current card</glossary>.</p><p></p><p>If the <i>object</i> is a <object tag="stack">stack</object>, the newly created <object tag="stack">stack</object> is opened. It is named "Copy of" and the stack's name.</p><p></p><p></p><p></p><p>The <b>clone</b> <glossary tag="command">command</glossary> does not affect the contents of the <function tag="clipboard">clipboard</function>.</p></comments>
	</description>
</doc>