<doc>
  <legacy_id>2451</legacy_id>
  <name>editBackground</name>
  <type>property</type>
  <syntax>
    <example>set the editBackground of <i>stack</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
  </objects>
  <synonyms>
    <synonym>editBkgnd</synonym>
    <synonym>editBg</synonym>
  </synonyms>
  <classification>
    <category>Objects &amp; Messages</category>
  </classification>
  <references>
    <command tag="start editing">start editing Command</command>
    <property tag="groupIDs">groupIDs Property</property>
    <property tag="relayerGroupedControls">relayerGroupedControls Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies that any <glossary tag="object">objects</glossary> created should be added to the <object tag="group">background</object>.</summary>
  <examples>
    <example>set the editBackground of this stack to true</example>
  </examples>
  <description>
    <p>Use the <b>editBackground</b> <glossary tag="property">property</glossary> to edit the first <command tag="group">group</command> on the <glossary tag="current card">current card</glossary>, or to find out whether the <object tag="stack">stack</object> is in <href tag="../glossary/groupdashediting_mode.xml">group-editing mode</href>.</p><p/><p><b>Value:</b></p><p>The <b>editBackground</b> of a <object tag="stack">stack</object> is true or false.</p><p/><p>By default, the <b>editBackground</b> <glossary tag="property">property</glossary> of newly created <function tag="stacks">stacks</function> is set to false.</p><p/><p><b>Comments:</b></p><p>If the <b>editBackground</b> <glossary tag="property">property</glossary> is set to true, any newly created <glossary tag="object">objects</glossary> become part of the <command tag="group">group</command> being edited. If the <b>editBackground</b> is false, newly created <glossary tag="control">controls</glossary> are created as <glossary tag="card control">card controls</glossary> and only appear on the <glossary tag="current card">current card</glossary>.</p><p/><p>If the current card has more than one group, the group whose <b>number</b> is lowest is edited when you set the <b>editBackground</b> of the <object tag="stack">stack</object> to true.</p><p/><p>You can use the <b>start editing</b> <glossary tag="command">command</glossary> to edit a specific <command tag="group">group</command>. Setting the <b>editBackground</b> <glossary tag="property">property</glossary> to false is equivalent to the <command tag="stop editing">stop editing</command> <glossary tag="command">command</glossary>.</p><p/><p>By default, the <b>editBackground</b> is set to false.  This property is not preserved when the stack is saved, the property will always be false upon opening a stack.</p>
  </description>
</doc>