<doc>
  <legacy_id>1519</legacy_id>
  <name>dragStart</name>
  <type>message</type>
  <syntax>
    <example>dragStart</example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
    <card/>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>User Interaction</category>
  </classification>
  <references>
    <message tag="dragEnter">dragEnter Message</message>
    <command tag="click">click Command</command>
    <property tag="dragData">dragData Property</property>
    <property tag="dragAction">dragAction Property</property>
    <property tag="dragImageOffset">dragImageOffset Property</property>
  </references>
  <history>
    <introduced version="2.0">Added.</introduced>
    <changed version="2.9"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
  </classes>
  <security>
  </security>
  <summary>Sent to a control when the user clicked on it and then started to drag the mouse pointer.</summary>
  <examples>
    <example>on dragStart <i>-- in a field script</i></p><p><i>  -- color the text that's being dragged:</i></p><p>  set the textColor of the selectedChunk to "#333399"</p><p>  pass dragStart</p><p>end dragStart</example>
  </examples>
  <description>
    <p>The <b>dragStart</b> <keyword tag="message box">message</keyword> is sent to a control when the user clicks on it and then drags the mouse pointer at least <property tag="dragDelta">dragDelta</property> pixels from its original position.  </p><p/><p>Use this handler to initiate a drag-drop operation if required.  An operation can be initiated by setting a data-type of the <property tag="dragData">dragData property</property>.</p><p/><p><b>Comments:</b></p><p>LiveCode automatically handles the mechanics of dragging and dropping text between and within unlocked fields. To support this type of drag and drop operation, you don't need to do any scripting: the drag begins automatically when LiveCode receives the <b>dragStart</b> <keyword tag="message box">message</keyword>.</p><p/><p>If you don't want to allow dragging text from a particular field, you should place a <b>dragStart</b> <glossary tag="handler">handler</glossary> in the field that does not contain a <control_st tag="pass">pass</control_st> <glossary tag="control structure">control structure</glossary>:</p><p/><p>  on dragStart <i>-- in script of field or one of its owners</i></p><p><i>    -- do nothing, but trap the message</i></p><p>  end dragStart</p>
  </description>
</doc>