<doc>
  <legacy_id>1079</legacy_id>
  <name>selectionMode</name>
  <type>property</type>
  <syntax>
    <example>set the selectionMode to {intersect | surround}</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <keyword tag="intersect">intersect Keyword</keyword>
    <property tag="selectGroupedControls">selectGroupedControls 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>Determines which <glossary tag="object">objects</glossary> are <property tag="selected">selected</property> when you drag a rectangle with the Pointer <function tag="tool">tool</function>.</summary>
  <examples>
    <example>set the selectionMode to intersect</example>
  </examples>
  <description>
    <p>Use the <b>selectionMode</b> <glossary tag="property">property</glossary> to change the behavior of drag selections.</p><p/><p><b>Value:</b></p><p>The <b>selectionMode</b> is either <code>intersect </code>or<code> surround</code>.</p><p/><p><b>Comments:</b></p><p>When you choose the Pointer tool, click in the window, and drag diagonally to select a rectangle, objects within the rectangle are selected. The <b>selectionMode</b> <glossary tag="property">property</glossary> determines which <glossary tag="object">objects</glossary> are included inside the dragged rectangle.</p><p/><p>If the <b>selectionMode</b> is set to "intersect", all <glossary tag="object">objects</glossary> that are partially or completely inside the rectangle are <property tag="selected">selected</property>. If the <b>selectionMode</b> is set to "surround", only <glossary tag="object">objects</glossary> that are completely inside the rectangle are <property tag="selected">selected</property>.</p><p/><p><code/><img src="202651"/> <b>Tip:</b><code/> You can also set the <b>selectionMode</b> by choosing <a/><b/>Edit menu<img src="202656"/>Intersected Selections<important/>.</p>
  </description>
</doc>