Home Explore Help
Register Sign In
Apq
/
winscp
mirror of https://github.com/winscp/winscp.git
1
0
Fork 0
Files Issues 0 Wiki
Branch: dev
Branches Tags
winscp
/
source
/
packages
/
dragndrop
/
TDragDrop.htm

TDragDrop.htm 91 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052 
  1. <html>
    2. 

  2. 

  3. <head>
    4. 

  4. <meta http-equiv="Content-Type"
    5. 

  5. content="text/html; charset=iso-8859-1">
    6. 

  6. <meta name="AUTHOR" content="Dieter Steinwedel">
    7. 

  7. <meta name="DESCRIPTION"
    8. 

  8. content="Drag&amp;Drop component for Delphi; description for TDragDrop">
    9. 

  9. <meta name="KEYWORDS"
    10. 

  10. content="delphi, drag, drop, component, ole, com, freeware, windows">
    11. 

  11. <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
    12. 

  12. <title>Details about TDragDrop</title>
    13. 

  13. </head>
    14. 

  14. 

  15. <body bgcolor="#FFFFEF">
    16. 

  16. 

  17. <table border="0" cellspacing="0" width="600" bgcolor="#008080">
    18. 

  18.     <tr>
    19. 

  19.         <td width="10">&nbsp;</td>
    20. 

  20.         <td width="580">&nbsp; </td>
    21. 

  21.         <td width="10" bgcolor="#FFFFEF">&nbsp;</td>
    22. 

  22.     </tr>
    23. 

  23.     <tr>
    24. 

  24.         <td>&nbsp;</td>
    25. 

  25.         <td><p align="center"><font color="#FFFFFF" size="7"
    26. 

  26.         face="Arial">TDragDrop</font></p>
    27. 

  27.         </td>
    28. 

  28.         <td>&nbsp;</td>
    29. 

  29.     </tr>
    30. 

  30.     <tr>
    31. 

  31.         <td bgcolor="#FFFFEF">&nbsp;</td>
    32. 

  32.         <td>&nbsp;</td>
    33. 

  33.         <td>&nbsp;</td>
    34. 

  34.     </tr>
    35. 

  35. </table>
    36. 

  36. 

  37. <p align="left">&nbsp;</p>
    38. 

  38. 

  39. <p align="left">&nbsp;</p>
    40. 

  40. 

  41. <table border="0" width="600">
    42. 

  42.     <tr>
    43. 

  43.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    44. 

  44.         <td rowspan="2" width="590"><font size="5" face="Arial">Description</font></td>
    45. 

  45.     </tr>
    46. 

  46.     <tr>
    47. 

  47.         <td>&nbsp;</td>
    48. 

  48.     </tr>
    49. 

  49.     <tr>
    50. 

  50.         <td>&nbsp;</td>
    51. 

  51.         <td><font face="Arial"><b><i>TDragDrop</i></b> is a
    52. 

  52.         component for COM/OLE based drag&amp;drop operations. The
    53. 

  53.         component is able to make child-classes of TWinControl
    54. 

  54.         (e.g. TEdit, TMemo, TListView, etc.) to be the source AND
    55. 

  55.         target of drag&amp;drop operations.</font><p><font
    56. 

  56.         face="Arial">Normally, you only use this component
    57. 

  57.         directly (for testing), if you develop an own
    58. 

  58.         drag&amp;drop component based on this class.</font></p>
    59. 

  59.         </td>
    60. 

  60.     </tr>
    61. 

  61.     <tr>
    62. 

  62.         <td height="50">&nbsp;</td>
    63. 

  63.         <td>&nbsp;</td>
    64. 

  64.     </tr>
    65. 

  65. </table>
    66. 

  66. 

  67. <table border="0" width="600">
    68. 

  68.     <tr>
    69. 

  69.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    70. 

  70.         <td rowspan="2" width="590"><font size="5" face="Arial">Important
    71. 

  71.         for Use</font></td>
    72. 

  72.     </tr>
    73. 

  73.     <tr>
    74. 

  74.         <td>&nbsp;</td>
    75. 

  75.     </tr>
    76. 

  76.     <tr>
    77. 

  77.         <td>&nbsp;</td>
    78. 

  78.         <td><font face="Arial">This </font><a href="Index.htm"><font
    79. 

  79.         face="Arial">file</font></a><font face="Arial">
    80. 

  80.         (index.htm) contains more information about restrictions,
    81. 

  81.         the disclaimer, remarks etc.</font></td>
    82. 

  82.     </tr>
    83. 

  83.     <tr>
    84. 

  84.         <td height="50">&nbsp;</td>
    85. 

  85.         <td>&nbsp;</td>
    86. 

  86.     </tr>
    87. 

  87. </table>
    88. 

  88. 

  89. <table border="0" width="600">
    90. 

  90.     <tr>
    91. 

  91.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    92. 

  92.         <td rowspan="2" width="590"><font size="5" face="Arial">History</font></td>
    93. 

  93.     </tr>
    94. 

  94.     <tr>
    95. 

  95.         <td>&nbsp;</td>
    96. 

  96.     </tr>
    97. 

  97.     <tr>
    98. 

  98.         <td>&nbsp;</td>
    99. 

  99.         <td><font face="Arial"><b>Version 4.30</b> </font><font
    100. 

  100.         color="#808080" face="Arial">published on 17-Dec-1999</font></td>
    101. 

  101.     </tr>
    102. 

  102.     <tr>
    103. 

  103.         <td>&nbsp;</td>
    104. 

  104.         <td><ul>
    105. 

  105.             <li><font face="Arial">The method <strong>DropHandler</strong>
    106. 

  106.                 was added</font></li>
    107. 

  107.             <li><font face="Arial">The implementation of the
    108. 

  108.                 context-menu has changed; now you can insert
    109. 

  109.                 custom menuitems</font></li>
    110. 

  110.         </ul>
    111. 

  111.         </td>
    112. 

  112.     </tr>
    113. 

  113.     <tr>
    114. 

  114.         <td>&nbsp;</td>
    115. 

  115.         <td><font face="Arial"><b>Version 4.20</b> </font><font
    116. 

  116.         color="#808080" face="Arial">published on 13-Nov-1999</font></td>
    117. 

  117.     </tr>
    118. 

  118.     <tr>
    119. 

  119.         <td>&nbsp;</td>
    120. 

  120.         <td><ul>
    121. 

  121.             <li><font color="#FF0000" face="Arial"><strong>IMPORTANT:</strong></font><font
    122. 

  122.                 face="Arial"><strong> </strong>The mouse
    123. 

  123.                 coordinates <em><strong>pt </strong></em>in <em><strong>OnDragEnter,
    124. 

  124.                 OnDragOver, OnDrop, OnDragDetect,
    125. 

  125.                 OnprocessDropped</strong></em> and <em><strong>OnBeforeScrolling</strong></em>
    126. 

  126.                 are not a longer absolute to the screen but
    127. 

  127.                 relative to the <em><strong>DragDropControl</strong></em>;
    128. 

  128.                 maybe, that you must adjust your code</font></li>
    129. 

  129.         </ul>
    130. 

  130.         </td>
    131. 

  131.     </tr>
    132. 

  132.     <tr>
    133. 

  133.         <td>&nbsp;</td>
    134. 

  134.         <td><font face="Arial"><b>Version 4.10</b> </font><font
    135. 

  135.         color="#808080" face="Arial">published on 06-Jul-1999</font></td>
    136. 

  136.     </tr>
    137. 

  137.     <tr>
    138. 

  138.         <td>&nbsp;</td>
    139. 

  139.         <td><ul>
    140. 

  140.             <li><font face="Arial">Bug with <b><i>AcceptOwnDnD</i></b>
    141. 

  141.                 fixed </font></li>
    142. 

  142.             <li><font face="Arial">The handling of the clipboard
    143. 

  143.                 has totally changed. As result of it, the
    144. 

  144.                 implemention of the method <b><i>Execute</i></b>
    145. 

  145.                 has changed, but not the using. You won't notice
    146. 

  146.                 the modification (and haven't to change code),
    147. 

  147.                 unless you haven't created your own classes based
    148. 

  148.                 on <b><i>TDragDrop</i></b>. </font><p><font
    149. 

  149.                 face="Arial"><i>Following is only important, if
    150. 

  150.                 you've build your own class based on </i><b><i>TDragDrop</i></b>:</font></p>
    151. 

  151.                 <p><font face="Arial">Normally you create a data
    152. 

  152.                 object in the method <b><i>Execute</i></b> before
    153. 

  153.                 data is dragged. Simply move this code to the new
    154. 

  154.                 method <b><i>CreateDataObject</i></b>, inherited
    155. 

  155.                 from <b><i>TDragDrop</i></b> and your class are
    156. 

  156.                 compatible with this version. As a result of
    157. 

  157.                 this, the your child-class has automaticly the
    158. 

  158.                 capability for clipboard operations without any
    159. 

  159.                 additonal code for this in contrast to earlier
    160. 

  160.                 times. So, the expenditure for child-class
    161. 

  161.                 development has shrinked. Fine, or? </font></p>
    162. 

  162.             </li>
    163. 

  163.         </ul>
    164. 

  164.         </td>
    165. 

  165.     </tr>
    166. 

  166.     <tr>
    167. 

  167.         <td>&nbsp;</td>
    168. 

  168.         <td><font face="Arial"><b>Version 4.00</b> </font><font
    169. 

  169.         color="#808080" face="Arial">published on 30-May-1999</font></td>
    170. 

  170.     </tr>
    171. 

  171.     <tr>
    172. 

  172.         <td>&nbsp;</td>
    173. 

  173.         <td><ul>
    174. 

  174.             <li><font face="Arial"><b><i>OnDragDetect</i></b> was
    175. 

  175.                 changed in the declaration; now it isn't so long
    176. 

  176.                 any more </font></li>
    177. 

  177.             <li><font face="Arial">The available drag effects in <b><i>SourceEffects</i></b>
    178. 

  178.                 and <b><i>TargetEffects</i></b> were corrected </font></li>
    179. 

  179.             <li><font face="Arial">The scroll cursors during
    180. 

  180.                 d&amp;d are now displayed </font></li>
    181. 

  181.             <li><font face="Arial">New great properties added: <b><i>ScrollDetectOptions</i></b>
    182. 

  182.                 and <b><i>SourceCompatibility</i></b> </font></li>
    183. 

  183.             <li><font face="Arial">New design for the
    184. 

  184.                 auto-detection for drag&amp;drop</font></li>
    185. 

  185.         </ul>
    186. 

  186.         </td>
    187. 

  187.     </tr>
    188. 

  188.     <tr>
    189. 

  189.         <td>&nbsp;</td>
    190. 

  190.         <td><font face="Arial"><b>Version 3.20</b> </font><font
    191. 

  191.         color="#808080" face="Arial">published on 3-May-1999</font></td>
    192. 

  192.     </tr>
    193. 

  193.     <tr>
    194. 

  194.         <td>&nbsp;</td>
    195. 

  195.         <td><ul>
    196. 

  196.             <li><font face="Arial">Property <b><i>RenderOn</i></b>
    197. 

  197.                 extended with a new value </font></li>
    198. 

  198.             <li><font face="Arial">The bug with source &amp;
    199. 

  199.                 target effects in version 3.11 wasn't fixed in
    200. 

  200.                 the Delphi4 component; this is now made up </font></li>
    201. 

  201.             <li><font face="Arial">The documentation is completed
    202. 

  202.                 (for a longer time, there are the properties <b><i>CHCopy</i></b>,
    203. 

  203.                 <b><i>CHMove</i></b>, <b><i>CHLink</i></b> etc.
    204. 

  204.                 available) </font></li>
    205. 

  205.             <li><font face="Arial">Bug was fixed with <b><i>DragOver</i></b>
    206. 

  206.                 (modifications of the <b><i>dwEffect</i></b> has
    207. 

  207.                 no effect, if the target doesn't accept the data)
    208. 

  208.                 </font></li>
    209. 

  209.             <li><font face="Arial">Some bugs with the
    210. 

  210.                 auto-detection for drag&amp;drop fixed (the
    211. 

  211.                 component sends now always a
    212. 

  212.                 &quot;mousebutton-up&quot; message, after a
    213. 

  213.                 dectection has started; the detection had not
    214. 

  214.                 worked, if the start position was near to the
    215. 

  215.                 border of the visual control)</font> </li>
    216. 

  216.         </ul>
    217. 

  217.         </td>
    218. 

  218.     </tr>
    219. 

  219.     <tr>
    220. 

  220.         <td>&nbsp;</td>
    221. 

  221.         <td><font face="Arial"><b>Version 3.11</b> </font><font
    222. 

  222.         color="#808080" face="Arial">published on 27-Feb-1999</font></td>
    223. 

  223.     </tr>
    224. 

  224.     <tr>
    225. 

  225.         <td>&nbsp;</td>
    226. 

  226.         <td><ul>
    227. 

  227.             <li><font face="Arial">Property <b><i>RenderOn</i></b>
    228. 

  228.                 extended with new values </font></li>
    229. 

  229.             <li><font face="Arial">New property: <b><i>AvailableDropEffects</i></b>
    230. 

  230.                 </font></li>
    231. 

  231.             <li><font face="Arial">Bug fixed with source &amp;
    232. 

  232.                 target effects (mostly invisible) </font></li>
    233. 

  233.             <li><font face="Arial">In the Delphi2 version: unused
    234. 

  234.                 method (<b><i>SetTargetWindowControl</i></b>)
    235. 

  235.                 deleted (relict from an earlier time) </font></li>
    236. 

  236.             <li><font face="Arial"><b><i>SetDragDropControl</i></b>
    237. 

  237.                 corrected (you can change now the DragDropControl
    238. 

  238.                 at run-time, if you need)</font> </li>
    239. 

  239.         </ul>
    240. 

  240.         </td>
    241. 

  241.     </tr>
    242. 

  242.     <tr>
    243. 

  243.         <td>&nbsp;</td>
    244. 

  244.         <td><font face="Arial"><b>Version 3.10</b> </font><font
    245. 

  245.         color="#808080" face="Arial">published on 19-Jan-1999</font></td>
    246. 

  246.     </tr>
    247. 

  247.     <tr>
    248. 

  248.         <td>&nbsp;</td>
    249. 

  249.         <td><ul>
    250. 

  250.             <li><font face="Arial">Range-Check Error fixed in <b><i>Execute</i></b>
    251. 

  251.                 </font></li>
    252. 

  252.             <li><a href="#WinNTBug1"><font face="Arial">Bug</font></a><font
    253. 

  253.                 face="Arial"> in WinNT4 detected </font></li>
    254. 

  254.             <li><font face="Arial">Bug in detecting the language
    255. 

  255.                 fixed </font></li>
    256. 

  256.             <li><font face="Arial">The property <b><i>RenderAsync</i></b>
    257. 

  257.                 was replaced by the new property <b><i>RenderOn</i></b>
    258. 

  258.                 </font></li>
    259. 

  259.             <li><font face="Arial">Bug fixed: You don't need any
    260. 

  260.                 longer enable even the target effects to make
    261. 

  261.                 your <b><i>DragDropControl</i></b> able to be the
    262. 

  262.                 source of d&amp;d operations </font></li>
    263. 

  263.             <li><font face="Arial">Bug fixed: Modifications of
    264. 

  264.                 the drop effect <b><i>dwEffect</i></b> in the
    265. 

  265.                 event-handlers <b><i>OnXXXXX</i></b> effects even
    266. 

  266.                 to the drop</font> </li>
    267. 

  267.         </ul>
    268. 

  268.         </td>
    269. 

  269.     </tr>
    270. 

  270.     <tr>
    271. 

  271.         <td>&nbsp;</td>
    272. 

  272.         <td><font face="Arial"><b>Version 3.00</b> </font><font
    273. 

  273.         color="#808080" face="Arial">updated on 31-Nov-1998</font></td>
    274. 

  274.     </tr>
    275. 

  275.     <tr>
    276. 

  276.         <td>&nbsp;</td>
    277. 

  277.         <td><ul>
    278. 

  278.             <li><font face="Arial">Native version for Delphi4
    279. 

  279.                 available </font></li>
    280. 

  280.             <li><font face="Arial">Some bugs fixed </font></li>
    281. 

  281.             <li><font face="Arial">Polish version available </font></li>
    282. 

  282.             <li><font face="Arial">Paramters to the event <b><i>OnProcessDropped</i></b>
    283. 

  283.                 and <b><i>OnDragDetect</i></b> added </font></li>
    284. 

  284.             <li><font face="Arial"><b><i>ExecuteDragDrop</i></b>
    285. 

  285.                 renamed to <b><i>Execute</i></b> </font></li>
    286. 

  286.             <li><font face="Arial"><b><i>Execute</i></b> has new
    287. 

  287.                 result values </font></li>
    288. 

  288.             <li><font face="Arial">The drop effects were renamed </font></li>
    289. 

  289.             <li><font face="Arial">Sorry for so heavy code
    290. 

  290.                 breaking, but in my opinion, there was the
    291. 

  291.                 necessity to change these things</font> </li>
    292. 

  292.         </ul>
    293. 

  293.         </td>
    294. 

  294.     </tr>
    295. 

  295.     <tr>
    296. 

  296.         <td>&nbsp;</td>
    297. 

  297.         <td><font face="Arial"><b>Version 2.01</b> </font><font
    298. 

  298.         color="#808080" face="Arial">published on 03-Oct-1998</font></td>
    299. 

  299.     </tr>
    300. 

  300.     <tr>
    301. 

  301.         <td>&nbsp;</td>
    302. 

  302.         <td><ul>
    303. 

  303.             <li><font face="Arial">Language auto-detect feature
    304. 

  304.                 added </font></li>
    305. 

  305.             <li><font face="Arial">Some bugs fixed</font> </li>
    306. 

  306.         </ul>
    307. 

  307.         </td>
    308. 

  308.     </tr>
    309. 

  309.     <tr>
    310. 

  310.         <td>&nbsp;</td>
    311. 

  311.         <td><font face="Arial"><b>Version 2.00</b></font><font
    312. 

  312.         color="#808080" face="Arial"> updated on 03-Oct-1998</font></td>
    313. 

  313.     </tr>
    314. 

  314.     <tr>
    315. 

  315.         <td>&nbsp;</td>
    316. 

  316.         <td><ul>
    317. 

  317.             <li><font face="Arial">New methods &amp; properties
    318. 

  318.                 (clipboard actions, drag detect, etc.) </font></li>
    319. 

  319.             <li><font face="Arial">The use of the COM was
    320. 

  320.                 corrected (ref-counter, etc.)</font> </li>
    321. 

  321.         </ul>
    322. 

  322.         </td>
    323. 

  323.     </tr>
    324. 

  324.     <tr>
    325. 

  325.         <td>&nbsp;</td>
    326. 

  326.         <td><font face="Arial"><b>Version 1.01</b></font><font
    327. 

  327.         color="#808080" face="Arial"> published on 12-Aug-1998</font></td>
    328. 

  328.     </tr>
    329. 

  329.     <tr>
    330. 

  330.         <td>&nbsp;</td>
    331. 

  331.         <td><ul>
    332. 

  332.             <li><font face="Arial">Some small updates</font></li>
    333. 

  333.         </ul>
    334. 

  334.         </td>
    335. 

  335.     </tr>
    336. 

  336.     <tr>
    337. 

  337.         <td>&nbsp;</td>
    338. 

  338.         <td><font face="Arial"><b>Version 1.00</b> </font><font
    339. 

  339.         color="#808080" face="Arial">published on 06-Aug-1998</font><font
    340. 

  340.         face="Arial"> </font></td>
    341. 

  341.     </tr>
    342. 

  342.     <tr>
    343. 

  343.         <td>&nbsp;</td>
    344. 

  344.         <td><ul>
    345. 

  345.             <li><font face="Arial">First official release</font></li>
    346. 

  346.         </ul>
    347. 

  347.         </td>
    348. 

  348.     </tr>
    349. 

  349.     <tr>
    350. 

  350.         <td height="50">&nbsp;</td>
    351. 

  351.         <td colspan="2">&nbsp;</td>
    352. 

  352.     </tr>
    353. 

  353. </table>
    354. 

  354. 

  355. <table border="0" width="600">
    356. 

  356.     <tr>
    357. 

  357.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    358. 

  358.         <td rowspan="2" width="590"><font size="5" face="Arial">Properties</font></td>
    359. 

  359.     </tr>
    360. 

  360.     <tr>
    361. 

  361.         <td>&nbsp;</td>
    362. 

  362.     </tr>
    363. 

  363. </table>
    364. 

  364. 

  365. <table border="0" cellpadding="3" cellspacing="0" width="600">
    366. 

  366.     <tr>
    367. 

  367.         <td width="10">&nbsp;</td>
    368. 

  368.         <td bgcolor="#008080"><a name="AcceptOwnDnD"><font
    369. 

  369.         color="#FFFFFF" size="5" face="Arial"><b>AcceptOwnDnD</b></font></a><font
    370. 

  370.         color="#FFFFFF" size="4" face="Arial"><b><i> </i></b></font><font
    371. 

  371.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    372. 

  372.     </tr>
    373. 

  373.     <tr>
    374. 

  374.         <td rowspan="2">&nbsp;</td>
    375. 

  375.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">If<b> </b>your<b>
    376. 

  376.         </b></font><a href="#DragDropControl"><font size="3"
    377. 

  377.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    378. 

  378.         size="3" face="Arial"> is configured to be source AND
    379. 

  379.         target of drag&amp;drop operations you can determine
    380. 

  380.         here, if your </font><a href="#DragDropControl"><font
    381. 

  381.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    382. 

  382.         size="3" face="Arial"> should accept its own
    383. 

  383.         drag&amp;drop operation. This is important in example, if
    384. 

  384.         you want to change the order of Listbox items using this
    385. 

  385.         component and not the internal drag&amp;drop operations. </font></td>
    386. 

  386.     </tr>
    387. 

  387.     <tr>
    388. 

  388.         <td bgcolor="#FFFFEF">&nbsp;</td>
    389. 

  389.     </tr>
    390. 

  390.     <tr>
    391. 

  391.         <td>&nbsp;</td>
    392. 

  392.         <td bgcolor="#008080"><a name="AutoDetectDnD"><font
    393. 

  393.         color="#FFFFFF" size="5" face="Arial"><b>AutoDetectDnD</b></font><font
    394. 

  394.         size="3" face="Arial"><b> </b></font><font
    395. 

  395.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></a></td>
    396. 

  396.     </tr>
    397. 

  397.     <tr>
    398. 

  398.         <td rowspan="2">&nbsp;</td>
    399. 

  399.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">If<b> </b>your<b>
    400. 

  400.         </b></font><a href="#DragDropControl"><font size="3"
    401. 

  401.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    402. 

  402.         size="3" face="Arial"> is configured to be source of
    403. 

  403.         drag&amp;drop operations you can define here, if this
    404. 

  404.         component should detect drag operations or not. The
    405. 

  405.         property </font><a href="#DragDetectDelta"><font size="3"
    406. 

  406.         face="Arial"><b><i>DragDetectDelta</i></b></font></a><font
    407. 

  407.         size="3" face="Arial"> is involved in the detection.</font>
    408. 

  408.         <p><font color="#FF0000" size="3" face="Arial"><strong>IMPORTANT:</strong></font><font
    409. 

  409.         size="3" face="Arial"> If you use the drag-detection,
    410. 

  410.         it's high recommended to check the section &quot;</font><a
    411. 

  411.         href="#DragDetectionProblem"><font size="3" face="Arial">Problems
    412. 

  412.         With The Drag-Detection</font></a><font size="3"
    413. 

  413.         face="Arial">&quot;.</font></p>
    414. 

  414.         </td>
    415. 

  415.     </tr>
    416. 

  416.     <tr>
    417. 

  417.         <td bgcolor="#FFFFEF">&nbsp;</td>
    418. 

  418.     </tr>
    419. 

  419.     <tr>
    420. 

  420.         <td>&nbsp;</td>
    421. 

  421.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    422. 

  422.         face="Arial"><b>BringToFront</b></font><font size="3"
    423. 

  423.         face="Arial"><b> </b></font><font color="#FFFF80"
    424. 

  424.         size="3" face="Arial"><b><i>published</i></b></font></td>
    425. 

  425.     </tr>
    426. 

  426.     <tr>
    427. 

  427.         <td rowspan="2">&nbsp;</td>
    428. 

  428.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">If the
    429. 

  429.         user has dropped data on the target control, you can
    430. 

  430.         determine here if the form should come to front after the
    431. 

  431.         drag&amp;drop operation or not. </font></td>
    432. 

  432.     </tr>
    433. 

  433.     <tr>
    434. 

  434.         <td bgcolor="#FFFFEF">&nbsp;</td>
    435. 

  435.     </tr>
    436. 

  436.     <tr>
    437. 

  437.         <td>&nbsp;</td>
    438. 

  438.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    439. 

  439.         face="Arial"><b>CHCopy</b></font><font size="3"
    440. 

  440.         face="Arial"><b> </b></font><font color="#FFFF80"
    441. 

  441.         size="3" face="Arial"><b><i>public</i></b></font></td>
    442. 

  442.     </tr>
    443. 

  443.     <tr>
    444. 

  444.         <td rowspan="2">&nbsp;</td>
    445. 

  445.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    446. 

  446.         this property to set a custom cursor for the copy-effect
    447. 

  447.         during drag&amp;drop. </font></td>
    448. 

  448.     </tr>
    449. 

  449.     <tr>
    450. 

  450.         <td bgcolor="#FFFFEF">&nbsp;</td>
    451. 

  451.     </tr>
    452. 

  452.     <tr>
    453. 

  453.         <td>&nbsp;</td>
    454. 

  454.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    455. 

  455.         face="Arial"><b>CHLink</b></font><font size="3"
    456. 

  456.         face="Arial"><b> </b></font><font color="#FFFF80"
    457. 

  457.         size="3" face="Arial"><b><i>public</i></b></font></td>
    458. 

  458.     </tr>
    459. 

  459.     <tr>
    460. 

  460.         <td rowspan="2">&nbsp;</td>
    461. 

  461.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    462. 

  462.         this property to set a custom cursor for the link-effect
    463. 

  463.         during drag&amp;drop. </font></td>
    464. 

  464.     </tr>
    465. 

  465.     <tr>
    466. 

  466.         <td bgcolor="#FFFFEF">&nbsp;</td>
    467. 

  467.     </tr>
    468. 

  468.     <tr>
    469. 

  469.         <td>&nbsp;</td>
    470. 

  470.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    471. 

  471.         face="Arial"><b>CHMove</b></font><font size="3"
    472. 

  472.         face="Arial"><b> </b></font><font color="#FFFF80"
    473. 

  473.         size="3" face="Arial"><b><i>public</i></b></font></td>
    474. 

  474.     </tr>
    475. 

  475.     <tr>
    476. 

  476.         <td rowspan="2">&nbsp;</td>
    477. 

  477.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    478. 

  478.         this property to set a custom cursor for the move-effect
    479. 

  479.         during drag&amp;drop. </font></td>
    480. 

  480.     </tr>
    481. 

  481.     <tr>
    482. 

  482.         <td bgcolor="#FFFFEF">&nbsp;</td>
    483. 

  483.     </tr>
    484. 

  484.     <tr>
    485. 

  485.         <td>&nbsp;</td>
    486. 

  486.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    487. 

  487.         face="Arial"><b>CHScrollCopy</b></font><font size="3"
    488. 

  488.         face="Arial"><b> </b></font><font color="#FFFF80"
    489. 

  489.         size="3" face="Arial"><b><i>public</i></b></font></td>
    490. 

  490.     </tr>
    491. 

  491.     <tr>
    492. 

  492.         <td rowspan="2">&nbsp;</td>
    493. 

  493.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    494. 

  494.         this property to set a custom cursor for the copy-effect
    495. 

  495.         during drag&amp;drop </font><font face="Arial">and
    496. 

  496.         scrolling in the target window. </font></td>
    497. 

  497.     </tr>
    498. 

  498.     <tr>
    499. 

  499.         <td bgcolor="#FFFFEF">&nbsp;</td>
    500. 

  500.     </tr>
    501. 

  501.     <tr>
    502. 

  502.         <td>&nbsp;</td>
    503. 

  503.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    504. 

  504.         face="Arial"><b>CHScrollLink</b></font><font size="3"
    505. 

  505.         face="Arial"><b> </b></font><font color="#FFFF80"
    506. 

  506.         size="3" face="Arial"><b><i>public</i></b></font></td>
    507. 

  507.     </tr>
    508. 

  508.     <tr>
    509. 

  509.         <td rowspan="2">&nbsp;</td>
    510. 

  510.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    511. 

  511.         this property to set a custom cursor for the link-effect
    512. 

  512.         during drag&amp;drop </font><font face="Arial">and
    513. 

  513.         scrolling in the target window. </font></td>
    514. 

  514.     </tr>
    515. 

  515.     <tr>
    516. 

  516.         <td bgcolor="#FFFFEF">&nbsp;</td>
    517. 

  517.     </tr>
    518. 

  518.     <tr>
    519. 

  519.         <td>&nbsp;</td>
    520. 

  520.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    521. 

  521.         face="Arial"><b>CHScrollMove</b></font><font size="3"
    522. 

  522.         face="Arial"><b> </b></font><font color="#FFFF80"
    523. 

  523.         size="3" face="Arial"><b><i>public</i></b></font></td>
    524. 

  524.     </tr>
    525. 

  525.     <tr>
    526. 

  526.         <td rowspan="2">&nbsp;</td>
    527. 

  527.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Use
    528. 

  528.         this property to set a custom cursor for the move-effect
    529. 

  529.         during drag&amp;drop </font><font face="Arial">and
    530. 

  530.         scrolling in the target window. </font></td>
    531. 

  531.     </tr>
    532. 

  532.     <tr>
    533. 

  533.         <td bgcolor="#FFFFEF">&nbsp;</td>
    534. 

  534.     </tr>
    535. 

  535.     <tr>
    536. 

  536.         <td>&nbsp;</td>
    537. 

  537.         <td bgcolor="#008080"><a name="DragDetectDelta"><font
    538. 

  538.         color="#FFFFFF" size="5" face="Arial"><b>DragDetectDelta</b></font></a><font
    539. 

  539.         size="5" face="Arial"><b> </b></font><font
    540. 

  540.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    541. 

  541.     </tr>
    542. 

  542.     <tr>
    543. 

  543.         <td rowspan="2">&nbsp;</td>
    544. 

  544.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is the
    545. 

  545.         drag detection enabled by<b> </b></font><a
    546. 

  546.         href="#AutoDetectDnD"><font size="3" face="Arial"><b><i>AutoDetectDnD</i></b></font></a><font
    547. 

  547.         size="3" face="Arial"> or calling </font><a
    548. 

  548.         href="#StartDnDDetection"><font size="3" face="Arial"><b><i>StartDnDDetection</i></b></font></a><font
    549. 

  549.         size="3" face="Arial">, the drag detection was
    550. 

  550.         successful, if the mouse was moved over more than in this
    551. 

  551.         property defined pixels. </font></td>
    552. 

  552.     </tr>
    553. 

  553.     <tr>
    554. 

  554.         <td bgcolor="#FFFFEF">&nbsp;</td>
    555. 

  555.     </tr>
    556. 

  556.     <tr>
    557. 

  557.         <td>&nbsp;</td>
    558. 

  558.         <td bgcolor="#008080"><a name="DragDropControl"><font
    559. 

  559.         color="#FFFFFF" size="5" face="Arial"><b>DragDropControl</b></font></a><font
    560. 

  560.         size="3" face="Arial"><b> </b></font><font
    561. 

  561.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    562. 

  562.     </tr>
    563. 

  563.     <tr>
    564. 

  564.         <td rowspan="2">&nbsp;</td>
    565. 

  565.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Choose
    566. 

  566.         here a component like Listbox etc. that should be handled
    567. 

  567.         as source and target for drag&amp;drop operations.</font>
    568. 

  568.         <p><font color="#FF0000" size="3" face="Arial"><strong>IMPORTANT:</strong></font><font
    569. 

  569.         size="3" face="Arial"> If you use the drag-detection,
    570. 

  570.         it's high recommended to check the section &quot;</font><a
    571. 

  571.         href="#DragDetectionProblem"><font size="3" face="Arial">Problems
    572. 

  572.         With The Drag-Detection</font></a><font size="3"
    573. 

  573.         face="Arial">&quot;.</font></p>
    574. 

  574.         </td>
    575. 

  575.     </tr>
    576. 

  576.     <tr>
    577. 

  577.         <td bgcolor="#FFFFEF">&nbsp;</td>
    578. 

  578.     </tr>
    579. 

  579.     <tr>
    580. 

  580.         <td>&nbsp;</td>
    581. 

  581.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    582. 

  582.         face="Arial"><b>OwnerIsSource</b></font><font size="3"
    583. 

  583.         face="Arial"><b> </b></font><font color="#FFFF80"
    584. 

  584.         size="3" face="Arial"><b><i>public, read-only</i></b></font></td>
    585. 

  585.     </tr>
    586. 

  586.     <tr>
    587. 

  587.         <td rowspan="2">&nbsp;</td>
    588. 

  588.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    589. 

  589.         property indicates during a drag&amp;drop operation, if
    590. 

  590.         the<b> </b></font><a href="#DragDropControl"><font
    591. 

  591.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    592. 

  592.         size="3" face="Arial"> is the source of the
    593. 

  593.         d&amp;d-operation or not. </font></td>
    594. 

  594.     </tr>
    595. 

  595.     <tr>
    596. 

  596.         <td bgcolor="#FFFFEF">&nbsp;</td>
    597. 

  597.     </tr>
    598. 

  598.     <tr>
    599. 

  599.         <td>&nbsp;</td>
    600. 

  600.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    601. 

  601.         face="Arial"><b>Registered</b></font><font size="5"
    602. 

  602.         face="Arial"><b> </b></font><font color="#FFFF80"
    603. 

  603.         size="3" face="Arial"><b><i>public, read-only</i></b></font></td>
    604. 

  604.     </tr>
    605. 

  605.     <tr>
    606. 

  606.         <td rowspan="2">&nbsp;</td>
    607. 

  607.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">You can
    608. 

  608.         determine here, if the<b> </b></font><a
    609. 

  609.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    610. 

  610.         size="3" face="Arial"> is registered as target of
    611. 

  611.         drag&amp;drop operations or not.</font></td>
    612. 

  612.     </tr>
    613. 

  613.     <tr>
    614. 

  614.         <td bgcolor="#FFFFEF">&nbsp;</td>
    615. 

  615.     </tr>
    616. 

  616.     <tr>
    617. 

  617.         <td>&nbsp;</td>
    618. 

  618.         <td bgcolor="#008080"><a name="RenderOn"><font
    619. 

  619.         color="#FFFFFF" size="5" face="Arial"><b>RenderOn</b></font></a><font
    620. 

  620.         size="5" face="Arial"><b> </b></font><font
    621. 

  621.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    622. 

  622.     </tr>
    623. 

  623.     <tr>
    624. 

  624.         <td rowspan="2">&nbsp;</td>
    625. 

  625.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">You can
    626. 

  626.         determine here, when the dropped data should be rendered
    627. 

  627.         (only important for the inherited classes).</font> <p><font
    628. 

  628.         size="3" face="Arial">If it is set to<strong> </strong><strong><i>rdoDropSync</i></strong>,
    629. 

  629.         the data is rendered before calling the event-handler </font><a
    630. 

  630.         href="#OnDrop"><font size="3" face="Arial"><b><i>OnDrop</i></b></font></a><font
    631. 

  631.         size="3" face="Arial">.</font></p>
    632. 

  632.         <p><font size="3" face="Arial">If it is set to <b><i>rdoDropAsync</i></b>,
    633. 

  633.         the data is rendered before calling the event-handler </font><a
    634. 

  634.         href="#OnProcessDropped"><font size="3" face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    635. 

  635.         size="3" face="Arial">.</font></p>
    636. 

  636.         <p><font size="3" face="Arial">If it is set to <b><i>rdoEnter</i></b>,
    637. 

  637.         the data is rendered before calling the event-handler </font><a
    638. 

  638.         href="#OnDragEnter"><font size="3" face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    639. 

  639.         size="3" face="Arial">.</font></p>
    640. 

  640.         <p><font size="3" face="Arial">If it is set to <b><i>rdoEnterAndDropSync</i></b>,
    641. 

  641.         the data is rendered before calling the event-handler </font><a
    642. 

  642.         href="#OnDragEnter"><font size="3" face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    643. 

  643.         size="3" face="Arial"> AND before calling the
    644. 

  644.         event-handler </font><a href="#OnDrop"><font size="3"
    645. 

  645.         face="Arial"><b><i>OnDrop</i></b></font></a><font
    646. 

  646.         size="3" face="Arial"> (yes two times - in some cases
    647. 

  647.         it's necessary).</font></p>
    648. 

  648.         <p><font size="3" face="Arial">If it is set to <b><i>rdoEnterAndDropAsync</i></b>,
    649. 

  649.         the data is rendered before calling the event-handler </font><a
    650. 

  650.         href="#OnDragEnter"><font size="3" face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    651. 

  651.         size="3" face="Arial"> AND before calling the
    652. 

  652.         event-handler </font><a href="#OnProcessDropped"><font
    653. 

  653.         size="3" face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    654. 

  654.         size="3" face="Arial"> (yes two times - in some cases
    655. 

  655.         it's necessary).</font></p>
    656. 

  656.         <p><font size="3" face="Arial">If it is set to <b><i>rdoNever</i></b>,
    657. 

  657.         the data is never rendered. Normally, you never need this
    658. 

  658.         value - it makes only sense for application-internal
    659. 

  659.         drag&amp;drop (the application knows the data; why should
    660. 

  660.         we spend our precious time on rendering the known data?)</font></p>
    661. 

  661.         <p><font size="3" face="Arial">Be careful, if you set
    662. 

  662.         this property to <b><i>rdoDropAsync</i></b>, <b><i>rdoDropEnterAndDropSync</i></b>,
    663. 

  663.         <b><i>rdoDropEnterAndDropAsync</i></b> or <b><i>rdoEnter</i></b>,
    664. 

  664.         because the OLE2 Drag&amp;Drop isn't correctly
    665. 

  665.         implemented in every program. On testing (high
    666. 

  666.         recommend!!!), you will be surprised, how many well-known
    667. 

  667.         programs make trouble because of wrong implemention. </font></p>
    668. 

  668.         </td>
    669. 

  669.     </tr>
    670. 

  670.     <tr>
    671. 

  671.         <td bgcolor="#FFFFEF">&nbsp;</td>
    672. 

  672.     </tr>
    673. 

  673.     <tr>
    674. 

  674.         <td>&nbsp;</td>
    675. 

  675.         <td bgcolor="#008080"><a name="ScrollDetectOptions"><font
    676. 

  676.         color="#FFFFFF" size="5" face="Arial"><b>ScrollDetectOptions</b></font></a><font
    677. 

  677.         size="3" face="Arial"><b> </b></font><font
    678. 

  678.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    679. 

  679.     </tr>
    680. 

  680.     <tr>
    681. 

  681.         <td rowspan="2">&nbsp;</td>
    682. 

  682.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    683. 

  683.         property has many sub-properties:</font> <ul>
    684. 

  684.             <li><font size="3" face="Arial"><em><b>AreaBottom</b></em>,
    685. 

  685.                 <em><b>AreaLeft</b></em>, <em><b>AreaRight</b></em>
    686. 

  686.                 and <em><b>AreaTop</b></em></font></li>
    687. 

  687.             <li><font size="3" face="Arial"><em><b>HorzScrolling</b></em>
    688. 

  688.                 and <em><b>VertScrolling</b></em></font></li>
    689. 

  689.             <li><font size="3" face="Arial"><em><b>HorzPageScroll</b></em>
    690. 

  690.                 and <em><b>VertPageScroll</b></em></font></li>
    691. 

  691.             <li><font size="3" face="Arial"><em><b>ScrollDelay</b></em><b>
    692. 

  692.                 </b>and<b> </b><em><b>StartDelay</b></em></font></li>
    693. 

  693.         </ul>
    694. 

  694.         <p><font size="3" face="Arial"><em><b>AreaBottom</b></em>,
    695. 

  695.         <em><b>AreaLeft</b></em>, <em><b>AreaRight</b></em>, <em><b>AreaTop</b></em>
    696. 

  696.         have the sub-properties <em><b>Margin</b></em>, <em><b>Range</b></em>.
    697. 

  697.         You can determine with <em><b>Margin</b></em> where the
    698. 

  698.         scroll-detect-area begins, measured from the </font><font
    699. 

  699.         color="#FF0000" size="3" face="Arial"><strong>client</strong></font><font
    700. 

  700.         size="3" face="Arial">area-border. You can determine with
    701. 

  701.         <em><b>Range</b></em> the width resp. height of the
    702. 

  702.         scroll-detect-area. The properties <b><i>AreaBottom</i></b>
    703. 

  703.         and <b><i>AreaTop</i></b> are used for the vertical
    704. 

  704.         scroll detection, <b><i>AreaLeft</i></b> and <b><i>AreaRight</i></b>
    705. 

  705.         for the horizontal detection.</font></p>
    706. 

  706.         <p><font size="3" face="Arial"><em><b>HorzScrolling</b></em>
    707. 

  707.         and <em><b>VertScrolling</b></em> are further
    708. 

  708.         sub-properties under <b><i>ScrollDetectOptions</i></b>.
    709. 

  709.         You can enable/disable the scroll detection with these
    710. 

  710.         properties.</font></p>
    711. 

  711.         <p><font size="3" face="Arial"><em><b>HorzPageScroll</b></em>
    712. 

  712.         and <em><b>VertPageScroll</b></em> are even further
    713. 

  713.         sub-properties under <b><i>ScrollDetectOptions</i></b>.
    714. 

  714.         You can switch here between line or page scrolling.</font></p>
    715. 

  715.         <p><font size="3" face="Arial"><em><b>ScrollDelay</b></em>
    716. 

  716.         is even a sub-property under <b><i>ScrollDetectOptions</i></b>.
    717. 

  717.         You can determine with property the delay time to the
    718. 

  718.         next scroll event in the <b><i>DragDropControl</i></b>.</font></p>
    719. 

  719.         <p><font size="3" face="Arial"><em><b>StartDelay</b></em>
    720. 

  720.         is even a further sub-property under <b><i>ScrollDetectOptions</i></b>.
    721. 

  721.         You can determine with property the delay time till the
    722. 

  722.         first scroll event is sent to the <b><i>DragDropControl</i></b>.</font></p>
    723. 

  723.         <p><font size="3" face="Arial">The scroll-detection does
    724. 

  724.         only work, if at least one </font><a
    725. 

  725.         href="#TargetEffects"><font size="3" face="Arial">TargetEffect</font></a><font
    726. 

  726.         size="3" face="Arial"> is set.</font></p>
    727. 

  727.         </td>
    728. 

  728.     </tr>
    729. 

  729.     <tr>
    730. 

  730.         <td bgcolor="#FFFFEF">&nbsp;</td>
    731. 

  731.     </tr>
    732. 

  732.     <tr>
    733. 

  733.         <td>&nbsp;</td>
    734. 

  734.         <td bgcolor="#008080"><a name="SourceCompatibility"><font
    735. 

  735.         color="#FFFFFF" size="5" face="Arial"><b>SourceCompatibility</b></font></a><font
    736. 

  736.         size="5" face="Arial"><b> </b></font><font
    737. 

  737.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    738. 

  738.     </tr>
    739. 

  739.     <tr>
    740. 

  740.         <td rowspan="2">&nbsp;</td>
    741. 

  741.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    742. 

  742.         property was added due to incompatible implemention of
    743. 

  743.         drag&amp;drop in other applications. They set some value
    744. 

  744.         incorrectly in the <em><strong>FormatEtc</strong></em>
    745. 

  745.         record, because these values aren't used for the dragged
    746. 

  746.         format. With this property you can determine, if you
    747. 

  747.         don't to check these values for a successful
    748. 

  748.         drag&amp;drop. If you disable a check, you take risk to
    749. 

  749.         drop data in a invalid format. Normally, you need not to
    750. 

  750.         switch this property.</font></td>
    751. 

  751.     </tr>
    752. 

  752.     <tr>
    753. 

  753.         <td bgcolor="#FFFFEF">&nbsp;</td>
    754. 

  754.     </tr>
    755. 

  755.     <tr>
    756. 

  756.         <td>&nbsp;</td>
    757. 

  757.         <td bgcolor="#008080"><a name="SourceEffects"><font
    758. 

  758.         color="#FFFFFF" size="5" face="Arial"><b>SourceEffects</b></font></a><font
    759. 

  759.         size="5" face="Arial"><b> </b></font><font
    760. 

  760.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    761. 

  761.     </tr>
    762. 

  762.     <tr>
    763. 

  763.         <td rowspan="2">&nbsp;</td>
    764. 

  764.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Choose
    765. 

  765.         the effects that the<b> </b></font><a
    766. 

  766.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    767. 

  767.         size="3" face="Arial"> should support. If you don't want
    768. 

  768.         that the </font><a href="#DragDropControl"><font size="3"
    769. 

  769.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    770. 

  770.         size="3" face="Arial"> serve as drag&amp;drop source all
    771. 

  771.         items must be false.</font> <p><font color="#FF0000"
    772. 

  772.         size="3" face="Arial"><strong>IMPORTANT:</strong></font><font
    773. 

  773.         size="3" face="Arial"> If you use the drag-detection,
    774. 

  774.         it's high recommended to check the section &quot;</font><a
    775. 

  775.         href="#DragDetectionProblem"><font size="3" face="Arial">Problems
    776. 

  776.         With The Drag-Detection</font></a><font size="3"
    777. 

  777.         face="Arial">&quot;.</font></p>
    778. 

  778.         </td>
    779. 

  779.     </tr>
    780. 

  780.     <tr>
    781. 

  781.         <td bgcolor="#FFFFEF">&nbsp;</td>
    782. 

  782.     </tr>
    783. 

  783.     <tr>
    784. 

  784.         <td>&nbsp;</td>
    785. 

  785.         <td bgcolor="#008080"><a name="TargetEffects"><font
    786. 

  786.         color="#FFFFFF" size="5" face="Arial"><b>TargetEffects</b></font></a><font
    787. 

  787.         size="5" face="Arial"><b> </b></font><font
    788. 

  788.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    789. 

  789.     </tr>
    790. 

  790.     <tr>
    791. 

  791.         <td rowspan="2">&nbsp;</td>
    792. 

  792.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Choose
    793. 

  793.         the effects that the<b> </b></font><a
    794. 

  794.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    795. 

  795.         size="3" face="Arial"> should support. If you don't want
    796. 

  796.         that the </font><a href="#DragDropControl"><font size="3"
    797. 

  797.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    798. 

  798.         size="3" face="Arial"> serve as drag&amp;drop target, all
    799. 

  799.         items must be false. </font></td>
    800. 

  800.     </tr>
    801. 

  801.     <tr>
    802. 

  802.         <td bgcolor="#FFFFEF">&nbsp;</td>
    803. 

  803.     </tr>
    804. 

  804.     <tr>
    805. 

  805.         <td>&nbsp;</td>
    806. 

  806.         <td bgcolor="#008080"><a name="TargetPopUpMenu"><font
    807. 

  807.         color="#FFFFFF" size="5" face="Arial"><b>TargetPopUpMenu</b></font></a><font
    808. 

  808.         size="5" face="Arial"><b> </b></font><font
    809. 

  809.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    810. 

  810.     </tr>
    811. 

  811.     <tr>
    812. 

  812.         <td rowspan="2">&nbsp;</td>
    813. 

  813.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Here
    814. 

  814.         you determine, if should the popup-menu get visible when
    815. 

  815.         a drag&amp;drop operations occurs with pressing the right
    816. 

  816.         mouse button or not. (Important, if the <em><strong>DragDropControl</strong></em>
    817. 

  817.         is configured as drag&amp;drop target!!!) </font></td>
    818. 

  818.     </tr>
    819. 

  819.     <tr>
    820. 

  820.         <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
    821. 

  821.     </tr>
    822. 

  822. </table>
    823. 

  823. 

  824. <table border="0" width="600">
    825. 

  825.     <tr>
    826. 

  826.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    827. 

  827.         <td rowspan="2" width="590"><font size="5" face="Arial">Events</font></td>
    828. 

  828.     </tr>
    829. 

  829.     <tr>
    830. 

  830.         <td>&nbsp;</td>
    831. 

  831.     </tr>
    832. 

  832. </table>
    833. 

  833. 

  834. <table border="0" cellpadding="3" cellspacing="0" width="600">
    835. 

  835.     <tr>
    836. 

  836.         <td width="10">&nbsp;</td>
    837. 

  837.         <td bgcolor="#008080"><a name="OnBeforeScrolling"><font
    838. 

  838.         color="#FFFFFF" size="5" face="Arial"><b>OnBeforeScrolling</b></font></a><font
    839. 

  839.         size="5" face="Arial"><b> </b></font><font
    840. 

  840.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    841. 

  841.     </tr>
    842. 

  842.     <tr>
    843. 

  843.         <td rowspan="2">&nbsp;</td>
    844. 

  844.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    845. 

  845.         event is called before a scroll-event is sent to the<b> </b><b><i>DragDropControl</i></b>.
    846. 

  846.         The scroll-detection must be enabled for this event. </font></td>
    847. 

  847.     </tr>
    848. 

  848.     <tr>
    849. 

  849.         <td bgcolor="#FFFFEF">&nbsp;</td>
    850. 

  850.     </tr>
    851. 

  851.     <tr>
    852. 

  852.         <td>&nbsp;</td>
    853. 

  853.         <td bgcolor="#008080"><a name="OnAfterScrolling"><font
    854. 

  854.         color="#FFFFFF" size="5" face="Arial"><b>OnAfterScrolling</b></font></a><font
    855. 

  855.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    856. 

  856.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    857. 

  857.     </tr>
    858. 

  858.     <tr>
    859. 

  859.         <td rowspan="2">&nbsp;</td>
    860. 

  860.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    861. 

  861.         event is called after a scroll-event is sent to the<b> </b><b><i>DragDropControl</i></b>.
    862. 

  862.         The scroll-detection must be enabled for this event. </font></td>
    863. 

  863.     </tr>
    864. 

  864.     <tr>
    865. 

  865.         <td bgcolor="#FFFFEF">&nbsp;</td>
    866. 

  866.     </tr>
    867. 

  867.     <tr>
    868. 

  868.         <td>&nbsp;</td>
    869. 

  869.         <td bgcolor="#008080"><a name="OnDragDetect"><font
    870. 

  870.         color="#FFFFFF" size="5" face="Arial"><b>OnDragDetect</b></font></a><font
    871. 

  871.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    872. 

  872.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    873. 

  873.     </tr>
    874. 

  874.     <tr>
    875. 

  875.         <td rowspan="2">&nbsp;</td>
    876. 

  876.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    877. 

  877.         called on starting (parameter <b><i>DragStatus</i></b>=<b><i>ddsLeft</i></b>
    878. 

  878.         or <b><i>ddsRight</i></b>, depends which mousebutton is
    879. 

  879.         pressed), on starting the drag (<b><i>DragStatus</i></b>=<b><i>ddsDrag</i></b>),
    880. 

  880.         on finishing the detection (<b><i>DragStatus</i></b>=<b><i>ddsNone</i></b>)
    881. 

  881.         and cancelling the detection (<b><i>DragStatus</i></b>=<b><i>ddsCancelled</i></b>).
    882. 

  882.         If <b><i>DragStatus</i></b>=<b><i>ddsDrag</i></b>, the
    883. 

  883.         drag&amp;drop operation won't be started automatically.
    884. 

  884.         If you want to start drag&amp;drop, you must call </font><a
    885. 

  885.         href="#Execute"><font size="3" face="Arial"><b><i>Execute</i></b></font></a><font
    886. 

  886.         size="3" face="Arial"> on yourself. The parameters <b><i>DetectStartX</i></b>
    887. 

  887.         and <b><i>DetectStartY</i></b> specify the cursor
    888. 

  888.         position, where the detection has started. The parameters
    889. 

  889.         <b><i>x</i></b> and <b><i>y</i></b> specify the current
    890. 

  890.         position of the cursor.</font><p><font color="#FF0000"
    891. 

  891.         size="3" face="Arial"><strong>IMPORTANT:</strong></font><font
    892. 

  892.         size="3" face="Arial"> If you use the drag-detection,
    893. 

  893.         it's high recommended to check the section &quot;</font><a
    894. 

  894.         href="#DragDetectionProblem"><font size="3" face="Arial">Problems
    895. 

  895.         With The Drag-Detection</font></a><font size="3"
    896. 

  896.         face="Arial">&quot;.</font></p>
    897. 

  897.         </td>
    898. 

  898.     </tr>
    899. 

  899.     <tr>
    900. 

  900.         <td bgcolor="#FFFFEF">&nbsp;</td>
    901. 

  901.     </tr>
    902. 

  902.     <tr>
    903. 

  903.         <td>&nbsp;</td>
    904. 

  904.         <td bgcolor="#008080"><a name="OnDragEnter"><font
    905. 

  905.         color="#FFFFFF" size="5" face="Arial"><b>OnDragEnter</b></font></a><font
    906. 

  906.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    907. 

  907.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    908. 

  908.     </tr>
    909. 

  909.     <tr>
    910. 

  910.         <td rowspan="2">&nbsp;</td>
    911. 

  911.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    912. 

  912.         called, when the<b> </b></font><a href="#DragDropControl"><font
    913. 

  913.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    914. 

  914.         size="3" face="Arial"> is a target of drag&amp;drop
    915. 

  915.         operations. The mouse cursor moves ON (one call only) the
    916. 

  916.         </font><a href="#DragDropControl"><font size="3"
    917. 

  917.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    918. 

  918.         size="3" face="Arial">. Here, you influence if a drop can
    919. 

  919.         be accepted and the drop's effect if accepted. </font></td>
    920. 

  920.     </tr>
    921. 

  921.     <tr>
    922. 

  922.         <td bgcolor="#FFFFEF">&nbsp;</td>
    923. 

  923.     </tr>
    924. 

  924.     <tr>
    925. 

  925.         <td>&nbsp;</td>
    926. 

  926.         <td bgcolor="#008080"><a name="OnDragLeave"><font
    927. 

  927.         color="#FFFFFF" size="5" face="Arial"><b>OnDragLeave</b></font></a><font
    928. 

  928.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    929. 

  929.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    930. 

  930.     </tr>
    931. 

  931.     <tr>
    932. 

  932.         <td rowspan="2">&nbsp;</td>
    933. 

  933.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    934. 

  934.         called, when the<b> </b></font><a href="#DragDropControl"><font
    935. 

  935.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    936. 

  936.         size="3" face="Arial"> is a target of drag&amp;drop
    937. 

  937.         operations. The mouse cursor leaves the </font><a
    938. 

  938.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    939. 

  939.         size="3" face="Arial"> (one call only) or the
    940. 

  940.         drag&amp;drop operation is cancelled. </font></td>
    941. 

  941.     </tr>
    942. 

  942.     <tr>
    943. 

  943.         <td bgcolor="#FFFFEF">&nbsp;</td>
    944. 

  944.     </tr>
    945. 

  945.     <tr>
    946. 

  946.         <td>&nbsp;</td>
    947. 

  947.         <td bgcolor="#008080"><a name="OnDragOver"><font
    948. 

  948.         color="#FFFFFF" size="5" face="Arial"><b>OnDragOver</b></font></a><font
    949. 

  949.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    950. 

  950.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    951. 

  951.     </tr>
    952. 

  952.     <tr>
    953. 

  953.         <td rowspan="2">&nbsp;</td>
    954. 

  954.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    955. 

  955.         called, when the<b> </b></font><a href="#DragDropControl"><font
    956. 

  956.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    957. 

  957.         size="3" face="Arial"> is a target of drag&amp;drop
    958. 

  958.         operations. The mouse cursor moves OVER (called on every
    959. 

  959.         mouse move) the </font><a href="#DragDropControl"><font
    960. 

  960.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    961. 

  961.         size="3" face="Arial">. Even here, you can influence if a
    962. 

  962.         drop can be accepted and the drop's effect if accepted.
    963. 

  963.         Because this function is very often called, YOUR method
    964. 

  964.         should be programmed very efficient. </font></td>
    965. 

  965.     </tr>
    966. 

  966.     <tr>
    967. 

  967.         <td bgcolor="#FFFFEF">&nbsp;</td>
    968. 

  968.     </tr>
    969. 

  969.     <tr>
    970. 

  970.         <td>&nbsp;</td>
    971. 

  971.         <td bgcolor="#008080"><a name="OnDrop"><font
    972. 

  972.         color="#FFFFFF" size="5" face="Arial"><b>OnDrop</b></font></a><font
    973. 

  973.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    974. 

  974.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    975. 

  975.     </tr>
    976. 

  976.     <tr>
    977. 

  977.         <td rowspan="2">&nbsp;</td>
    978. 

  978.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is </font><font
    979. 

  979.         face="Arial">triggered</font><font size="3" face="Arial">,
    980. 

  980.         when the<b> </b></font><a href="#DragDropControl"><font
    981. 

  981.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    982. 

  982.         size="3" face="Arial"> is the target of drag&amp;drop
    983. 

  983.         operations. It instructs the </font><a
    984. 

  984.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    985. 

  985.         size="3" face="Arial"> to handle the data which are
    986. 

  986.         dropped on it. Save here only the dropped data (, if this
    987. 

  987.         isn't done by the child-class), because the source of the
    988. 

  988.         drag&amp;drop operation isn't accessable any longer as
    989. 

  989.         soon as this event-method was left. For processing the
    990. 

  990.         data in a child-class, it's high recommend to use </font><a
    991. 

  991.         href="#OnProcessDropped"><font size="3" face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    992. 

  992.         size="3" face="Arial">.</font></td>
    993. 

  993.     </tr>
    994. 

  994.     <tr>
    995. 

  995.         <td bgcolor="#FFFFEF">&nbsp;</td>
    996. 

  996.     </tr>
    997. 

  997.     <tr>
    998. 

  998.         <td>&nbsp;</td>
    999. 

  999.         <td bgcolor="#008080"><a name="OnDropHandlerSucceeded"><font
    1000. 

  1000.         color="#FFFFFF" size="5" face="Arial"><b>OnDropHandlerSucceeded</b></font></a><font
    1001. 

  1001.         size="5" face="Arial"><b> </b></font><font
    1002. 

  1002.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1003. 

  1003.     </tr>
    1004. 

  1004.     <tr>
    1005. 

  1005.         <td>&nbsp;</td>
    1006. 

  1006.         <td bgcolor="#FFFFCC"><font face="Arial">Is triggered, if
    1007. 

  1007.         the </font><a href="#DropHandler"><font face="Arial"><em><strong>DropHandler</strong></em></font></a><font
    1008. 

  1008.         face="Arial"> was successfully called and executed.</font><p><font
    1009. 

  1009.         face="Arial">Also check the section: </font><font
    1010. 

  1010.         size="3" face="Arial">&quot;</font><a
    1011. 

  1011.         href="#Details about the DropHandler"><font size="3"
    1012. 

  1012.         face="Arial">Details about the DropHandler</font></a><font
    1013. 

  1013.         size="3" face="Arial">&quot;.</font></p>
    1014. 

  1014.         </td>
    1015. 

  1015.     </tr>
    1016. 

  1016.     <tr>
    1017. 

  1017.         <td>&nbsp;</td>
    1018. 

  1018.         <td>&nbsp;</td>
    1019. 

  1019.     </tr>
    1020. 

  1020.     <tr>
    1021. 

  1021.         <td>&nbsp;</td>
    1022. 

  1022.         <td bgcolor="#008080"><a name="OnGiveFeedback"><font
    1023. 

  1023.         color="#FFFFFF" size="5" face="Arial"><b>OnGiveFeedback</b></font></a><font
    1024. 

  1024.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    1025. 

  1025.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    1026. 

  1026.     </tr>
    1027. 

  1027.     <tr>
    1028. 

  1028.         <td rowspan="2">&nbsp;</td>
    1029. 

  1029.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    1030. 

  1030.         called, when the<b> </b></font><a href="#DragDropControl"><font
    1031. 

  1031.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    1032. 

  1032.         size="3" face="Arial"> is the source of drag&amp;drop
    1033. 

  1033.         operations. It enables the source application to give
    1034. 

  1034.         visual feedback to its end user during a drag&amp;drop
    1035. 

  1035.         operation by providing the OLE <b><i>DoDragDrop</i></b>
    1036. 

  1036.         function with an enumeration value specifying the visual
    1037. 

  1037.         effect. Mostly you don't need this event. </font></td>
    1038. 

  1038.     </tr>
    1039. 

  1039.     <tr>
    1040. 

  1040.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1041. 

  1041.     </tr>
    1042. 

  1042.     <tr>
    1043. 

  1043.         <td>&nbsp;</td>
    1044. 

  1044.         <td bgcolor="#008080"><a name="OnMenuDestroy"><font
    1045. 

  1045.         color="#FFFFFF" size="5" face="Arial"><b>OnMenuDestroy</b></font></a><font
    1046. 

  1046.         size="5" face="Arial"><b> </b></font><font
    1047. 

  1047.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1048. 

  1048.     </tr>
    1049. 

  1049.     <tr>
    1050. 

  1050.         <td>&nbsp;</td>
    1051. 

  1051.         <td bgcolor="#FFFFCC"><font face="Arial">Is triggered,
    1052. 

  1052.         when the context-menu and its items are going to be
    1053. 

  1053.         destroyed. This event important for you, if you have add
    1054. 

  1054.         custom items to the menu.</font><p><font face="Arial">Also
    1055. 

  1055.         check the section: </font><font size="3" face="Arial">&quot;</font><a
    1056. 

  1056.         href="#Details about the context-menu"><font size="3"
    1057. 

  1057.         face="Arial">Details about the context-menu</font></a><font
    1058. 

  1058.         size="3" face="Arial">&quot;.</font></p>
    1059. 

  1059.         </td>
    1060. 

  1060.     </tr>
    1061. 

  1061.     <tr>
    1062. 

  1062.         <td>&nbsp;</td>
    1063. 

  1063.         <td>&nbsp;</td>
    1064. 

  1064.     </tr>
    1065. 

  1065.     <tr>
    1066. 

  1066.         <td>&nbsp;</td>
    1067. 

  1067.         <td bgcolor="#008080"><a name="OnMenuExecCmd"><font
    1068. 

  1068.         color="#FFFFFF" size="5" face="Arial"><b>OnMenuExecCmd</b></font></a><font
    1069. 

  1069.         size="5" face="Arial"><b> </b></font><font
    1070. 

  1070.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1071. 

  1071.     </tr>
    1072. 

  1072.     <tr>
    1073. 

  1073.         <td>&nbsp;</td>
    1074. 

  1074.         <td bgcolor="#FFFFCC"><font face="Arial">Is triggered,
    1075. 

  1075.         when a custom item was selected in the context-menu by
    1076. 

  1076.         the user. Now, you should execute the routines etc, which
    1077. 

  1077.         are linked with the selected menuitem.</font><p><font
    1078. 

  1078.         face="Arial">Also check the section: </font><font
    1079. 

  1079.         size="3" face="Arial">&quot;</font><a
    1080. 

  1080.         href="#Details about the context-menu"><font size="3"
    1081. 

  1081.         face="Arial">Details about the context-menu</font></a><font
    1082. 

  1082.         size="3" face="Arial">&quot;.</font></p>
    1083. 

  1083.         </td>
    1084. 

  1084.     </tr>
    1085. 

  1085.     <tr>
    1086. 

  1086.         <td>&nbsp;</td>
    1087. 

  1087.         <td>&nbsp;</td>
    1088. 

  1088.     </tr>
    1089. 

  1089.     <tr>
    1090. 

  1090.         <td>&nbsp;</td>
    1091. 

  1091.         <td bgcolor="#008080"><a name="OnMenuPopup"><font
    1092. 

  1092.         color="#FFFFFF" size="5" face="Arial"><b>OnMenuPopup</b></font></a><font
    1093. 

  1093.         size="5" face="Arial"><b> </b></font><font
    1094. 

  1094.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1095. 

  1095.     </tr>
    1096. 

  1096.     <tr>
    1097. 

  1097.         <td>&nbsp;</td>
    1098. 

  1098.         <td bgcolor="#FFFFCC"><font face="Arial">Is triggered,
    1099. 

  1099.         when the context-menu is going to popup.</font><p><font
    1100. 

  1100.         face="Arial">Also check the section: </font><font
    1101. 

  1101.         size="3" face="Arial">&quot;</font><a
    1102. 

  1102.         href="#Details about the context-menu"><font size="3"
    1103. 

  1103.         face="Arial">Details about the context-menu</font></a><font
    1104. 

  1104.         size="3" face="Arial">&quot;.</font></p>
    1105. 

  1105.         </td>
    1106. 

  1106.     </tr>
    1107. 

  1107.     <tr>
    1108. 

  1108.         <td>&nbsp;</td>
    1109. 

  1109.         <td>&nbsp;</td>
    1110. 

  1110.     </tr>
    1111. 

  1111.     <tr>
    1112. 

  1112.         <td>&nbsp;</td>
    1113. 

  1113.         <td bgcolor="#008080"><a name="OnMenuSucceeded"><font
    1114. 

  1114.         color="#FFFFFF" size="5" face="Arial"><b>OnMenuSucceeded</b></font></a><font
    1115. 

  1115.         size="5" face="Arial"><b> </b></font><font
    1116. 

  1116.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1117. 

  1117.     </tr>
    1118. 

  1118.     <tr>
    1119. 

  1119.         <td>&nbsp;</td>
    1120. 

  1120.         <td bgcolor="#FFFFCC"><font face="Arial">Is triggered,
    1121. 

  1121.         when the routines etc, which are linked with the selected
    1122. 

  1122.         menuitem, were successfully executed.</font><p><font
    1123. 

  1123.         face="Arial">Also check the section: </font><font
    1124. 

  1124.         size="3" face="Arial">&quot;</font><a
    1125. 

  1125.         href="#Details about the context-menu"><font size="3"
    1126. 

  1126.         face="Arial">Details about the context-menu</font></a><font
    1127. 

  1127.         size="3" face="Arial">&quot;.</font></p>
    1128. 

  1128.         </td>
    1129. 

  1129.     </tr>
    1130. 

  1130.     <tr>
    1131. 

  1131.         <td>&nbsp;</td>
    1132. 

  1132.         <td>&nbsp;</td>
    1133. 

  1133.     </tr>
    1134. 

  1134.     <tr>
    1135. 

  1135.         <td>&nbsp;</td>
    1136. 

  1136.         <td bgcolor="#008080"><a name="OnProcessDropped"><font
    1137. 

  1137.         color="#FFFFFF" size="5" face="Arial"><b>OnProcessDropped</b></font></a><font
    1138. 

  1138.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    1139. 

  1139.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    1140. 

  1140.     </tr>
    1141. 

  1141.     <tr>
    1142. 

  1142.         <td rowspan="2">&nbsp;</td>
    1143. 

  1143.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    1144. 

  1144.         called after<b> </b></font><a href="#OnDrop"><font
    1145. 

  1145.         size="3" face="Arial"><b><i>OnDrop</i></b></font></a><font
    1146. 

  1146.         size="3" face="Arial"> by a self sended message with
    1147. 

  1147.         &quot;PostMessage&quot;. This has the effect, that the
    1148. 

  1148.         user can access to the source of the drag&amp;drop
    1149. 

  1149.         operation during you process the dropped data. Of course,
    1150. 

  1150.         you must save the dropped data in </font><a
    1151. 

  1151.         href="#OnDrop"><font size="3" face="Arial"><b><i>OnDrop</i></b></font></a><font
    1152. 

  1152.         size="3" face="Arial">. In my child-classes you haven't
    1153. 

  1153.         care about this. </font></td>
    1154. 

  1154.     </tr>
    1155. 

  1155.     <tr>
    1156. 

  1156.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1157. 

  1157.     </tr>
    1158. 

  1158.     <tr>
    1159. 

  1159.         <td>&nbsp;</td>
    1160. 

  1160.         <td bgcolor="#008080"><a name="OnQueryContinueDrag"><font
    1161. 

  1161.         color="#FFFFFF" size="5" face="Arial"><b>OnQueryContinueDrag</b></font></a><font
    1162. 

  1162.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    1163. 

  1163.         color="#FFFF80" size="3" face="Arial"><b><i>published</i></b></font></td>
    1164. 

  1164.     </tr>
    1165. 

  1165.     <tr>
    1166. 

  1166.         <td rowspan="2">&nbsp;</td>
    1167. 

  1167.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Is
    1168. 

  1168.         called, when the<b> </b></font><a href="#DragDropControl"><font
    1169. 

  1169.         size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    1170. 

  1170.         size="3" face="Arial"> is a source of drag&amp;drop
    1171. 

  1171.         operations. You can determine whether the drag&amp;drop
    1172. 

  1172.         operation should be continued, cancelled, or completed.
    1173. 

  1173.         You do not call this method directly. The OLE <b><i>DoDragDrop</i></b>
    1174. 

  1174.         function calls this method during a drag-and-drop
    1175. 

  1175.         operation. Mostly, you don't need this event. </font></td>
    1176. 

  1176.     </tr>
    1177. 

  1177.     <tr>
    1178. 

  1178.         <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
    1179. 

  1179.     </tr>
    1180. 

  1180. </table>
    1181. 

  1181. 

  1182. <table border="0" width="600">
    1183. 

  1183.     <tr>
    1184. 

  1184.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1185. 

  1185.         <td rowspan="2" width="590"><font size="5" face="Arial">Methods</font></td>
    1186. 

  1186.     </tr>
    1187. 

  1187.     <tr>
    1188. 

  1188.         <td>&nbsp;</td>
    1189. 

  1189.     </tr>
    1190. 

  1190. </table>
    1191. 

  1191. 

  1192. <table border="0" cellpadding="3" cellspacing="0" width="600">
    1193. 

  1193.     <tr>
    1194. 

  1194.         <td width="10">&nbsp;</td>
    1195. 

  1195.         <td bgcolor="#008080"><a name="CopyToClipboard"><font
    1196. 

  1196.         color="#FFFFFF" size="5" face="Arial"><b>CopyToClipboard</b></font></a><font
    1197. 

  1197.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    1198. 

  1198.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    1199. 

  1199.     </tr>
    1200. 

  1200.     <tr>
    1201. 

  1201.         <td rowspan="2">&nbsp;</td>
    1202. 

  1202.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
    1203. 

  1203.         this method, if you want to copy your data to the
    1204. 

  1204.         clipboard.</font></td>
    1205. 

  1205.     </tr>
    1206. 

  1206.     <tr>
    1207. 

  1207.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1208. 

  1208.     </tr>
    1209. 

  1209.     <tr>
    1210. 

  1210.         <td>&nbsp;</td>
    1211. 

  1211.         <td bgcolor="#008080"><a name="DoMenuDestroy"><font
    1212. 

  1212.         color="#FFFFFF" size="5" face="Arial"><b>DoMenuDestroy</b></font></a><font
    1213. 

  1213.         size="3" face="Arial"><b> </b></font><font
    1214. 

  1214.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1215. 

  1215.     </tr>
    1216. 

  1216.     <tr>
    1217. 

  1217.         <td>&nbsp;</td>
    1218. 

  1218.         <td bgcolor="#FFFFCC"><font face="Arial">Never call the
    1219. 

  1219.         method directly - it is called by this component itself.
    1220. 

  1220.         This method has the same purpose as the event </font><a
    1221. 

  1221.         href="#OnMenuDestroy"><font face="Arial"><em><strong>OnMenuDestroy</strong></em></font></a><font
    1222. 

  1222.         face="Arial">. You can use this method for inherited
    1223. 

  1223.         classes.</font><p><font face="Arial">Also check the
    1224. 

  1224.         section: </font><font size="3" face="Arial">&quot;</font><a
    1225. 

  1225.         href="#Details about the context-menu"><font size="3"
    1226. 

  1226.         face="Arial">Details about the context-menu</font></a><font
    1227. 

  1227.         size="3" face="Arial">&quot;.</font></p>
    1228. 

  1228.         </td>
    1229. 

  1229.     </tr>
    1230. 

  1230.     <tr>
    1231. 

  1231.         <td>&nbsp;</td>
    1232. 

  1232.         <td>&nbsp;</td>
    1233. 

  1233.     </tr>
    1234. 

  1234.     <tr>
    1235. 

  1235.         <td>&nbsp;</td>
    1236. 

  1236.         <td bgcolor="#008080"><a name="DoMenuExecCmd"><font
    1237. 

  1237.         color="#FFFFFF" size="5" face="Arial"><b>DoMenuExecCmd</b></font></a><font
    1238. 

  1238.         size="3" face="Arial"><b> </b></font><font
    1239. 

  1239.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1240. 

  1240.     </tr>
    1241. 

  1241.     <tr>
    1242. 

  1242.         <td>&nbsp;</td>
    1243. 

  1243.         <td bgcolor="#FFFFCC"><font face="Arial">Never call the
    1244. 

  1244.         method directly - it is called by this component itself.
    1245. 

  1245.         This method has the same purpose as the event </font><a
    1246. 

  1246.         href="#OnMenuExecCmd"><font face="Arial"><em><strong>OnMenuExecCmd</strong></em></font></a><font
    1247. 

  1247.         face="Arial">. You can use this method for inherited
    1248. 

  1248.         classes.</font><p><font face="Arial">Also check the
    1249. 

  1249.         section: </font><font size="3" face="Arial">&quot;</font><a
    1250. 

  1250.         href="#Details about the context-menu"><font size="3"
    1251. 

  1251.         face="Arial">Details about the context-menu</font></a><font
    1252. 

  1252.         size="3" face="Arial">&quot;.</font></p>
    1253. 

  1253.         </td>
    1254. 

  1254.     </tr>
    1255. 

  1255.     <tr>
    1256. 

  1256.         <td>&nbsp;</td>
    1257. 

  1257.         <td>&nbsp;</td>
    1258. 

  1258.     </tr>
    1259. 

  1259.     <tr>
    1260. 

  1260.         <td>&nbsp;</td>
    1261. 

  1261.         <td bgcolor="#008080"><a name="DoMenuPopup"><font
    1262. 

  1262.         color="#FFFFFF" size="5" face="Arial"><b>DoMenuPopup</b></font></a><font
    1263. 

  1263.         size="3" face="Arial"><b> </b></font><font
    1264. 

  1264.         color="#FFFF80" size="3" face="Arial"><b><i>protected</i></b></font></td>
    1265. 

  1265.     </tr>
    1266. 

  1266.     <tr>
    1267. 

  1267.         <td>&nbsp;</td>
    1268. 

  1268.         <td bgcolor="#FFFFCC"><font face="Arial">Never call the
    1269. 

  1269.         method directly - it is called by this component itself.
    1270. 

  1270.         This method has the same purpose as the event </font><a
    1271. 

  1271.         href="#OnMenuPopup"><font face="Arial"><em><strong>OnMenuPopup</strong></em></font></a><font
    1272. 

  1272.         face="Arial">. You can use this method for inherited
    1273. 

  1273.         classes.</font><p><font face="Arial">Also check the
    1274. 

  1274.         section: </font><font size="3" face="Arial">&quot;</font><a
    1275. 

  1275.         href="#Details about the context-menu"><font size="3"
    1276. 

  1276.         face="Arial">Details about the context-menu</font></a><font
    1277. 

  1277.         size="3" face="Arial">&quot;.</font></p>
    1278. 

  1278.         </td>
    1279. 

  1279.     </tr>
    1280. 

  1280.     <tr>
    1281. 

  1281.         <td>&nbsp;</td>
    1282. 

  1282.         <td>&nbsp;</td>
    1283. 

  1283.     </tr>
    1284. 

  1284.     <tr>
    1285. 

  1285.         <td>&nbsp;</td>
    1286. 

  1286.         <td bgcolor="#008080"><a name="DropHandler"><font
    1287. 

  1287.         color="#FFFFFF" size="5" face="Arial"><b>DropHandler</b></font></a><font
    1288. 

  1288.         size="3" face="Arial"><b> </b></font><font
    1289. 

  1289.         color="#FFFF80" size="3" face="Arial"><b><i>protected </i></b></font></td>
    1290. 

  1290.     </tr>
    1291. 

  1291.     <tr>
    1292. 

  1292.         <td>&nbsp;</td>
    1293. 

  1293.         <td bgcolor="#FFFFCC"><font face="Arial">Never call the
    1294. 

  1294.         method directly - it is called by this component itself.
    1295. 

  1295.         Inherit this method for implementing custom
    1296. 

  1296.         drop-handlers.</font><p><font face="Arial">Also check the
    1297. 

  1297.         section: </font><font size="3" face="Arial">&quot;</font><a
    1298. 

  1298.         href="#Details about the DropHandler"><font size="3"
    1299. 

  1299.         face="Arial">Details about the DropHandler</font></a><font
    1300. 

  1300.         size="3" face="Arial">&quot;.</font></p>
    1301. 

  1301.         </td>
    1302. 

  1302.     </tr>
    1303. 

  1303.     <tr>
    1304. 

  1304.         <td>&nbsp;</td>
    1305. 

  1305.         <td>&nbsp;</td>
    1306. 

  1306.     </tr>
    1307. 

  1307.     <tr>
    1308. 

  1308.         <td>&nbsp;</td>
    1309. 

  1309.         <td bgcolor="#008080"><a name="Execute"><font
    1310. 

  1310.         color="#FFFFFF" size="5" face="Arial"><b>Execute</b></font></a><font
    1311. 

  1311.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    1312. 

  1312.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    1313. 

  1313.     </tr>
    1314. 

  1314.     <tr>
    1315. 

  1315.         <td rowspan="2">&nbsp;</td>
    1316. 

  1316.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
    1317. 

  1317.         this method, if you detect that the user wants to start a
    1318. 

  1318.         drag&amp;drop operation (e.g. MouseDown). Before calling,
    1319. 

  1319.         you have to create a valid IDataObject (for more
    1320. 

  1320.         informations, look over the source of the components
    1321. 

  1321.         &quot;TDragDropFiles&quot; or
    1322. 

  1322.         &quot;TDragDropFiles&quot;).</font> <p><font
    1323. 

  1323.         color="#FF0000" size="3" face="Arial"><strong>IMPORTANT:</strong></font><font
    1324. 

  1324.         size="3" face="Arial"> If you use the drag-detection,
    1325. 

  1325.         it's high recommended to check the section &quot;</font><a
    1326. 

  1326.         href="#DragDetectionProblem"><font size="3" face="Arial">Problems
    1327. 

  1327.         With The Drag-Detection</font></a><font size="3"
    1328. 

  1328.         face="Arial">&quot;.</font></p>
    1329. 

  1329.         </td>
    1330. 

  1330.     </tr>
    1331. 

  1331.     <tr>
    1332. 

  1332.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1333. 

  1333.     </tr>
    1334. 

  1334.     <tr>
    1335. 

  1335.         <td>&nbsp;</td>
    1336. 

  1336.         <td bgcolor="#008080"><a name="ExecuteOperation"><font
    1337. 

  1337.         color="#FFFFFF" size="5" face="Arial"><b>ExecuteOperation</b></font></a><font
    1338. 

  1338.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    1339. 

  1339.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    1340. 

  1340.     </tr>
    1341. 

  1341.     <tr>
    1342. 

  1342.         <td rowspan="2">&nbsp;</td>
    1343. 

  1343.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    1344. 

  1344.         method is called by<b> </b><b><i>Execute</i></b>.
    1345. 

  1345.         Normally, you don't call this method directly.</font></td>
    1346. 

  1346.     </tr>
    1347. 

  1347.     <tr>
    1348. 

  1348.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1349. 

  1349.     </tr>
    1350. 

  1350.     <tr>
    1351. 

  1351.         <td>&nbsp;</td>
    1352. 

  1352.         <td bgcolor="#008080"><a name="ExecuteOperation"><font
    1353. 

  1353.         color="#FFFFFF" size="5" face="Arial"><b>GetFromClipboard</b></font></a><font
    1354. 

  1354.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    1355. 

  1355.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    1356. 

  1356.     </tr>
    1357. 

  1357.     <tr>
    1358. 

  1358.         <td rowspan="2">&nbsp;</td>
    1359. 

  1359.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
    1360. 

  1360.         this method, if you want to get data from the clipboard.
    1361. 

  1361.         This will only succeed, if the data formats are
    1362. 

  1362.         supported.</font></td>
    1363. 

  1363.     </tr>
    1364. 

  1364.     <tr>
    1365. 

  1365.         <td bgcolor="#FFFFEF">&nbsp;</td>
    1366. 

  1366.     </tr>
    1367. 

  1367.     <tr>
    1368. 

  1368.         <td>&nbsp;</td>
    1369. 

  1369.         <td bgcolor="#008080"><a name="StartDnDDetection"><font
    1370. 

  1370.         color="#FFFFFF" size="5" face="Arial"><b>StartDnDDetection</b></font></a><font
    1371. 

  1371.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    1372. 

  1372.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    1373. 

  1373.     </tr>
    1374. 

  1374.     <tr>
    1375. 

  1375.         <td rowspan="2">&nbsp;</td>
    1376. 

  1376.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
    1377. 

  1377.         this method, if you want to start the drag detection
    1378. 

  1378.         manually. Normally, you call this method in the
    1379. 

  1379.         OnMouseDown event.</font></td>
    1380. 

  1380.     </tr>
    1381. 

  1381.     <tr>
    1382. 

  1382.         <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
    1383. 

  1383.     </tr>
    1384. 

  1384. </table>
    1385. 

  1385. 

  1386. <table border="0" width="600">
    1387. 

  1387.     <tr>
    1388. 

  1388.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1389. 

  1389.         <td rowspan="2" width="590"><font size="5" face="Arial">Constants</font></td>
    1390. 

  1390.     </tr>
    1391. 

  1391.     <tr>
    1392. 

  1392.         <td>&nbsp;</td>
    1393. 

  1393.     </tr>
    1394. 

  1394. </table>
    1395. 

  1395. 

  1396. <table border="0" cellpadding="3" cellspacing="0" width="600">
    1397. 

  1397.     <tr>
    1398. 

  1398.         <td width="14">&nbsp;</td>
    1399. 

  1399.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    1400. 

  1400.         face="Arial"><b>DROPEFFECT_NONE, DROPEFFECT_COPY,
    1401. 

  1401.         DROPEFFECT_MOVE, DROPEFFECT_LINK, DROPEFFECT_SCROLL</b></font></td>
    1402. 

  1402.     </tr>
    1403. 

  1403.     <tr>
    1404. 

  1404.         <td rowspan="2">&nbsp;</td>
    1405. 

  1405.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">These
    1406. 

  1406.         constants describe the kind of drop effect the user want
    1407. 

  1407.         to have. These values are used by the parameter<b> </b><b><i>dwEffect</i></b>
    1408. 

  1408.         of methods. <b><i>DROPEFFECT_SCROLL</i></b> indicates a
    1409. 

  1409.         scrolling context of the drop target. </font></td>
    1410. 

  1410.     </tr>
    1411. 

  1411.     <tr>
    1412. 

  1412.         <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
    1413. 

  1413.     </tr>
    1414. 

  1414. </table>
    1415. 

  1415. 

  1416. <table border="0" width="600">
    1417. 

  1417.     <tr>
    1418. 

  1418.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1419. 

  1419.         <td rowspan="2" colspan="2" width="590"><font size="5"
    1420. 

  1420.         face="Arial">How Do I Use It As Drag&amp;Drop Source</font></td>
    1421. 

  1421.     </tr>
    1422. 

  1422.     <tr>
    1423. 

  1423.         <td>&nbsp;</td>
    1424. 

  1424.     </tr>
    1425. 

  1425.     <tr>
    1426. 

  1426.         <td>&nbsp;</td>
    1427. 

  1427.         <td valign="top"><font face="Arial">1.</font></td>
    1428. 

  1428.         <td><font face="Arial">Drop a TWinControl on the form
    1429. 

  1429.         (e.g. a listbox). </font></td>
    1430. 

  1430.     </tr>
    1431. 

  1431.     <tr>
    1432. 

  1432.         <td>&nbsp;</td>
    1433. 

  1433.         <td valign="top"><font face="Arial">2.</font></td>
    1434. 

  1434.         <td><font face="Arial">Choose the TWinControl (listbox)
    1435. 

  1435.         in </font><a href="#DragDropControl"><font face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
    1436. 

  1436.         face="Arial">.</font></td>
    1437. 

  1437.     </tr>
    1438. 

  1438.     <tr>
    1439. 

  1439.         <td>&nbsp;</td>
    1440. 

  1440.         <td valign="top"><font face="Arial">3. </font></td>
    1441. 

  1441.         <td><font face="Arial">Choose the drag&amp;drop effects
    1442. 

  1442.         under </font><a href="#SourceEffects"><font face="Arial"><em><strong>SourceEffects</strong></em></font></a><font
    1443. 

  1443.         face="Arial"> that the <em><strong>DragDropControl </strong></em>(listbox)
    1444. 

  1444.         should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
    1445. 

  1445.         serve as drag&amp;drop source all items must be set to
    1446. 

  1446.         false.</font></td>
    1447. 

  1447.     </tr>
    1448. 

  1448.     <tr>
    1449. 

  1449.         <td>&nbsp;</td>
    1450. 

  1450.         <td valign="top"><font face="Arial">4.</font></td>
    1451. 

  1451.         <td><font face="Arial">Now, your <em><strong>DragDropControl</strong></em>
    1452. 

  1452.         (listbox) must detect, if the user wants to start a
    1453. 

  1453.         drag&amp;drop operation. You can use the event
    1454. 

  1454.         &quot;OnMouseDown&quot; of your <em><strong>DragDropControl</strong></em>
    1455. 

  1455.         (listbox). </font><font size="3" face="Arial">You must
    1456. 

  1456.         create a DataObject. If you have no idea, how to do that,
    1457. 

  1457.         look over the source of the component <em><strong>TDragDropFiles</strong></em>
    1458. 

  1458.         or <em><strong>TDragDropText</strong></em>.</font></td>
    1459. 

  1459.     </tr>
    1460. 

  1460.     <tr>
    1461. 

  1461.         <td>&nbsp;</td>
    1462. 

  1462.         <td valign="top"><font face="Arial">5.</font></td>
    1463. 

  1463.         <td valign="top"><font face="Arial">Tell Windows that
    1464. 

  1464.         there is a drag&amp;drop operation to handle: J</font><font
    1465. 

  1465.         size="3" face="Arial">ust call the method </font><a
    1466. 

  1466.         href="#ExecuteOperation"><font size="3" face="Arial"><b><i>ExecuteOperation</i></b></font></a><font
    1467. 

  1467.         size="3" face="Arial"> of this component (for
    1468. 

  1468.         child-classes: call </font><a href="#Execute"><font
    1469. 

  1469.         size="3" face="Arial"><b><i>Execute</i></b></font></a><font
    1470. 

  1470.         size="3" face="Arial">). Now, windows handles the
    1471. 

  1471.         drag&amp;drop operation.</font></td>
    1472. 

  1472.     </tr>
    1473. 

  1473.     <tr>
    1474. 

  1474.         <td valign="top">&nbsp;</td>
    1475. 

  1475.         <td valign="top"><font face="Arial">6.</font></td>
    1476. 

  1476.         <td valign="top"><font size="3" face="Arial">You may use
    1477. 

  1477.         the events </font><a href="#OnGiveFeedback"><font
    1478. 

  1478.         size="3" face="Arial"><b><i>OnGiveFeedback</i></b></font></a><font
    1479. 

  1479.         size="3" face="Arial"> and </font><a
    1480. 

  1480.         href="#OnQueryContinueDrag"><font size="3" face="Arial"><b><i>OnQueryContinueDrag</i></b></font></a><font
    1481. 

  1481.         size="3" face="Arial">, but often you need not.</font></td>
    1482. 

  1482.     </tr>
    1483. 

  1483.     <tr>
    1484. 

  1484.         <td valign="top">&nbsp;</td>
    1485. 

  1485.         <td valign="top">&nbsp;</td>
    1486. 

  1486.         <td valign="top">&nbsp;</td>
    1487. 

  1487.     </tr>
    1488. 

  1488.     <tr>
    1489. 

  1489.         <td valign="top">&nbsp;</td>
    1490. 

  1490.         <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
    1491. 

  1491.     </tr>
    1492. 

  1492.     <tr>
    1493. 

  1493.         <td valign="top">&nbsp;</td>
    1494. 

  1494.         <td valign="top" colspan="2"><ul>
    1495. 

  1495.             <li><font size="3" face="Arial">Drag&amp;drop
    1496. 

  1496.                 operations cannot be done at design-time!</font></li>
    1497. 

  1497.             <li><font size="3" face="Arial">If you use the
    1498. 

  1498.                 drag-detection, it's high recommended to check
    1499. 

  1499.                 the section &quot;</font><a
    1500. 

  1500.                 href="#DragDetectionProblem"><font size="3"
    1501. 

  1501.                 face="Arial">Problems With The Drag-Detection</font></a><font
    1502. 

  1502.                 size="3" face="Arial">&quot;.</font></li>
    1503. 

  1503.         </ul>
    1504. 

  1504.         </td>
    1505. 

  1505.     </tr>
    1506. 

  1506.     <tr>
    1507. 

  1507.         <td height="50">&nbsp;</td>
    1508. 

  1508.         <td colspan="2">&nbsp;</td>
    1509. 

  1509.     </tr>
    1510. 

  1510. </table>
    1511. 

  1511. 

  1512. <table border="0" width="600">
    1513. 

  1513.     <tr>
    1514. 

  1514.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1515. 

  1515.         <td rowspan="2" colspan="2" width="590"><font size="5"
    1516. 

  1516.         face="Arial">How Do I Use It As Drag&amp;Drop Target</font></td>
    1517. 

  1517.     </tr>
    1518. 

  1518.     <tr>
    1519. 

  1519.         <td>&nbsp;</td>
    1520. 

  1520.     </tr>
    1521. 

  1521.     <tr>
    1522. 

  1522.         <td>&nbsp;</td>
    1523. 

  1523.         <td valign="top"><font face="Arial">1.</font></td>
    1524. 

  1524.         <td><font face="Arial">Drop a TWinControl on the form
    1525. 

  1525.         (e.g. a listbox). </font></td>
    1526. 

  1526.     </tr>
    1527. 

  1527.     <tr>
    1528. 

  1528.         <td>&nbsp;</td>
    1529. 

  1529.         <td valign="top"><font face="Arial">2.</font></td>
    1530. 

  1530.         <td><font face="Arial">Choose the TWinControl (listbox)
    1531. 

  1531.         in </font><a href="#DragDropControl"><font face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
    1532. 

  1532.         face="Arial">.</font></td>
    1533. 

  1533.     </tr>
    1534. 

  1534.     <tr>
    1535. 

  1535.         <td>&nbsp;</td>
    1536. 

  1536.         <td valign="top"><font face="Arial">3. </font></td>
    1537. 

  1537.         <td><font face="Arial">Choose the drag&amp;drop effects
    1538. 

  1538.         under </font><a href="#TargetEffects"><font face="Arial"><em><strong>TargetEffects</strong></em></font></a><font
    1539. 

  1539.         face="Arial"> that the <em><strong>DragDropControl </strong></em>(listbox)
    1540. 

  1540.         should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
    1541. 

  1541.         serve as drag&amp;drop target all items must be set to
    1542. 

  1542.         false.</font></td>
    1543. 

  1543.     </tr>
    1544. 

  1544.     <tr>
    1545. 

  1545.         <td>&nbsp;</td>
    1546. 

  1546.         <td valign="top"><font face="Arial">4.</font></td>
    1547. 

  1547.         <td><font size="3" face="Arial">Now, you have to program
    1548. 

  1548.         what happen, when the user drops a bitmap on your </font><a
    1549. 

  1549.         href="#DragDropControl"><font size="3" face="Arial"><b><i>DragDropControl</i></b></font></a><font
    1550. 

  1550.         size="3" face="Arial"> (listbox). For this, the best is
    1551. 

  1551.         to use the event </font><a href="#OnDrop"><font size="3"
    1552. 

  1552.         face="Arial"><b><i>OnDrop</i></b></font></a><font
    1553. 

  1553.         size="3" face="Arial"> (or </font><a
    1554. 

  1554.         href="#OnProcessDropped"><font size="3" face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    1555. 

  1555.         size="3" face="Arial"> in the child-class; but only
    1556. 

  1556.         there!). At first, you should check what drag&amp;drop
    1557. 

  1557.         effect was chosen by the user. You get the effect from
    1558. 

  1558.         method's parameter <b><i>dwEffect</i></b>. </font></td>
    1559. 

  1559.     </tr>
    1560. 

  1560.     <tr>
    1561. 

  1561.         <td>&nbsp;</td>
    1562. 

  1562.         <td valign="top"><font face="Arial">5.</font></td>
    1563. 

  1563.         <td valign="top"><font size="3" face="Arial">You may use
    1564. 

  1564.         the events </font><a href="#OnDragEnter"><font size="3"
    1565. 

  1565.         face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    1566. 

  1566.         size="3" face="Arial">, </font><a href="#OnDragOver"><font
    1567. 

  1567.         size="3" face="Arial"><b><i>OnDragOver</i></b></font></a><font
    1568. 

  1568.         size="3" face="Arial"> and </font><a href="#OnDragLeave"><font
    1569. 

  1569.         size="3" face="Arial"><b><i>OnDragLeave</i></b></font></a><font
    1570. 

  1570.         size="3" face="Arial">, but often you need not.</font></td>
    1571. 

  1571.     </tr>
    1572. 

  1572.     <tr>
    1573. 

  1573.         <td valign="top">&nbsp;</td>
    1574. 

  1574.         <td valign="top">&nbsp;</td>
    1575. 

  1575.         <td valign="top">&nbsp;</td>
    1576. 

  1576.     </tr>
    1577. 

  1577.     <tr>
    1578. 

  1578.         <td valign="top">&nbsp;</td>
    1579. 

  1579.         <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
    1580. 

  1580.     </tr>
    1581. 

  1581.     <tr>
    1582. 

  1582.         <td valign="top">&nbsp;</td>
    1583. 

  1583.         <td valign="top" colspan="2"><ul>
    1584. 

  1584.             <li><font size="3" face="Arial">Drag&amp;drop
    1585. 

  1585.                 operations cannot be done at design-time!</font></li>
    1586. 

  1586.         </ul>
    1587. 

  1587.         </td>
    1588. 

  1588.     </tr>
    1589. 

  1589.     <tr>
    1590. 

  1590.         <td height="50">&nbsp;</td>
    1591. 

  1591.         <td colspan="2">&nbsp;</td>
    1592. 

  1592.     </tr>
    1593. 

  1593. </table>
    1594. 

  1594. 

  1595. <table border="0" width="600">
    1596. 

  1596.     <tr>
    1597. 

  1597.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1598. 

  1598.         <td rowspan="2" width="590"><font size="5" face="Arial">Some
    1599. 

  1599.         Important Hints</font></td>
    1600. 

  1600.     </tr>
    1601. 

  1601.     <tr>
    1602. 

  1602.         <td>&nbsp;</td>
    1603. 

  1603.     </tr>
    1604. 

  1604.     <tr>
    1605. 

  1605.         <td>&nbsp;</td>
    1606. 

  1606.         <td><ul>
    1607. 

  1607.             <li><font size="3" face="Arial">Normally, you don't
    1608. 

  1608.                 use this component for drag&amp;drop. It's better
    1609. 

  1609.                 and mostly simpler to implement a child-class
    1610. 

  1610.                 like <em><strong>TDragDropFiles</strong></em> or <em><strong>TDragDropText</strong></em>.
    1611. 

  1611.                 You can design your own
    1612. 

  1612.                 drag&amp;drop/clipboard-formats, but for such
    1613. 

  1613.                 special formats and other formats, I don't
    1614. 

  1614.                 support, you must write an own child-class. But I
    1615. 

  1615.                 think, it shouldn't be so difficult with these
    1616. 

  1616.                 parent-classes, I offer you here.<br>
    1617. 

  1617.                 </font></li>
    1618. 

  1618.             <li><font size="3" face="Arial">Don't start threads
    1619. 

  1619.                 in </font><a href="#OnDrop"><font size="3"
    1620. 

  1620.                 face="Arial"><b><i>OnDrop</i></b></font></a><font
    1621. 

  1621.                 size="3" face="Arial">, because this may causes
    1622. 

  1622.                 access violations. Mostly, you don't need a
    1623. 

  1623.                 thread - you can use </font><a
    1624. 

  1624.                 href="#OnProcessDropped"><font size="3"
    1625. 

  1625.                 face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    1626. 

  1626.                 size="3" face="Arial">.<br>
    1627. 

  1627.                 </font></li>
    1628. 

  1628.             <li><font size="3" face="Arial">Don't try to start
    1629. 

  1629.                 OLE drag&amp;drop and Delphi internal's
    1630. 

  1630.                 drag&amp;drop at same time - it doesn't work. If
    1631. 

  1631.                 you want to drop additional data, you've to build
    1632. 

  1632.                 a own clipboard-format (RegisterClipboardFormat)
    1633. 

  1633.                 and new child-class. Sorry, I don't know an
    1634. 

  1634.                 easier way. <br>
    1635. 

  1635.                 </font></li>
    1636. 

  1636.             <li><font size="3" face="Arial">If you do drag data
    1637. 

  1637.                 with the right mouse-button, you may get at some
    1638. 

  1638.                 TWinControls a context popup-menu (e.g. TMemo).
    1639. 

  1639.                 To avoid popping up the menu, define a own empty
    1640. 

  1640.                 menu and set its property &quot;AutoPopup&quot;
    1641. 

  1641.                 to false. Use the event </font><a
    1642. 

  1642.                 href="#OnDragDetect"><font size="3" face="Arial"><b><i>OnDragDetect</i></b></font></a><font
    1643. 

  1643.                 size="3" face="Arial"> to determine, when set the
    1644. 

  1644.                 TWinControl's property to the empty popup-menu or
    1645. 

  1645.                 nil. Here an exsample for TMemo:</font> </li>
    1646. 

  1646.         </ul>
    1647. 

  1647.         <blockquote>
    1648. 

  1648.             <p><font size="3" face="Arial"><code><strong>procedure
    1649. 

  1649.             </strong></code><code>TForm1.DragDropFilesEx1DragDetect(grfKeyState:
    1650. 

  1650.             Longint; x,y: Integer; DragStatus:
    1651. 

  1651.             TDragDetectStatus);</code><code><strong><br>
    1652. 

  1652.             begin</strong></code></font></p>
    1653. 

  1653.             <blockquote>
    1654. 

  1654.                 <p><font size="3" face="Arial"><code><strong>if (</strong></code><code>DragStatus=ddsCancelled)
    1655. 

  1655.                 </code><code><strong>or</strong></code><code>
    1656. 

  1656.                 (DragStatus=ddsDrag) </code><code><strong>then </strong></code><code>Memo1.PopupMenu:=PopupMenu1;</code><code><strong><br>
    1657. 

  1657.                 if </strong></code><code>DragStatus</code><code><strong>=</strong></code><code>ddsNone</code><code><strong>
    1658. 

  1658.                 then </strong></code><code>Memo1.PopupMenu:=</code><code><strong>nil</strong></code><code>;</code><code><strong><br>
    1659. 

  1659.                 if </strong></code><code>DragStatus=ddsDrag</code><code><strong>
    1660. 

  1660.                 then<br>
    1661. 

  1661.                 begin </strong></code></font></p>
    1662. 

  1662.             </blockquote>
    1663. 

  1663.         </blockquote>
    1664. 

  1664.         <blockquote>
    1665. 

  1665.             <blockquote>
    1666. 

  1666.                 <blockquote>
    1667. 

  1667.                     <p><font color="#000080" size="3"
    1668. 

  1668.                     face="Arial"><code><em><strong>// Prepare for
    1669. 

  1669.                     dragging<br>
    1670. 

  1670.                     // ...<br>
    1671. 

  1671.                     // An example for the child-class <br>
    1672. 

  1672.                     // DragDropText:</strong></em></code></font><font
    1673. 

  1673.                     size="3" face="Arial"><code><strong><br>
    1674. 

  1674.                     if </strong></code><code>Memo1.Lines.Count=0</code><code><strong>
    1675. 

  1675.                     then exit</strong></code><code>;</code><code><strong><br>
    1676. 

  1676.                     </strong></code><code>DragDropText1.Lines.Assign(Memo1.Lines);<br>
    1677. 

  1677.                     DragDropText1.Execute; </code></font></p>
    1678. 

  1678.                 </blockquote>
    1679. 

  1679.             </blockquote>
    1680. 

  1680.         </blockquote>
    1681. 

  1681.         <blockquote>
    1682. 

  1682.             <blockquote>
    1683. 

  1683.                 <p><font size="3" face="Arial"><code><strong>end</strong></code><code>;</code><code><strong>
    1684. 

  1684.                 </strong></code></font></p>
    1685. 

  1685.             </blockquote>
    1686. 

  1686.         </blockquote>
    1687. 

  1687.         <blockquote>
    1688. 

  1688.             <p><font size="3" face="Arial"><code><strong>end</strong></code><code>;</code><code><strong>
    1689. 

  1689.             </strong></code></font></p>
    1690. 

  1690.         </blockquote>
    1691. 

  1691.         </td>
    1692. 

  1692.     </tr>
    1693. 

  1693.     <tr>
    1694. 

  1694.         <td height="50">&nbsp;</td>
    1695. 

  1695.         <td>&nbsp;</td>
    1696. 

  1696.     </tr>
    1697. 

  1697. </table>
    1698. 

  1698. 

  1699. <table border="0" width="600">
    1700. 

  1700.     <tr>
    1701. 

  1701.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1702. 

  1702.         <td rowspan="2" colspan="2" width="590"><font size="5"
    1703. 

  1703.         face="Arial">How To Build An Own Child-Class</font></td>
    1704. 

  1704.     </tr>
    1705. 

  1705.     <tr>
    1706. 

  1706.         <td>&nbsp;</td>
    1707. 

  1707.     </tr>
    1708. 

  1708.     <tr>
    1709. 

  1709.         <td>&nbsp;</td>
    1710. 

  1710.         <td colspan="2"><font size="3" face="Arial">Before you
    1711. 

  1711.         build your own child-class, it's very useful to
    1712. 

  1712.         understand the mechanism of drag&amp;drop. <p><font size="3"
    1713. 

  1713.         face="Arial">Use my &quot;Drag&amp;Drop-Analyser&quot;
    1714. 

  1714.         for testing &amp; analysing the dropped data. You can use
    1715. 

  1715.         it as target of drag&amp;drop operations. It gives
    1716. 

  1716.         informations about the dropped data.</font></p>
    1717. 

  1717.         <p><font size="3" face="Arial">You have not to do much,
    1718. 

  1718.         if you build a child-class like <em><strong>TDragDropFiles</strong></em>
    1719. 

  1719.         or <em><strong>TDragDropText</strong></em>. You must only
    1720. 

  1720.         build a child-class from <b><i>TEnumFormatEtc</i></b>, <b><i>TDataObject</i></b>
    1721. 

  1721.         and <b><i>TDragDrop</i></b>. and override the following
    1722. 

  1722.         methods, the rest of the work, I've already done:</font> </p>
    1723. 

  1723.         <blockquote>
    1724. 

  1724.             <p><font size="3" face="Arial"><b><i>TDataObject:<br>
    1725. 

  1725.             </i></b><code><b>function</b></code><code>
    1726. 

  1726.             RenderData(var FormatEtc:TFormatEtc; var StgMedium:
    1727. 

  1727.             TStgMedium):HResult; </code></font></p>
    1728. 

  1728.             <p><font size="3" face="Arial"><b><i>TDropTarget:</i></b><code><b><br>
    1729. 

  1729.             procedure</b></code><code> AccepTDataObject(DataObj:
    1730. 

  1730.             IDataObject; grfKeyState: Longint; pt: TPoint; var
    1731. 

  1731.             dwEffect: longint; var Accept:boolean);</code><code><b><br>
    1732. 

  1732.             procedure</b></code><code> RenderDropped(DataObj:
    1733. 

  1733.             IDataObject; grfKeyState: Longint; pt: TPoint; var
    1734. 

  1734.             dwEffect: longint); </code></font></p>
    1735. 

  1735.             <p><font size="3" face="Arial"><b><i>TDragDrop:</i></b><code><b><br>
    1736. 

  1736.             function</b></code><code>
    1737. 

  1737.             CreateDataObject:TDataObject;</code></font></p>
    1738. 

  1738.         </blockquote>
    1739. 

  1739.         </td>
    1740. 

  1740.     </tr>
    1741. 

  1741.     <tr>
    1742. 

  1742.         <td height="50">&nbsp;</td>
    1743. 

  1743.         <td colspan="2">&nbsp;</td>
    1744. 

  1744.     </tr>
    1745. 

  1745. </table>
    1746. 

  1746. 

  1747. <table border="0" width="600">
    1748. 

  1748.     <tr>
    1749. 

  1749.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    1750. 

  1750.         <td rowspan="2"><a name="Details about the context-menu"><font
    1751. 

  1751.         size="5" face="Arial">Details about the <strong>context-menu</strong></font></a></td>
    1752. 

  1752.     </tr>
    1753. 

  1753.     <tr>
    1754. 

  1754.         <td>&nbsp;</td>
    1755. 

  1755.     </tr>
    1756. 

  1756.     <tr>
    1757. 

  1757.         <td>&nbsp;</td>
    1758. 

  1758.         <td><font size="3" face="Arial">With the context-menu are
    1759. 

  1759.         following properties, events and methods involved: </font><a
    1760. 

  1760.         href="#TargetPopUpMenu"><font size="3" face="Arial"><em><strong>TargetPopUpMenu</strong></em></font></a><font
    1761. 

  1761.         size="3" face="Arial">, </font><a href="#OnMenuDestroy"><font
    1762. 

  1762.         size="3" face="Arial"><em><strong>OnMenuDestroy</strong></em></font></a><font
    1763. 

  1763.         size="3" face="Arial">, </font><a href="#OnMenuExecCmd"><font
    1764. 

  1764.         size="3" face="Arial"><em><strong>OnMenuExecCmd</strong></em></font></a><font
    1765. 

  1765.         size="3" face="Arial">, </font><a href="#OnMenuPopup"><font
    1766. 

  1766.         size="3" face="Arial"><em><strong>OnMenuPopup</strong></em></font></a><font
    1767. 

  1767.         size="3" face="Arial">, </font><a href="#OnMenuSucceeded"><font
    1768. 

  1768.         size="3" face="Arial"><em><strong>OnMenuSucceeded</strong></em></font></a><font
    1769. 

  1769.         size="3" face="Arial">, </font><a href="#DoMenuDestroy"><font
    1770. 

  1770.         size="3" face="Arial"><em><strong>DoMenuDestroy</strong></em></font></a><font
    1771. 

  1771.         size="3" face="Arial">, </font><a href="#DoMenuExecCmd"><font
    1772. 

  1772.         size="3" face="Arial"><em><strong>DoMenuExecCmd</strong></em></font></a><font
    1773. 

  1773.         size="3" face="Arial"> and </font><a href="#DoMenuPopup"><font
    1774. 

  1774.         size="3" face="Arial"><em><strong>DoMenuPopup</strong></em></font></a><font
    1775. 

  1775.         size="3" face="Arial">. The context-menu does only
    1776. 

  1776.         appear, if </font><a href="#TargetPopUpMenu"><font
    1777. 

  1777.         size="3" face="Arial"><em><strong>TargetPopUpMenu</strong></em></font></a><font
    1778. 

  1778.         size="3" face="Arial"> is set to true and the data is
    1779. 

  1779.         dragged with the right mousebutton. Override the methods
    1780. 

  1780.         (<em><strong>DoXXXXXXX</strong></em> ), if you write a
    1781. 

  1781.         custom component based on <em><strong>TDragDrop</strong></em>
    1782. 

  1782.         otherwise use the events (<em><strong>OnXXXXXXX</strong></em>).</font><p><font
    1783. 

  1783.         size="3" face="Arial">The order of the called
    1784. 

  1784.         methods/events after a drop is as following: First, <em><strong>xxMenuPopup</strong></em>
    1785. 

  1785.         (the &quot;<em><strong>xx</strong></em>&quot; stand for
    1786. 

  1786.         &quot;<em><strong>Do</strong></em>&quot; and &quot;<em><strong>On</strong></em>&quot;)
    1787. 

  1787.         is called. You implement in <em><strong>xxMenuPopup</strong></em>
    1788. 

  1788.         your custom menuitems. Here is an example:</font></p>
    1789. 

  1789.         <blockquote>
    1790. 

  1790.             <p><font face="Arial"><code><strong>var</strong></code><code>
    1791. 

  1791.             MinCustCmd:integer;</code></font></p>
    1792. 

  1792.             <p><font face="Arial"><code><strong>procedure</strong></code><code>
    1793. 

  1793.             TForm1.DragDropFilesEx1MenuPopup(Sender: TObject;
    1794. 

  1794.             AMenu: HMENU; DataObj: IDataObject; AMinCustCmd,
    1795. 

  1795.             grfKeyState: Integer; pt: TPoint);<br>
    1796. 

  1796.             </code><code><strong>var</strong></code><code>
    1797. 

  1797.             lpmii:TMenuItemInfo;<br>
    1798. 

  1798.             </code><code><strong>begin</strong></code></font></p>
    1799. 

  1799.             <blockquote>
    1800. 

  1800.                 <p><font face="Arial"><code>MinCustCmd:=AMinCustCmd;
    1801. 

  1801.                 </code></font><font color="#000080" face="Arial"><code><em><strong>//
    1802. 

  1802.                 we need this value later, so the variable must be
    1803. 

  1803.                 global</strong></em></code></font><font
    1804. 

  1804.                 face="Arial"><code><br>
    1805. 

  1805.                 fillchar(lpmii,sizeof(lpmii),0);<br>
    1806. 

  1806.                 lpmii.cbSize:=sizeof(lpmii);<br>
    1807. 

  1807.                 lpmii.fMask:=MIIM_TYPE </code><code><strong>or</strong></code><code>
    1808. 

  1808.                 MIIM_ID;<br>
    1809. 

  1809.                 lpmii.wID:=AMinCustCmd;<br>
    1810. 

  1810.                 lpmii.fType:=MFT_STRING;<br>
    1811. 

  1811.                 lpmii.dwTypeData:=</code></font><font
    1812. 

  1812.                 color="#0000FF" face="Arial"><code>'</code></font><font
    1813. 

  1813.                 color="#0000A0" face="Arial"><code>&amp;test
    1814. 

  1814.                 item'</code></font><font face="Arial"><code>;<br>
    1815. 

  1815.                 lpmii.cch:=length(</code></font><font
    1816. 

  1816.                 color="#0000A0" face="Arial"><code>'&amp;test
    1817. 

  1817.                 item'</code></font><font face="Arial"><code>);<br>
    1818. 

  1818.                 MinCustCmd:=AMinCustCmd;<br>
    1819. 

  1819.                 InsertMenuItem(AMenu,0,true,lpmii);</code></font></p>
    1820. 

  1820.             </blockquote>
    1821. 

  1821.             <p><font face="Arial"><code><strong>end</strong></code><code>;</code></font></p>
    1822. 

  1822.         </blockquote>
    1823. 

  1823.         <p><font size="3" face="Arial">If you override the method
    1824. 

  1824.         <em><strong>DoMenuPopup</strong></em>, you also must
    1825. 

  1825.         call:</font></p>
    1826. 

  1826.         <blockquote>
    1827. 

  1827.             <p><font size="3" face="Arial"><code><strong>inherited</strong></code><code>
    1828. 

  1828.             DoMenuPopup(Sender, AMenu, DataObj, AMinCustCmd,
    1829. 

  1829.             grfKeyState, pt);</code></font></p>
    1830. 

  1830.         </blockquote>
    1831. 

  1831.         <p><font size="3" face="Arial">You find more information
    1832. 

  1832.         on adding items to a popup-menu in the Win32-help. Look
    1833. 

  1833.         for &quot;InsertMenuItem&quot;. If you add more items,
    1834. 

  1834.         you must increase AMinCustCmd for every new item, to
    1835. 

  1835.         identify the items later! Of course, you must remember
    1836. 

  1836.         the ID to all items or you don't know, which item was
    1837. 

  1837.         selected!</font></p>
    1838. 

  1838.         <p><font size="3" face="Arial"><em><strong>xxMenuExecCmd</strong></em>
    1839. 

  1839.         is only called, if it was detected, that one of your
    1840. 

  1840.         custom menuitems was selected. Now, you have to executed
    1841. 

  1841.         the routines etc, which are linked with the selected
    1842. 

  1842.         menuitem. Here the continue of the example:</font></p>
    1843. 

  1843.         <blockquote>
    1844. 

  1844.             <p><font size="3" face="Arial"><code><strong>procedure</strong></code><code>
    1845. 

  1845.             TForm1.DragDropFilesEx1MenuExecCmd(Sender: TObject;
    1846. 

  1846.             AMenu: HMENU;DataObj: IDataObject; Command: Integer;
    1847. 

  1847.             var dwEffect: Integer; </code><code><strong>var</strong></code><code>
    1848. 

  1848.             Succeeded: Boolean);<br>
    1849. 

  1849.             </code><code><strong>begin</strong></code></font></p>
    1850. 

  1850.             <blockquote>
    1851. 

  1851.                 <p><font size="3" face="Arial"><code>Succeeded:=Command=MinCustCmd;<br>
    1852. 

  1852.                 </code><code><strong>if</strong></code><code>
    1853. 

  1853.                 Succeeded </code><code><strong>then</strong></code><code>
    1854. 

  1854.                 ShowMessage(</code></font><font color="#0000A0"
    1855. 

  1855.                 size="3" face="Arial"><code>'The test item was
    1856. 

  1856.                 selected!'</code></font><font size="3"
    1857. 

  1857.                 face="Arial"><code>);</code></font></p>
    1858. 

  1858.             </blockquote>
    1859. 

  1859.             <p><font size="3" face="Arial"><code><strong>end</strong></code><code>;</code></font></p>
    1860. 

  1860.         </blockquote>
    1861. 

  1861.         <p><font size="3" face="Arial">Don't forget to set the
    1862. 

  1862.         parameter <strong>Succeeded</strong>. Set only the value
    1863. 

  1863.         to true </font><font color="#FF0000" size="3"
    1864. 

  1864.         face="Arial"><strong>after</strong></font><font size="3"
    1865. 

  1865.         face="Arial"> the routine was successfully executed. If
    1866. 

  1866.         you override the method <em><strong>DoMenuExecCmd</strong></em>,
    1867. 

  1867.         you also must call the inherited method!</font></p>
    1868. 

  1868.         <p><font size="3" face="Arial"><em><strong>xxMenuSucceeded</strong></em>
    1869. 

  1869.         is only called, if the routines in <em><strong>xxMenuExecCmd</strong></em>
    1870. 

  1870.         were successfully executed. This notification is helpful,
    1871. 

  1871.         if you must update the display after successful update.
    1872. 

  1872.         If you override the method <em><strong>DoMenuSucceeded</strong></em>,
    1873. 

  1873.         you also must call the inherited method!</font></p>
    1874. 

  1874.         <p><font size="3" face="Arial"><em><strong>xxMenuDestroy</strong></em>
    1875. 

  1875.         is called after all. Now, it's time to de-intialize
    1876. 

  1876.         everything what you've initialized in <em><strong>xxMenuPopup</strong></em>.
    1877. 

  1877.         Here the continue of the example:</font></p>
    1878. 

  1878.         <blockquote>
    1879. 

  1879.             <p><font size="3" face="Arial"><code><strong>procedure</strong></code><code>
    1880. 

  1880.             TForm1.DragDropFilesEx1MenuDestroy(Sender: TObject;
    1881. 

  1881.             AMenu: HMENU);<br>
    1882. 

  1882.             </code><code><strong>begin</strong></code></font></p>
    1883. 

  1883.             <blockquote>
    1884. 

  1884.                 <p><font size="3" face="Arial"><code><strong>if</strong></code><code>
    1885. 

  1885.                 DeleteMenu(AMenu,MinCustCmd,MF_BYCOMMAND) </code><code><strong>then</strong></code><code>
    1886. 

  1886.                 messagebeep(0);</code></font></p>
    1887. 

  1887.             </blockquote>
    1888. 

  1888.             <p><font size="3" face="Arial"><code><strong>end</strong></code><code>;</code></font></p>
    1889. 

  1889.         </blockquote>
    1890. 

  1890.         <p><font size="3" face="Arial">If you override the method
    1891. 

  1891.         <em><strong>DoMenuDestroy</strong></em>, you also must
    1892. 

  1892.         call the inherited method!</font></p>
    1893. 

  1893.         </td>
    1894. 

  1894.     </tr>
    1895. 

  1895.     <tr>
    1896. 

  1896.         <td height="50">&nbsp;</td>
    1897. 

  1897.         <td>&nbsp;</td>
    1898. 

  1898.     </tr>
    1899. 

  1899. </table>
    1900. 

  1900. 

  1901. <table border="0" width="600">
    1902. 

  1902.     <tr>
    1903. 

  1903.         <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
    1904. 

  1904.         <td rowspan="2" width="590"><a
    1905. 

  1905.         name="Details about the DropHandler"><font size="5"
    1906. 

  1906.         face="Arial">Details about the <strong>DropHandler</strong></font></a></td>
    1907. 

  1907.     </tr>
    1908. 

  1908.     <tr>
    1909. 

  1909.         <td>&nbsp;</td>
    1910. 

  1910.     </tr>
    1911. 

  1911.     <tr>
    1912. 

  1912.         <td>&nbsp;</td>
    1913. 

  1913.         <td><font size="3" face="Arial">The method <em><strong>DropHandler</strong></em>
    1914. 

  1914.         was implemented to allow alternative handling of the
    1915. 

  1915.         dropped data. This is especially important for
    1916. 

  1916.         implementing shell extentions. Was a drophandler
    1917. 

  1917.         successfully called, the event <em><strong>OnDropHandlerSucceeded</strong></em>
    1918. 

  1918.         is triggered. You can only use the the <em><strong>DropHandler
    1919. 

  1919.         </strong></em>only, if you inherit the class <em><strong>TDragDrop</strong></em>.
    1920. 

  1920.         Mostly, the coding in the method <em><strong>DropHandler</strong></em>
    1921. 

  1921.         is nearly similar with that in the method <em><strong>RenderDropped</strong></em>.
    1922. 

  1922.         First, you will render the dropped data, then you will
    1923. 

  1923.         handle the data. You don't do more in this method, and
    1924. 

  1924.         you cannot do more!</font></td>
    1925. 

  1925.     </tr>
    1926. 

  1926.     <tr>
    1927. 

  1927.         <td height="50">&nbsp;</td>
    1928. 

  1928.         <td>&nbsp;</td>
    1929. 

  1929.     </tr>
    1930. 

  1930. </table>
    1931. 

  1931. 

  1932. <table border="0" width="600">
    1933. 

  1933.     <tr>
    1934. 

  1934.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1935. 

  1935.         <td rowspan="2" width="590"><font size="5" face="Arial">FAQ</font></td>
    1936. 

  1936.     </tr>
    1937. 

  1937.     <tr>
    1938. 

  1938.         <td>&nbsp;</td>
    1939. 

  1939.     </tr>
    1940. 

  1940.     <tr>
    1941. 

  1941.         <td>&nbsp;</td>
    1942. 

  1942.         <td><font size="3" face="Arial"><b>Q:</b> I want a single
    1943. 

  1943.         component to be the target of more than one type of drag,
    1944. 

  1944.         what can I do? One always overrides the other. If I use
    1945. 

  1945.         the TDragDrop, where is the information about what was
    1946. 

  1946.         dropped?</font> <p><font size="3" face="Arial"><b>A:</b>
    1947. 

  1947.         You've to write your own child-class from TDragDrop. But
    1948. 

  1948.         you can copy the most of my child-classes together, for
    1949. 

  1949.         faster developing your class.</font></p>
    1950. 

  1950.         <p><font size="3" face="Arial">You can't access the
    1951. 

  1951.         dropped data directly. For this you have the class
    1952. 

  1952.         TDataObject (look at params of methods ...). You have
    1953. 

  1953.         format description for every data(-set) in your data
    1954. 

  1954.         object . You can enumerate the available formats with
    1955. 

  1955.         EnumFormatEtc. With &quot;QueryGetData&quot; you can
    1956. 

  1956.         check, if a special format is available. The data itself
    1957. 

  1957.         you can get with &quot;GetData&quot;. Because of my
    1958. 

  1958.         components design you should better use my new introduced
    1959. 

  1959.         method &quot;RenderData&quot;.</font></p>
    1960. 

  1960.         <p><font size="3" face="Arial">I hope, it helps a little
    1961. 

  1961.         bit. Don't be disappointed, if you don't understand
    1962. 

  1962.         drag&amp;drop immediately. I've even needed some months
    1963. 

  1963.         to understand the mechanisms completely. </font></p>
    1964. 

  1964.         </td>
    1965. 

  1965.     </tr>
    1966. 

  1966.     <tr>
    1967. 

  1967.         <td height="50">&nbsp;</td>
    1968. 

  1968.         <td>&nbsp;</td>
    1969. 

  1969.     </tr>
    1970. 

  1970. </table>
    1971. 

  1971. 

  1972. <table border="0" width="600">
    1973. 

  1973.     <tr>
    1974. 

  1974.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    1975. 

  1975.         <td rowspan="2" width="590"><a
    1976. 

  1976.         name="DragDetectionProblem"><font size="5" face="Arial">Problems
    1977. 

  1977.         With The Drag-Detection</font></a></td>
    1978. 

  1978.     </tr>
    1979. 

  1979.     <tr>
    1980. 

  1980.         <td>&nbsp;</td>
    1981. 

  1981.     </tr>
    1982. 

  1982.     <tr>
    1983. 

  1983.         <td>&nbsp;</td>
    1984. 

  1984.         <td><font face="Arial">I got reports, that some controls
    1985. 

  1985.         e.g. listboxes or grids make trouble in some situations
    1986. 

  1986.         with the drag-detection. This behaviour results of a to
    1987. 

  1987.         old or just incompatible implementation of events in the
    1988. 

  1988.         controls. In such a case you must write a workaround.
    1989. 

  1989.         Mostly, following helps:</font><blockquote>
    1990. 

  1990.             <p><font color="#000080" face="Arial"><code><em><strong>//
    1991. 

  1991.             The type of &quot;P&quot; is TPoint</strong></em></code></font><font
    1992. 

  1992.             face="Arial"><code><br>
    1993. 

  1993.             GetCursorPos(P);<br>
    1994. 

  1994.             P := ScreenToClient(P);<br>
    1995. 

  1995.             SendMessage(&lt;control&gt;.Handle,WM_LBUTTONUP,0<br>
    1996. 

  1996.             &nbsp;&nbsp;&nbsp;,Longint(PointToSmallPoint(P)));</code></font></p>
    1997. 

  1997.         </blockquote>
    1998. 

  1998.         <p><font face="Arial">In some cases e.g. with grids this
    1999. 

  1999.         doesn't work. In these cases you must do a little bit
    2000. 

  2000.         more, as I show you the demo &quot;</font><font size="3"
    2001. 

  2001.         face="Arial">GridFixDemo.zip</font><font face="Arial">&quot;.
    2002. 

  2002.         Mostly, the workaround isn't really difficult to write.</font></p>
    2003. 

  2003.         </td>
    2004. 

  2004.     </tr>
    2005. 

  2005.     <tr>
    2006. 

  2006.         <td height="50">&nbsp;</td>
    2007. 

  2007.         <td>&nbsp;</td>
    2008. 

  2008.     </tr>
    2009. 

  2009. </table>
    2010. 

  2010. 

  2011. <table border="0" width="600">
    2012. 

  2012.     <tr>
    2013. 

  2013.         <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
    2014. 

  2014.         <td rowspan="2" width="590"><font size="5" face="Arial">Known
    2015. 

  2015.         Bugs</font></td>
    2016. 

  2016.     </tr>
    2017. 

  2017.     <tr>
    2018. 

  2018.         <td>&nbsp;</td>
    2019. 

  2019.     </tr>
    2020. 

  2020.     <tr>
    2021. 

  2021.         <td>&nbsp;</td>
    2022. 

  2022.         <td><ul>
    2023. 

  2023.             <li><a name="WinNTBug1"><font size="3" face="Arial">Only
    2024. 

  2024.                 with WinNT4: I got the report, that it is
    2025. 

  2025.                 impossible to discover which drop effect has
    2026. 

  2026.                 effected (important when using <b><i>Execute</i></b>)</font></a>
    2027. 

  2027.             </li>
    2028. 

  2028.             <li><font size="3" face="Arial">If you you have
    2029. 

  2029.                 problems with the drag-detection, check the
    2030. 

  2030.                 section &quot;</font><a
    2031. 

  2031.                 href="#DragDetectionProblem"><font size="3"
    2032. 

  2032.                 face="Arial">Problems With The Drag-Detection</font></a><font
    2033. 

  2033.                 size="3" face="Arial">&quot;</font>.</li>
    2034. 

  2034.         </ul>
    2035. 

  2035.         </td>
    2036. 

  2036.     </tr>
    2037. 

  2037.     <tr>
    2038. 

  2038.         <td height="50">&nbsp;</td>
    2039. 

  2039.         <td>&nbsp;</td>
    2040. 

  2040.     </tr>
    2041. 

  2041. </table>
    2042. 

  2042. 

  2043. <hr>
    2044. 

  2044. 

  2045. <p><font size="3" face="Arial"><i>© 1998,99 by </i></font><a
    2046. 

  2046. href="mailto:[email protected]"><font size="3" face="Arial"><i>Dieter
    2047. 

  2047. Steinwedel</i></font></a><font size="3" face="Arial"> </font></p>
    2048. 

  2048. 

  2049. <p><a href="Index.htm"><font face="Arial">Back</font></a><font
    2050. 

  2050. face="Arial"> to index</font></p>
    2051. 

  2051. </body>
    2052. 

  2052. </html>
    2053.