TDragDropText.htm 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type"
  4. content="text/html; charset=iso-8859-1">
  5. <meta name="AUTHOR" content="Dieter Steinwedel">
  6. <meta name="DESCRIPTION"
  7. content="Drag&amp;Drop component for Delphi; description for TDragDropText">
  8. <meta name="KEYWORDS"
  9. content="delphi, drag, drop, component, text, com, ole, freeware, windows">
  10. <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
  11. <title>Details about TDragDropText</title>
  12. </head>
  13. <body bgcolor="#FFFFEF">
  14. <table border="0" cellspacing="0" width="600" bgcolor="#008080">
  15. <tr>
  16. <td width="10">&nbsp;</td>
  17. <td width="580">&nbsp;</td>
  18. <td width="10" bgcolor="#FFFFEF">&nbsp;</td>
  19. </tr>
  20. <tr>
  21. <td>&nbsp;</td>
  22. <td><p align="center"><font color="#FFFFFF" size="7"
  23. face="Arial">TDragDropText</font></p>
  24. </td>
  25. <td>&nbsp;</td>
  26. </tr>
  27. <tr>
  28. <td bgcolor="#FFFFEF">&nbsp;</td>
  29. <td>&nbsp;</td>
  30. <td>&nbsp;</td>
  31. </tr>
  32. </table>
  33. <p align="left">&nbsp;</p>
  34. <p align="left">&nbsp;</p>
  35. <table border="0" width="600">
  36. <tr>
  37. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  38. <td rowspan="2" width="590"><font size="5" face="Arial">Description</font></td>
  39. </tr>
  40. <tr>
  41. <td>&nbsp;</td>
  42. </tr>
  43. <tr>
  44. <td>&nbsp;</td>
  45. <td><font face="Arial"><b><i>TDragDropText</i></b> is a
  46. comfortable and powerful component for COM/OLE drag&amp;drop
  47. operations with plain text. The component is a child-class
  48. from </font><a href="TDragDrop.htm"><font face="Arial"><b><i>TDragDrop</i></b></font></a><font
  49. face="Arial">.</font></td>
  50. </tr>
  51. <tr>
  52. <td height="50">&nbsp;</td>
  53. <td>&nbsp;</td>
  54. </tr>
  55. </table>
  56. <table border="0" width="600">
  57. <tr>
  58. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  59. <td rowspan="2" width="590"><font size="5" face="Arial">Important
  60. for Use</font></td>
  61. </tr>
  62. <tr>
  63. <td>&nbsp;</td>
  64. </tr>
  65. <tr>
  66. <td>&nbsp;</td>
  67. <td><font face="Arial">This </font><a href="Index.htm"><font
  68. face="Arial">file</font></a><font face="Arial"> (index.htm)
  69. contains more information about restrictions, the
  70. disclaimer, remarks etc.</font></td>
  71. </tr>
  72. <tr>
  73. <td height="50">&nbsp;</td>
  74. <td>&nbsp;</td>
  75. </tr>
  76. </table>
  77. <table border="0" width="600">
  78. <tr>
  79. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  80. <td rowspan="2" width="590"><font size="5" face="Arial">History</font></td>
  81. </tr>
  82. <tr>
  83. <td>&nbsp;</td>
  84. </tr>
  85. <tr>
  86. <td>&nbsp;</td>
  87. <td><font face="Arial"><b>Version 2.10</b> </font><font
  88. color="#808080" face="Arial">published on 06-Jul-1999</font></td>
  89. </tr>
  90. <tr>
  91. <td>&nbsp;</td>
  92. <td><ul>
  93. <li><font face="Arial">Code re-design in result of
  94. modifications in <b><i>TDragDrop</i></b>;
  95. handling hasn't changed</font></li>
  96. </ul>
  97. </td>
  98. </tr>
  99. <tr>
  100. <td>&nbsp;</td>
  101. <td><font face="Arial"><b>Version 2.01</b> </font><font
  102. color="#808080" face="Arial">published on 07-Oct-1998</font><font
  103. face="Arial"> </font></td>
  104. </tr>
  105. <tr>
  106. <td>&nbsp;</td>
  107. <td><ul>
  108. <li><font face="Arial">Small invisible bugs fixed</font></li>
  109. </ul>
  110. </td>
  111. </tr>
  112. <tr>
  113. <td>&nbsp;</td>
  114. <td><font face="Arial"><b>Version 2.00</b> </font><font
  115. color="#808080" face="Arial">published on 03-Oct-1998</font></td>
  116. </tr>
  117. <tr>
  118. <td>&nbsp;</td>
  119. <td><ul>
  120. <li><font face="Arial">Total internal re-design due
  121. to modifications of the super-class, but the
  122. handling hasn't changed</font></li>
  123. </ul>
  124. </td>
  125. </tr>
  126. <tr>
  127. <td>&nbsp;</td>
  128. <td><font face="Arial"><b>Version 1.00</b> </font><font
  129. color="#808080" face="Arial">published on 06-Aug-1998</font><font
  130. face="Arial"> </font></td>
  131. </tr>
  132. <tr>
  133. <td>&nbsp;</td>
  134. <td><ul>
  135. <li><font face="Arial">First official release</font></li>
  136. </ul>
  137. </td>
  138. </tr>
  139. <tr>
  140. <td height="50">&nbsp;</td>
  141. <td colspan="2">&nbsp;</td>
  142. </tr>
  143. </table>
  144. <table border="0" width="600">
  145. <tr>
  146. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  147. <td rowspan="2" width="590"><font size="5" face="Arial">Properties</font></td>
  148. </tr>
  149. <tr>
  150. <td>&nbsp;</td>
  151. </tr>
  152. </table>
  153. <table border="0" cellpadding="3" cellspacing="0" width="600">
  154. <tr>
  155. <td width="10">&nbsp;</td>
  156. <td bgcolor="#008080"><font color="#FFFFFF" size="5"
  157. face="Arial"><strong>inherited properties</strong></font></td>
  158. </tr>
  159. <tr>
  160. <td rowspan="2">&nbsp;</td>
  161. <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Properties"><font
  162. face="Arial">Click here ...</font></a></td>
  163. </tr>
  164. <tr>
  165. <td bgcolor="#FFFFEF">&nbsp;</td>
  166. </tr>
  167. <tr>
  168. <td>&nbsp;</td>
  169. <td bgcolor="#008080"><a name="Lines"><font
  170. color="#FFFFFF" size="5" face="Arial"><b>Lines</b></font></a><font
  171. color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
  172. color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
  173. </tr>
  174. <tr>
  175. <td rowspan="2">&nbsp;</td>
  176. <td bgcolor="#FFFFCC"><font size="3" face="Arial"><b>For
  177. Target:</b> Use this stringlist in </font><a
  178. href="TDragDrop.htm#OnProcessDropped"><font size="3"
  179. face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
  180. size="3" face="Arial">, if you want to get the dropped
  181. text.</font><p><font size="3" face="Arial"><b>For Source:</b>
  182. Add the text to the stringlist, which you want to drag&amp;drop,
  183. before calling </font><a href="#Execute"><font size="3"
  184. face="Arial"><b><i>Execute</i></b></font></a><font
  185. size="3" face="Arial">. </font></p>
  186. </td>
  187. </tr>
  188. <tr>
  189. <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
  190. </tr>
  191. </table>
  192. <table border="0" width="600">
  193. <tr>
  194. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  195. <td rowspan="2" width="590"><font size="5" face="Arial">Events</font></td>
  196. </tr>
  197. <tr>
  198. <td>&nbsp;</td>
  199. </tr>
  200. </table>
  201. <table border="0" cellpadding="3" cellspacing="0" width="600">
  202. <tr>
  203. <td width="10">&nbsp;</td>
  204. <td bgcolor="#008080"><font color="#FFFFFF" size="5"
  205. face="Arial"><strong>inherited events</strong></font></td>
  206. </tr>
  207. <tr>
  208. <td rowspan="2">&nbsp;</td>
  209. <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Events"><font
  210. face="Arial">Click here ...</font></a></td>
  211. </tr>
  212. <tr>
  213. <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
  214. </tr>
  215. </table>
  216. <table border="0" width="600">
  217. <tr>
  218. <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
  219. <td rowspan="2" width="590"><font size="5" face="Arial">Methods</font></td>
  220. </tr>
  221. <tr>
  222. <td>&nbsp;</td>
  223. </tr>
  224. </table>
  225. <table border="0" cellpadding="3" cellspacing="0" width="600">
  226. <tr>
  227. <td width="10">&nbsp;</td>
  228. <td bgcolor="#008080"><font color="#FFFFFF" size="5"
  229. face="Arial"><strong>inherited methods</strong></font></td>
  230. </tr>
  231. <tr>
  232. <td rowspan="2">&nbsp;</td>
  233. <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Methods"><font
  234. face="Arial">Click here ...</font></a></td>
  235. </tr>
  236. <tr>
  237. <td bgcolor="#FFFFEF">&nbsp;</td>
  238. </tr>
  239. <tr>
  240. <td>&nbsp;</td>
  241. <td bgcolor="#008080"><a name="Execute"><font
  242. color="#FFFFFF" size="5" face="Arial"><b>Execute</b></font></a><font
  243. color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
  244. color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
  245. </tr>
  246. <tr>
  247. <td rowspan="2">&nbsp;</td>
  248. <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
  249. this method, if you detect that the user wants to start a
  250. drag&amp;drop operation (e.g. MouseDown+MouseMove). Also
  251. look: </font><a href="#Lines"><font size="3" face="Arial"><em><strong>Lines</strong></em></font></a><font
  252. size="3" face="Arial">.</font><p><font size="3"
  253. face="Arial">For drag detection you can also use the
  254. inherited property </font><a
  255. href="TDragDrop.htm#AutoDetectDnD"><font size="3"
  256. face="Arial"><em><strong>AutotDetectDnD</strong></em></font></a><font
  257. size="3" face="Arial"> or the method </font><a
  258. href="TDragDrop.htm#StartDnDDetection"><font size="3"
  259. face="Arial"><em><strong>StartDnDDetection</strong></em></font></a><font
  260. size="3" face="Arial">.</font></p>
  261. <p><font size="3" face="Arial">IMPORTANT: If you use the
  262. drag-detection, it's high recommended to check the
  263. section &quot;</font><a
  264. href="TDragDrop.htm#DragDetectionProblem"><font size="3"
  265. face="Arial">Problems With The Drag-Detection</font></a><font
  266. size="3" face="Arial">&quot;.</font></p>
  267. </td>
  268. </tr>
  269. <tr>
  270. <td bgcolor="#FFFFEF" height="50">&nbsp;</td>
  271. </tr>
  272. </table>
  273. <table border="0" width="600">
  274. <tr>
  275. <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
  276. <td rowspan="2" colspan="2" width="590"><font size="5"
  277. face="Arial">How Do I Use It As Drag&amp;Drop Source</font></td>
  278. </tr>
  279. <tr>
  280. <td>&nbsp;</td>
  281. </tr>
  282. <tr>
  283. <td>&nbsp;</td>
  284. <td valign="top"><font face="Arial">1.</font></td>
  285. <td><font face="Arial">Drop a TWinControl on the form (e.g.
  286. a memo).</font></td>
  287. </tr>
  288. <tr>
  289. <td>&nbsp;</td>
  290. <td valign="top"><font face="Arial">2.</font></td>
  291. <td><font face="Arial">Choose the TWinControl (memo) in </font><a
  292. href="TDragDrop.htm#DragDropControl"><font face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
  293. face="Arial">.</font></td>
  294. </tr>
  295. <tr>
  296. <td>&nbsp;</td>
  297. <td valign="top"><font face="Arial">3. </font></td>
  298. <td><font face="Arial">Choose the drag&amp;drop effects
  299. under </font><a href="TDragDrop.htm#SourceEffects"><font
  300. face="Arial"><em><strong>SourceEffects</strong></em></font></a><font
  301. face="Arial"> which the <em><strong>DragDropControl </strong></em>(memo)
  302. should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
  303. serve as drag&amp;drop source all items must be set to
  304. false.</font></td>
  305. </tr>
  306. <tr>
  307. <td>&nbsp;</td>
  308. <td valign="top"><font face="Arial">4.</font></td>
  309. <td><font face="Arial">Now, your <em><strong>DragDropControl</strong></em>
  310. (memo) must detect, if the user wants to start a drag&amp;drop
  311. operation. You can use the event &quot;OnMouseDown&quot;
  312. of your <em><strong>DragDropControl</strong></em> (memo).
  313. Add following to the event:</font><blockquote>
  314. <p><font face="Arial"><code>DragDropText1.Lines.Add(&lt;selection
  315. of </code></font><a
  316. href="TDragDrop.htm#DragDropControl"><font
  317. face="Arial"><code><em><strong>DragDropControl</strong></em></code></font></a><font
  318. face="Arial"><code> (memo)&gt;);</code></font></p>
  319. </blockquote>
  320. </td>
  321. </tr>
  322. <tr>
  323. <td>&nbsp;</td>
  324. <td valign="top"><font face="Arial">5.</font></td>
  325. <td valign="top"><font face="Arial">Tell Windows that
  326. there is a drag&amp;drop operation to handle: Just call
  327. the method </font><a href="TDragDrop.htm#Execute"><font
  328. face="Arial"><em><strong>Execute</strong></em></font></a><font
  329. face="Arial"> of this component. </font></td>
  330. </tr>
  331. <tr>
  332. <td valign="top">&nbsp;</td>
  333. <td valign="top"><font face="Arial">6.</font></td>
  334. <td valign="top"><font size="3" face="Arial">You may use
  335. the events </font><a href="TDragDrop.htm#OnGiveFeedback"><font
  336. size="3" face="Arial"><b><i>OnGiveFeedback</i></b></font></a><font
  337. size="3" face="Arial"> and </font><a
  338. href="TDragDrop.htm#OnQueryContinueDrag"><font size="3"
  339. face="Arial"><b><i>OnQueryContinueDrag</i></b></font></a><font
  340. size="3" face="Arial">, but often you need not.</font></td>
  341. </tr>
  342. <tr>
  343. <td valign="top">&nbsp;</td>
  344. <td valign="top">&nbsp;</td>
  345. <td valign="top">&nbsp;</td>
  346. </tr>
  347. <tr>
  348. <td valign="top">&nbsp;</td>
  349. <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
  350. </tr>
  351. <tr>
  352. <td valign="top">&nbsp;</td>
  353. <td valign="top" colspan="2"><ul>
  354. <li><font size="3" face="Arial">Drag&amp;drop
  355. operations cannot be done at design-time!</font></li>
  356. <li><font size="3" face="Arial">IMPORTANT: If you use
  357. the drag-detection, it's high recommended to
  358. check the section &quot;</font><a
  359. href="TDragDrop.htm#DragDetectionProblem"><font
  360. size="3" face="Arial">Problems With The Drag-Detection</font></a><font
  361. size="3" face="Arial">&quot;.</font></li>
  362. </ul>
  363. </td>
  364. </tr>
  365. <tr>
  366. <td height="50">&nbsp;</td>
  367. <td colspan="2">&nbsp;</td>
  368. </tr>
  369. </table>
  370. <table border="0" width="600">
  371. <tr>
  372. <td width="10" bgcolor="#008080" height="10">&nbsp;</td>
  373. <td rowspan="2" colspan="2" width="590"><font size="5"
  374. face="Arial">How Do I Use It As Drag&amp;Drop Target</font></td>
  375. </tr>
  376. <tr>
  377. <td>&nbsp;</td>
  378. </tr>
  379. <tr>
  380. <td>&nbsp;</td>
  381. <td valign="top"><font face="Arial">1.</font></td>
  382. <td><font face="Arial">Drop a TWinControl on the form (e.g.
  383. a memo).</font></td>
  384. </tr>
  385. <tr>
  386. <td>&nbsp;</td>
  387. <td valign="top"><font face="Arial">2.</font></td>
  388. <td><font face="Arial">Choose the TWinControl (memo) in </font><a
  389. href="TDragDrop.htm#DragDropControl"><font face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
  390. face="Arial">.</font></td>
  391. </tr>
  392. <tr>
  393. <td>&nbsp;</td>
  394. <td valign="top"><font face="Arial">3. </font></td>
  395. <td><font face="Arial">Choose the drag&amp;drop effects
  396. under </font><a href="TDragDrop.htm#TargetEffects"><font
  397. face="Arial"><em><strong>TargetEffects</strong></em></font></a><font
  398. face="Arial"> which the <em><strong>DragDropControl </strong></em>(memo)
  399. should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
  400. serve as drag&amp;drop target all items must be set to
  401. false.</font></td>
  402. </tr>
  403. <tr>
  404. <td>&nbsp;</td>
  405. <td valign="top"><font face="Arial">4.</font></td>
  406. <td><font size="3" face="Arial">Now, you have to program
  407. what happen, if the user drops text on your </font><a
  408. href="TDragDrop.htm#DragDropControl"><font size="3"
  409. face="Arial"><b><i>DragDropControl</i></b></font></a><font
  410. size="3" face="Arial"> (memo). For this, the best is to
  411. use the event </font><a
  412. href="TDragDrop.htm#OnProcessDropped"><font size="3"
  413. face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
  414. size="3" face="Arial">. At first, you should check what
  415. drag&amp;drop effect was chosen by the user. You get the
  416. effect from method's parameter <b><i>dwEffect</i></b>.
  417. You get the bitmap from this component with following
  418. line:</font><blockquote>
  419. <p><font face="Arial"><code>...:=DragDropText1.Lines[&lt;Index&gt;];</code></font></p>
  420. </blockquote>
  421. <p><a href="#Lines"><font size="3" face="Arial"><b><i>Lines</i></b></font></a><font
  422. size="3" face="Arial"> is a stringlist. For more info
  423. check the Delphi's online-help. Now, do with the text
  424. what you have to do, e.g. copy, move, delete, etc.</font></p>
  425. </td>
  426. </tr>
  427. <tr>
  428. <td>&nbsp;</td>
  429. <td valign="top"><font face="Arial">5.</font></td>
  430. <td valign="top"><font size="3" face="Arial">You may use
  431. the events </font><a href="TDragDrop.htm#OnDragEnter"><font
  432. size="3" face="Arial"><b><i>OnDragEnter</i></b></font></a><font
  433. size="3" face="Arial">, </font><a
  434. href="TDragDrop.htm#OnDragOver"><font size="3"
  435. face="Arial"><b><i>OnDragOver</i></b></font></a><font
  436. size="3" face="Arial"> and </font><a
  437. href="TDragDrop.htm#OnDragLeave"><font size="3"
  438. face="Arial"><b><i>OnDragLeave</i></b></font></a><font
  439. size="3" face="Arial">, but often you need not.</font></td>
  440. </tr>
  441. <tr>
  442. <td valign="top">&nbsp;</td>
  443. <td valign="top">&nbsp;</td>
  444. <td valign="top">&nbsp;</td>
  445. </tr>
  446. <tr>
  447. <td valign="top">&nbsp;</td>
  448. <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
  449. </tr>
  450. <tr>
  451. <td valign="top">&nbsp;</td>
  452. <td valign="top" colspan="2"><ul>
  453. <li><font size="3" face="Arial">Drag&amp;drop
  454. operations cannot be done at design-time!</font></li>
  455. </ul>
  456. </td>
  457. </tr>
  458. <tr>
  459. <td height="50">&nbsp;</td>
  460. <td colspan="2">&nbsp;</td>
  461. </tr>
  462. </table>
  463. <table border="0" width="600">
  464. <tr>
  465. <td width="10" bgcolor="#008080" height="10">&nbsp; </td>
  466. <td rowspan="2" width="590"><font size="5" face="Arial">Known
  467. Bugs</font></td>
  468. </tr>
  469. <tr>
  470. <td>&nbsp;</td>
  471. </tr>
  472. <tr>
  473. <td>&nbsp;</td>
  474. <td><ul>
  475. <li><font face="Arial">I hope, you never find one</font></li>
  476. </ul>
  477. </td>
  478. </tr>
  479. <tr>
  480. <td height="50">&nbsp;</td>
  481. <td>&nbsp;</td>
  482. </tr>
  483. </table>
  484. <hr>
  485. <p><font size="3" face="Arial"><i>© 1998,99 by </i></font><a
  486. href="mailto:[email protected]"><font size="3" face="Arial"><i>Dieter
  487. Steinwedel</i></font></a><font size="3" face="Arial"> </font></p>
  488. <p><a href="Index.htm"><font face="Arial">Back</font></a><font
  489. face="Arial"> to index</font></p>
  490. </body>
  491. </html>