<doc>
  <legacy_id>1193</legacy_id>
  <name>selection</name>
  <type>keyword</type>
  <syntax>
    <example>the selection</example>
    <example>selection()</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <function tag="selectedLoc">selectedLoc Function</function>
    <function tag="mouseColor">mouseColor Function</function>
    <keyword tag="intersect">intersect Keyword</keyword>
    <message tag="selectionChanged">selectionChanged Message</message>
    <message tag="openField">openField Message</message>
    <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>The <b>selection</b> is a reference to the currently <property tag="selected">selected</property> text.</summary>
  <examples>
    <example>put empty into the selection <code><i>-- deletes the selection</i></code></example>
  </examples>
  <description>
    <p>Use the <b>selection</b> <glossary tag="keyword">keyword</glossary> to get the currently <property tag="selected">selected</property> text or to replace the <keyword tag="selection">selection</keyword>.</p><p/><p><b>Comments:</b></p><p>Certain commands--in particular, the <b>cut</b> and <command tag="copy">copy</command> <glossary tag="command">commands</glossary>--operate on the <property tag="selected">selected</property> text.</p><p/><p><code/><b>Note:</b><code/> The <b>selection</b> <glossary tag="keyword">keyword</glossary> is implemented internally as a <control_st tag="function">function</control_st> and appears in the <function tag="functionNames">functionNames</function>. However, unlike most <glossary tag="function">functions</glossary>, the <b>selection</b> lets you put things into it, and behaves like a <glossary tag="container">container</glossary> rather than a <control_st tag="function">function</control_st>.</p>
  </description>
</doc>