<doc>
	<legacy_id>1654</legacy_id>
	<name>create</name>
	<type>command</type>

	<syntax>
		<example>create [invisible] <i>type</i> [<i>name</i>] [in <i>group</i>]</example>
	</syntax>

	<synonyms>
		<synonym>new</synonym>
	</synonyms>

	<summary>Creates a new object on the current card.</summary>

	<examples>
<example>create button "Click Me"</example>
<example>create invisible field in group 1</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>Standalone Applications</category>
	</classification>

	<references>
		<command tag="create stack">create stack Command</command>
		<command tag="create card">create card Command</command>
	</references>

	<description>
	<overview>Use the create command to make a new control or grouped control.</overview>

		<parameters>
<parameter>
<name>type</name>
<description>A string, one of the following: field, button, image, scrollbar, graphic, player, or EPS.</description>
</parameter>

<parameter>
<name>name</name>
<description>The name to call the newly created object. If you don't specify a name, the object is created with a default name.</description>
</parameter>

<parameter>
<name>group</name>
<description>A reference to a group on the current card or a expression that evaluates to a reference.any group that's on the current card. If you specify a group, the new object is a member of the group, and exists on each card that has the group. If you don't specify a group, the object is created on the current card and appears only on that card.</description>
</parameter>		</parameters>

	<value></value>
	<comments>The new object takes its properties from the corresponding template; for example, newly created buttons match the properties of the templateButton.<p></p><p>If you use theform, the object is created with its visible property set to false, so it cannot be seen. Use this form to create a hidden object, change its appearance or position, then make it visible.</p><p></p><p>The <b>create</b> command places the ID property of the newly created object in the it variable.</p><p></p><p>When the new control is created, the Pointer tool is automatically chosen. If you use the create command in a handler, you can use the following statement after the create command to resume using the Browse tool:</p><p></p><p><font face="Lucida Grande" size="11" color="#000000">send "choose browse tool" to me in 1 tick</font></p><p></p><p><note> In the development environment, after an object is created, LiveCode automatically resets the corresponding template to its default values. This means that if you change an objecttemplate and then create several objects of that type, only the first object will reflect your settings. To prevent LiveCode from automatically setting the template back to its defaults, set the lockMessages property to true before creating the objects:</p><p></note><p>LiveCode resets the template only when in the development environment, not in standalone applications.</p><p></p><p><font face="Lucida Grande" size="11" color="#000000">set the borderWidth of the templateButton to 8</font></p><p><font face="Lucida Grande" size="11" color="#000000">lock messages</font></p><p><font face="Lucida Grande" size="11" color="#000000">repeat for 5 times</font></p><p><font face="Lucida Grande" size="11" color="#000000">create button</font></p><p><font face="Lucida Grande" size="11" color="#000000">end repeat</font></p><p><font face="Lucida Grande" size="11" color="#000000">unlock messages</font></p><p></p><p><font face="Lucida Grande" size="11" color="#000000">LiveCode resets the template only when in the development environment, not in standalone applications.</font></p><p></p><p><tip> To create a control in a specific stack, first set the defaultStack to the stack where you want to create the new control:</p><p></tip><p><font face="Lucida Grande" size="11" color="#000000">set the defaultStack to "My Stack"</font></p><p><font face="Lucida Grande" size="11" color="#000000">create button "My Button"</font></p></comments>
	</description>
</doc>