<doc>
	<legacy_id>1050</legacy_id>
	<name>start editing</name>
	<type>command</type>

	<syntax>
		<example>start editing <i>group</i> [of <i>stack</i>]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Puts a <object tag="stack">stack</object> into group-editing mode.</summary>

	<examples>
<example>start editing group "container"</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>Developing with LiveCode</category>
	</classification>

	<references>
		<command tag="group">group Command</command>
		<command tag="place">place Command</command>
		<command tag="remove">remove Command</command>
		<command tag="stop editing">stop editing Command</command>
		<command tag="ungroup">ungroup Command</command>
		<property tag="editBackground">editBackground Property</property>
		<property tag="relayerGroupedControls">relayerGroupedControls Property</property>
	</references>

	<description>Use the <b>start editing</b> <glossary tag="command">command</glossary> to add <glossary tag="object">objects</glossary> to a <command tag="group">group</command> or change the <glossary tag="object">objects</glossary> in a <command tag="group">group</command>.<p></p><p><b>Parameters:</b></p><p>The <i>group</i> is a reference to a <command tag="group">group</command> you want to edit.</p><p></p><p>The <i>stack</i> is a reference to the <object tag="stack">stack</object> that contains the <command tag="group">group</command> you want to edit.</p><p></p><p><b>Comments:</b></p><p>If you don't specify a <i>stack</i>, the specified <command tag="group">group</command> in the <glossary tag="current stack">current stack</glossary> is put into group-editing mode.</p><p></p><p>Any objects created while in group-editing mode are added to that group.</p><p></p><p>When a group is in group-editing mode, font and color properties for the group (though not for objects in the group) are disregarded. This means that if properties such as <b>textFont</b>, <property tag="foregroundColor">foregroundColor</property>, and so on are set for the <command tag="group">group</command>, it displays differently when in group-editing mode, using the fonts and colors of the <object tag="stack">stack</object> the <command tag="group">group</command> is in. As soon as you exit group-editing mode with the <command tag="stop editing">stop editing</command> <glossary tag="command">command</glossary>, the <glossary tag="group">group's</glossary> correct appearance is restored.</p><p></p><p></p><note>The <command tag="start editing">start editing</command> <glossary tag="command">command</glossary> temporarily modifies the <glossary tag="object hierarchy">object hierarchy</glossary>, displaying only the <glossary tag="object">objects</glossary> that belong to the <command tag="group">group</command> being edited. <glossary tag="inheritance">Inherited</glossary> font and color <property tag="properties">properties</property> may not appear correctly while the <command tag="group">group</command> is being edited, but will be restored whhen you exit group-editing mode. Also, if the <command tag="start editing">start editing</command> <glossary tag="command">command</glossary> is included in a <glossary tag="handler">handler</glossary>, using the <glossary tag="debugger">debugger</glossary> to step through that <glossary tag="handler">handler</glossary> may cause unexpected results because of the change in object context.</note></description>
</doc>