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
/
TDragDropFilesEx.htm

TDragDropFilesEx.htm 37 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910 
  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 TDragDropFilesEx">
    9. 

  9. <meta name="KEYWORDS"
    10. 

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

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

  12. <title>Details about TDragDropFilesEx</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">TDragDropEx</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>TDragDropFilesEx</i></b> is
    52. 

  52.         a comfortable and powerful component for COM/OLE
    53. 

  53.         drag&amp;drop operations with files and supports
    54. 

  54.         completely the namespace of Windows (PIDL). The component
    55. 

  55.         is a child-class from </font><a href="TDragDrop.htm"><font
    56. 

  56.         face="Arial"><b><i>TDragDrop</i></b></font></a><font
    57. 

  57.         face="Arial">.</font></td>
    58. 

  58.     </tr>
    59. 

  59.     <tr>
    60. 

  60.         <td height="50">&nbsp;</td>
    61. 

  61.         <td>&nbsp;</td>
    62. 

  62.     </tr>
    63. 

  63. </table>
    64. 

  64. 

  65. <table border="0" width="600">
    66. 

  66.     <tr>
    67. 

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

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

  69.         for Use</font></td>
    70. 

  70.     </tr>
    71. 

  71.     <tr>
    72. 

  72.         <td>&nbsp;</td>
    73. 

  73.     </tr>
    74. 

  74.     <tr>
    75. 

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

  76.         <td><font face="Arial">This </font><a href="Index.htm"><font
    77. 

  77.         face="Arial">file</font></a><font face="Arial">
    78. 

  78.         (index.htm) contains more information about restrictions,
    79. 

  79.         the disclaimer, remarks etc.</font></td>
    80. 

  80.     </tr>
    81. 

  81.     <tr>
    82. 

  82.         <td height="50">&nbsp;</td>
    83. 

  83.         <td>&nbsp;</td>
    84. 

  84.     </tr>
    85. 

  85. </table>
    86. 

  86. 

  87. <table border="0" width="600">
    88. 

  88.     <tr>
    89. 

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

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

  91.     </tr>
    92. 

  92.     <tr>
    93. 

  93.         <td>&nbsp;</td>
    94. 

  94.     </tr>
    95. 

  95.     <tr>
    96. 

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

  97.         <td><font face="Arial"><b>Version 1.30</b> </font><font
    98. 

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

  99.     </tr>
    100. 

  100.     <tr>
    101. 

  101.         <td>&nbsp;</td>
    102. 

  102.         <td><ul>
    103. 

  103.             <li><font face="Arial">Implementation of shell
    104. 

  104.                 extensions (drop- and drag&amp;drop-handler)</font></li>
    105. 

  105.             <li><font face="Arial">Changes in the <em><strong>FileList</strong></em>;
    106. 

  106.                 but no code breaking</font></li>
    107. 

  107.         </ul>
    108. 

  108.         </td>
    109. 

  109.     </tr>
    110. 

  110.     <tr>
    111. 

  111.         <td>&nbsp;</td>
    112. 

  112.         <td><font face="Arial"><b>Version 1.22</b> </font><font
    113. 

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

  114.     </tr>
    115. 

  115.     <tr>
    116. 

  116.         <td>&nbsp;</td>
    117. 

  117.         <td><ul>
    118. 

  118.             <li><font face="Arial">Small bug in RenderDropped
    119. 

  119.                 fixed; instead of <em><strong>GlobalFree</strong></em>
    120. 

  120.                 I use <em><strong>ReleaseStgMedium</strong></em>
    121. 

  121.                 for releasing resources</font></li>
    122. 

  122.             <li><font face="Arial">The <em><strong>TFileList</strong></em>
    123. 

  123.                 has changed, because the items' type was
    124. 

  124.                 adjusted; now, you don't need any longer to do
    125. 

  125.                 type-casting on accessing the items in the list;
    126. 

  126.                 this modification should make the use of the list
    127. 

  127.                 a little bit easier; in order of this change,<em><strong>
    128. 

  128.                 TSortedList</strong></em> won't be any longer
    129. 

  129.                 used</font></li>
    130. 

  130.         </ul>
    131. 

  131.         </td>
    132. 

  132.     </tr>
    133. 

  133.     <tr>
    134. 

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

  135.         <td><font face="Arial"><b>Version 1.21</b> </font><font
    136. 

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

  137.     </tr>
    138. 

  138.     <tr>
    139. 

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

  140.         <td><ul>
    141. 

  141.             <li><font face="Arial">Small bug with property <b><i>FileNamesAreMapped</i></b>
    142. 

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

  143.             <li><font face="Arial">Bug with mapped filenames
    144. 

  144.                 under WinNT fixed </font></li>
    145. 

  145.         </ul>
    146. 

  146.         </td>
    147. 

  147.     </tr>
    148. 

  148.     <tr>
    149. 

  149.         <td>&nbsp;</td>
    150. 

  150.         <td><font face="Arial"><b>Version 1.20</b> </font><font
    151. 

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

  152.     </tr>
    153. 

  153.     <tr>
    154. 

  154.         <td>&nbsp;</td>
    155. 

  155.         <td><ul>
    156. 

  156.             <li><font face="Arial">Code re-design in result of
    157. 

  157.                 modifications in <b><i>TDragDrop</i></b>;
    158. 

  158.                 handling hasn't changed</font></li>
    159. 

  159.         </ul>
    160. 

  160.         </td>
    161. 

  161.     </tr>
    162. 

  162.     <tr>
    163. 

  163.         <td>&nbsp;</td>
    164. 

  164.         <td><font face="Arial"><b>Version 1.10</b> </font><font
    165. 

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

  166.     </tr>
    167. 

  167.     <tr>
    168. 

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

  169.         <td><ul>
    170. 

  170.             <li><font face="Arial">Is now able to handle mapped
    171. 

  171.                 filenames </font></li>
    172. 

  172.             <li><font face="Arial">Some bugs fixed with filelist</font></li>
    173. 

  173.         </ul>
    174. 

  174.         </td>
    175. 

  175.     </tr>
    176. 

  176.     <tr>
    177. 

  177.         <td>&nbsp;</td>
    178. 

  178.         <td><font face="Arial"><b>Version 1.02</b> </font><font
    179. 

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

  180.     </tr>
    181. 

  181.     <tr>
    182. 

  182.         <td>&nbsp;</td>
    183. 

  183.         <td><ul>
    184. 

  184.             <li><font face="Arial">New property added: <b><i>CompleteFileList</i></b></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 1.01</b> </font><font
    191. 

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

  192.     </tr>
    193. 

  193.     <tr>
    194. 

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

  195.         <td><ul>
    196. 

  196.             <li><font face="Arial">Small invisible bugs fixed</font></li>
    197. 

  197.         </ul>
    198. 

  198.         </td>
    199. 

  199.     </tr>
    200. 

  200.     <tr>
    201. 

  201.         <td>&nbsp;</td>
    202. 

  202.         <td><font face="Arial"><b>Version 1.00</b> </font><font
    203. 

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

  204.         face="Arial"> </font></td>
    205. 

  205.     </tr>
    206. 

  206.     <tr>
    207. 

  207.         <td>&nbsp;</td>
    208. 

  208.         <td><ul>
    209. 

  209.             <li><font face="Arial">First official release</font></li>
    210. 

  210.         </ul>
    211. 

  211.         </td>
    212. 

  212.     </tr>
    213. 

  213.     <tr>
    214. 

  214.         <td height="50">&nbsp;</td>
    215. 

  215.         <td colspan="2">&nbsp;</td>
    216. 

  216.     </tr>
    217. 

  217. </table>
    218. 

  218. 

  219. <table border="0" width="600">
    220. 

  220.     <tr>
    221. 

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

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

  223.     </tr>
    224. 

  224.     <tr>
    225. 

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

  226.     </tr>
    227. 

  227. </table>
    228. 

  228. 

  229. <table border="0" cellpadding="3" cellspacing="0" width="600">
    230. 

  230.     <tr>
    231. 

  231.         <td width="10">&nbsp;</td>
    232. 

  232.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    233. 

  233.         face="Arial"><strong>inherited properties</strong></font></td>
    234. 

  234.     </tr>
    235. 

  235.     <tr>
    236. 

  236.         <td rowspan="2">&nbsp;</td>
    237. 

  237.         <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Properties"><font
    238. 

  238.         face="Arial">Click here ...</font></a></td>
    239. 

  239.     </tr>
    240. 

  240.     <tr>
    241. 

  241.         <td bgcolor="#FFFFEF">&nbsp;</td>
    242. 

  242.     </tr>
    243. 

  243.     <tr>
    244. 

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

  245.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    246. 

  246.         face="Arial"><b>CompleteFileList </b></font><font
    247. 

  247.         color="#FFFF80" size="2" face="Arial"><b><i>published</i></b></font></td>
    248. 

  248.     </tr>
    249. 

  249.     <tr>
    250. 

  250.         <td rowspan="2">&nbsp;</td>
    251. 

  251.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Here
    252. 

  252.         you can determine, if the<b> </b></font><a
    253. 

  253.         href="#FileList"><font size="3" face="Arial"><b><i>FileList</i></b></font></a><font
    254. 

  254.         size="3" face="Arial"> should be automaticly completed or
    255. 

  255.         not on calling </font><a href="#Execute"><font size="3"
    256. 

  256.         face="Arial"><b><i>Execute</i></b></font></a><font
    257. 

  257.         size="3" face="Arial"> and </font><a
    258. 

  258.         href="TDragDrop.htm#CopyToClipBoard"><font size="3"
    259. 

  259.         face="Arial"><b><i>CopyToClipBoard</i></b></font></a><font
    260. 

  260.         size="3" face="Arial">. This was added the increase the
    261. 

  261.         performance on some actions.</font></td>
    262. 

  262.     </tr>
    263. 

  263.     <tr>
    264. 

  264.         <td bgcolor="#FFFFEF">&nbsp;</td>
    265. 

  265.     </tr>
    266. 

  266.     <tr>
    267. 

  267.         <td>&nbsp;</td>
    268. 

  268.         <td bgcolor="#008080"><a name="FileList"><font
    269. 

  269.         color="#FFFFFF" size="5" face="Arial"><b>FileList</b></font></a><font
    270. 

  270.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    271. 

  271.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    272. 

  272.     </tr>
    273. 

  273.     <tr>
    274. 

  274.         <td>&nbsp;</td>
    275. 

  275.         <td bgcolor="#FFFFCC"><font size="3" face="Arial"><b>For
    276. 

  276.         Target:</b> Use this list in </font><a
    277. 

  277.         href="TDragDrop.htm#OnProcessDropped"><font size="3"
    278. 

  278.         face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    279. 

  279.         size="3" face="Arial">, if you want to get the dropped
    280. 

  280.         files.</font><p><font size="3" face="Arial"><b>For
    281. 

  281.         Source:</b> Add the files to this list, that you want to
    282. 

  282.         drag&amp;drop, before calling </font><a href="#Execute"><font
    283. 

  283.         size="3" face="Arial"><b><i>Execute</i></b></font></a><font
    284. 

  284.         size="3" face="Arial">. Only if the pidl is available,
    285. 

  285.         the drag&amp;drop target can create a shortcut.</font></p>
    286. 

  286.         <p><font color="#FF0000" size="3" face="Arial"><strong>Attention:</strong></font><font
    287. 

  287.         size="3" face="Arial"> <em><strong>FileList</strong></em>
    288. 

  288.         is an instance of </font><a href="#TFileList_Info"><font
    289. 

  289.         size="3" face="Arial"><em><strong>TFileList</strong></em></font></a><font
    290. 

  290.         size="3" face="Arial">!</font></p>
    291. 

  291.         </td>
    292. 

  292.     </tr>
    293. 

  293.     <tr>
    294. 

  294.         <td>&nbsp;</td>
    295. 

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

  296.     </tr>
    297. 

  297.     <tr>
    298. 

  298.         <td>&nbsp;</td>
    299. 

  299.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    300. 

  300.         face="Arial"><b>NeedValid </b></font><font
    301. 

  301.         color="#FFFF80" size="2" face="Arial"><b><i>published</i></b></font></td>
    302. 

  302.     </tr>
    303. 

  303.     <tr>
    304. 

  304.         <td rowspan="2">&nbsp;</td>
    305. 

  305.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Here,
    306. 

  306.         you can determine, if the drag&amp;drop data must have a
    307. 

  307.         filename (set includes<b> </b><b><i>nvFilename</i></b>)
    308. 

  308.         or </font><a href="#pidl_Info"><font size="3"
    309. 

  309.         face="Arial">pidl</font></a><font size="3" face="Arial">
    310. 

  310.         (set includes <b><i>nvPIDL</i></b>). This property
    311. 

  311.         applies to receiving AND transmitting data.</font><p><font
    312. 

  312.         size="3" face="Arial"><b>For Source:</b> Only if the
    313. 

  313.         pidls are available, you can make a shortcut e.g. to the
    314. 

  314.         desktop! </font></p>
    315. 

  315.         </td>
    316. 

  316.     </tr>
    317. 

  317.     <tr>
    318. 

  318.         <td bgcolor="#FFFFEF">&nbsp;</td>
    319. 

  319.     </tr>
    320. 

  320.     <tr>
    321. 

  321.         <td>&nbsp;</td>
    322. 

  322.         <td bgcolor="#008080"><a name="ShellExtensions"><font
    323. 

  323.         color="#FFFFFF" size="5" face="Arial"><b>ShellExtensions</b></font></a><font
    324. 

  324.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    325. 

  325.         color="#FFFF80" size="2" face="Arial"><b><i>published</i></b></font></td>
    326. 

  326.     </tr>
    327. 

  327.     <tr>
    328. 

  328.         <td>&nbsp;</td>
    329. 

  329.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    330. 

  330.         property has two sub-properties:</font><ul>
    331. 

  331.             <li><font size="3" face="Arial"><em><strong>DragDropHandler</strong></em></font></li>
    332. 

  332.             <li><font size="3" face="Arial"><em><strong>DropHandler</strong></em></font></li>
    333. 

  333.         </ul>
    334. 

  334.         <p><font size="3" face="Arial">If the user drops data
    335. 

  335.         with right mousebutton and the property </font><a
    336. 

  336.         href="TDragDrop.htm#TargetPopUpMenu"><font size="3"
    337. 

  337.         face="Arial"><em><strong>TargetPopUpMenu</strong></em></font></a><font
    338. 

  338.         size="3" face="Arial"> and the sub-property <em><strong>DragDropHandler
    339. 

  339.         </strong></em>is set to true, this component checks for a
    340. 

  340.         available drag&amp;drop-handler. For this you must
    341. 

  341.         specify a drop-target in the event-handler </font><a
    342. 

  342.         href="#OnSpecifyDropTarget"><font size="3" face="Arial"><em><strong>OnSpecifyDropTarget</strong></em></font></a><font
    343. 

  343.         size="3" face="Arial">. The drop-target must be a
    344. 

  344.         directory. If a drag&amp;drop-handler is available for
    345. 

  345.         the dropped data, there will be</font> <font face="Arial">corresponding
    346. 

  346.         items added to to context-menu. If the user e</font><font
    347. 

  347.         size="3" face="Arial">.g. drops ZIP-Files and Winzip is
    348. 

  348.         installed, items like &quot;Extract to ...&quot; will
    349. 

  349.         added to the context-menu. If the user selected such an
    350. 

  350.         item, the dropped files will be extracted and you are
    351. 

  351.         notified by the event </font><a
    352. 

  352.         href="TDragDrop.htm#OnMenuSucceeded"><font size="3"
    353. 

  353.         face="Arial"><em><strong>OnMenuSucceeded</strong></em></font></a><font
    354. 

  354.         size="3" face="Arial">, that the extension was
    355. 

  355.         successfully executed. Was the extension successfully
    356. 

  356.         executed, the events </font><a
    357. 

  357.         href="TDragDrop.htm#OnDrop"><font size="3" face="Arial"><em><strong>OnDrop</strong></em></font></a><font
    358. 

  358.         size="3" face="Arial"> and </font><a
    359. 

  359.         href="TDragDrop.htm#OnProcessDropped"><font size="3"
    360. 

  360.         face="Arial"><em><strong>OnProcessDropped</strong></em></font></a><font
    361. 

  361.         size="3" face="Arial"> won't be triggered.</font></p>
    362. 

  362.         <p><font size="3" face="Arial">If the user drops files on
    363. 

  363.         an other file and the sub-property <em><strong>DropHandler</strong></em>
    364. 

  364.         is set to true, the drop-handler will be executed, if
    365. 

  365.         available. The drop-handler will only executed, if you
    366. 

  366.         specify in the event </font><a
    367. 

  367.         href="#OnSpecifyDropTarget"><font size="3" face="Arial"><em><strong>OnSpecifyDropTarget</strong></em></font></a><font
    368. 

  368.         size="3" face="Arial"> a file, for that is a drop-handler
    369. 

  369.         defined in the registry. You can determine during a drop
    370. 

  370.         with the method </font><a href="#TargetHasDropHandler"><font
    371. 

  371.         size="3" face="Arial"><em><strong>TargetHasDropHandler</strong></em></font></a><font
    372. 

  372.         size="3" face="Arial"> in the event </font><a
    373. 

  373.         href="TDragDrop.htm#OnDragOver"><font size="3"
    374. 

  374.         face="Arial"><em><strong>OnDragOver</strong></em></font></a><font
    375. 

  375.         size="3" face="Arial">, if the file has a drop-handler.
    376. 

  376.         If the drop-handler was successfully executed, the event </font><a
    377. 

  377.         href="TDragDrop.htm#OnDropHandlerSucceeded"><font
    378. 

  378.         size="3" face="Arial"><em><strong>OnDropHandlerSucceeded</strong></em></font></a><font
    379. 

  379.         size="3" face="Arial"> will triggered. A drop-handler
    380. 

  380.         will be executed, if the user drops a file/directory on a
    381. 

  381.         ZIP-File and Winzip is installed. The dropped
    382. 

  382.         file/directory will be added to ZIP-file.</font></p>
    383. 

  383.         </td>
    384. 

  384.     </tr>
    385. 

  385.     <tr>
    386. 

  386.         <td>&nbsp;</td>
    387. 

  387.         <td height="50">&nbsp;</td>
    388. 

  388.     </tr>
    389. 

  389. </table>
    390. 

  390. 

  391. <table border="0" width="600">
    392. 

  392.     <tr>
    393. 

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

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

  395.     </tr>
    396. 

  396.     <tr>
    397. 

  397.         <td>&nbsp;</td>
    398. 

  398.     </tr>
    399. 

  399. </table>
    400. 

  400. 

  401. <table border="0" cellpadding="3" cellspacing="0" width="600">
    402. 

  402.     <tr>
    403. 

  403.         <td width="10">&nbsp;</td>
    404. 

  404.         <td bgcolor="#008080"><font color="#FFFFFF" size="5"
    405. 

  405.         face="Arial"><strong>inherited events</strong></font></td>
    406. 

  406.     </tr>
    407. 

  407.     <tr>
    408. 

  408.         <td rowspan="2">&nbsp;</td>
    409. 

  409.         <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Events"><font
    410. 

  410.         face="Arial">Click here ...</font></a></td>
    411. 

  411.     </tr>
    412. 

  412.     <tr>
    413. 

  413.         <td bgcolor="#FFFFEF">&nbsp;</td>
    414. 

  414.     </tr>
    415. 

  415.     <tr>
    416. 

  416.         <td>&nbsp;</td>
    417. 

  417.         <td bgcolor="#008080"><a name="OnSpecifyDropTarget"><font
    418. 

  418.         color="#FFFFFF" size="5" face="Arial"><strong>OnSpecifyDropTarget</strong></font></a><font
    419. 

  419.         color="#FFFFFF" size="5" face="Arial"><strong> </strong></font><font
    420. 

  420.         color="#FFFF80" size="2" face="Arial"><b><i>published</i></b></font></td>
    421. 

  421.     </tr>
    422. 

  422.     <tr>
    423. 

  423.         <td>&nbsp;</td>
    424. 

  424.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">This
    425. 

  425.         event will be triggered by the sub-properties of the
    426. 

  426.         property </font><a href="#ShellExtensions"><font size="3"
    427. 

  427.         face="Arial"><em><strong>ShellExtensions</strong></em></font></a><font
    428. 

  428.         size="3" face="Arial">. You must specify a drop-target
    429. 

  429.         (file/directory) by the filename or pidl. You don't need
    430. 

  430.         to specify both values, but it doesn't harm. If no
    431. 

  431.         drop-target is specified, the shell extensions won't be
    432. 

  432.         executed.</font></td>
    433. 

  433.     </tr>
    434. 

  434.     <tr>
    435. 

  435.         <td>&nbsp;</td>
    436. 

  436.         <td height="50">&nbsp;</td>
    437. 

  437.     </tr>
    438. 

  438. </table>
    439. 

  439. 

  440. <table border="0" width="600">
    441. 

  441.     <tr>
    442. 

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

  443.         <td rowspan="2" width="590"><font size="5" face="Arial">Methods</font></td>
    444. 

  444.     </tr>
    445. 

  445.     <tr>
    446. 

  446.         <td>&nbsp;</td>
    447. 

  447.     </tr>
    448. 

  448. </table>
    449. 

  449. 

  450. <table border="0" cellpadding="3" cellspacing="0" width="600">
    451. 

  451.     <tr>
    452. 

  452.         <td width="10">&nbsp;</td>
    453. 

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

  454.         face="Arial"><strong>inherited methods</strong></font></td>
    455. 

  455.     </tr>
    456. 

  456.     <tr>
    457. 

  457.         <td rowspan="2">&nbsp;</td>
    458. 

  458.         <td bgcolor="#FFFFCC"><a href="TDragDrop.htm#Methods"><font
    459. 

  459.         face="Arial">Click here ...</font></a></td>
    460. 

  460.     </tr>
    461. 

  461.     <tr>
    462. 

  462.         <td bgcolor="#FFFFEF">&nbsp;</td>
    463. 

  463.     </tr>
    464. 

  464.     <tr>
    465. 

  465.         <td>&nbsp;</td>
    466. 

  466.         <td bgcolor="#008080"><a name="Execute"><font
    467. 

  467.         color="#FFFFFF" size="5" face="Arial"><b>Execute</b></font></a><font
    468. 

  468.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    469. 

  469.         color="#FFFF80" size="2" face="Arial"><b><i>public</i></b></font></td>
    470. 

  470.     </tr>
    471. 

  471.     <tr>
    472. 

  472.         <td rowspan="2">&nbsp;</td>
    473. 

  473.         <td bgcolor="#FFFFCC"><font size="3" face="Arial">Call
    474. 

  474.         this method, if you detect that the user wants to start a
    475. 

  475.         drag&amp;drop operation (e.g. MouseDown+MouseMove). Also
    476. 

  476.         look: </font><a href="#FileList"><font size="3"
    477. 

  477.         face="Arial"><em><strong>FileList</strong></em></font></a><font
    478. 

  478.         size="3" face="Arial">.</font><p><font size="3"
    479. 

  479.         face="Arial">For drag detection you can also use the
    480. 

  480.         inherited property </font><a
    481. 

  481.         href="TDragDrop.htm#AutoDetectDnD"><font size="3"
    482. 

  482.         face="Arial"><em><strong>AutotDetectDnD</strong></em></font></a><font
    483. 

  483.         size="3" face="Arial"> or the method </font><a
    484. 

  484.         href="TDragDrop.htm#StartDnDDetection"><font size="3"
    485. 

  485.         face="Arial"><em><strong>StartDnDDetection</strong></em></font></a><font
    486. 

  486.         size="3" face="Arial">.</font></p>
    487. 

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

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

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

  490.         href="TDragDrop.htm#DragDetectionProblem"><font size="3"
    491. 

  491.         face="Arial">Problems With The Drag-Detection</font></a><font
    492. 

  492.         size="3" face="Arial">&quot;.</font></p>
    493. 

  493.         </td>
    494. 

  494.     </tr>
    495. 

  495.     <tr>
    496. 

  496.         <td bgcolor="#FFFFEF">&nbsp;</td>
    497. 

  497.     </tr>
    498. 

  498.     <tr>
    499. 

  499.         <td>&nbsp;</td>
    500. 

  500.         <td bgcolor="#008080"><a name="TargetHasDropHandler"><font
    501. 

  501.         color="#FFFFFF" size="5" face="Arial"><b>TargetHasDropHandler</b></font></a><font
    502. 

  502.         color="#FFFFFF" size="5" face="Arial"><b> </b></font><font
    503. 

  503.         color="#FFFF80" size="2" face="Arial"><b><i>published</i></b></font></td>
    504. 

  504.     </tr>
    505. 

  505.     <tr>
    506. 

  506.         <td>&nbsp;</td>
    507. 

  507.         <td bgcolor="#FFFFCC"><font face="Arial">You can use this
    508. 

  508.         method to determine, if a drop-target (file) has a
    509. 

  509.         drop-handler or not. Normally, you will use this method
    510. 

  510.         in the event </font><a href="TDragDrop.htm#OnDragOver"><font
    511. 

  511.         size="3" face="Arial"><em><strong>OnDragOver</strong></em></font></a><font
    512. 

  512.         size="3" face="Arial"> to determine, if visual updates
    513. 

  513.         are necessary (e.g. selecting a file etc.).</font></td>
    514. 

  514.     </tr>
    515. 

  515.     <tr>
    516. 

  516.         <td>&nbsp;</td>
    517. 

  517.         <td height="50">&nbsp;</td>
    518. 

  518.     </tr>
    519. 

  519. </table>
    520. 

  520. 

  521. <table border="0" width="600">
    522. 

  522.     <tr>
    523. 

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

  524.         <td rowspan="2" colspan="2" width="590"><font size="5"
    525. 

  525.         face="Arial">How Do I Use It As Drag&amp;Drop Source</font></td>
    526. 

  526.     </tr>
    527. 

  527.     <tr>
    528. 

  528.         <td>&nbsp;</td>
    529. 

  529.     </tr>
    530. 

  530.     <tr>
    531. 

  531.         <td>&nbsp;</td>
    532. 

  532.         <td valign="top"><font face="Arial">1.</font></td>
    533. 

  533.         <td><font face="Arial">Drop a TWinControl on the form
    534. 

  534.         (e.g. a listbox).</font></td>
    535. 

  535.     </tr>
    536. 

  536.     <tr>
    537. 

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

  538.         <td valign="top"><font face="Arial">2.</font></td>
    539. 

  539.         <td><font face="Arial">Choose the TWinControl (listbox)
    540. 

  540.         in </font><a href="TDragDrop.htm#DragDropControl"><font
    541. 

  541.         face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
    542. 

  542.         face="Arial">.</font></td>
    543. 

  543.     </tr>
    544. 

  544.     <tr>
    545. 

  545.         <td>&nbsp;</td>
    546. 

  546.         <td valign="top"><font face="Arial">3. </font></td>
    547. 

  547.         <td><font face="Arial">Choose the drag&amp;drop effects
    548. 

  548.         under </font><a href="TDragDrop.htm#SourceEffects"><font
    549. 

  549.         face="Arial"><em><strong>SourceEffects</strong></em></font></a><font
    550. 

  550.         face="Arial"> which the <em><strong>DragDropControl </strong></em>(listbox)
    551. 

  551.         should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
    552. 

  552.         serve as drag&amp;drop source all items must be set to
    553. 

  553.         false.</font></td>
    554. 

  554.     </tr>
    555. 

  555.     <tr>
    556. 

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

  557.         <td valign="top"><font face="Arial">4.</font></td>
    558. 

  558.         <td><font face="Arial">Now, your <em><strong>DragDropControl</strong></em>
    559. 

  559.         (listbox) must detect, if the user wants to start a
    560. 

  560.         drag&amp;drop operation. You can use the event
    561. 

  561.         &quot;OnMouseDown&quot; of your <em><strong>DragDropControl</strong></em>
    562. 

  562.         (listbox). Add following to the event:</font><blockquote>
    563. 

  563.             <p><font face="Arial"><code>DragDropFiles1.FileList.AddItem(&lt;absolute
    564. 

  564.             pidl of file, if available, or nil&gt;, &lt;selected
    565. 

  565.             item in </code></font><a
    566. 

  566.             href="TDragDrop.htm#DragDropControl"><font
    567. 

  567.             face="Arial"><code><em><strong>DragDropControl</strong></em></code></font></a><font
    568. 

  568.             face="Arial"><code> (listbox)&gt;);</code></font></p>
    569. 

  569.         </blockquote>
    570. 

  570.         <p><font face="Arial">You must add the filenames
    571. 

  571.         including the WHOLE PATH!!!</font></p>
    572. 

  572.         </td>
    573. 

  573.     </tr>
    574. 

  574.     <tr>
    575. 

  575.         <td>&nbsp;</td>
    576. 

  576.         <td valign="top"><font face="Arial">5.</font></td>
    577. 

  577.         <td valign="top"><font face="Arial">Tell Windows that
    578. 

  578.         there is a drag&amp;drop operation to handle: Just call
    579. 

  579.         the method </font><a href="TDragDrop.htm#Execute"><font
    580. 

  580.         face="Arial"><em><strong>Execute</strong></em></font></a><font
    581. 

  581.         face="Arial"> of this component. </font></td>
    582. 

  582.     </tr>
    583. 

  583.     <tr>
    584. 

  584.         <td valign="top">&nbsp;</td>
    585. 

  585.         <td valign="top"><font face="Arial">6.</font></td>
    586. 

  586.         <td valign="top"><font size="3" face="Arial">You may use
    587. 

  587.         the events </font><a href="TDragDrop.htm#OnGiveFeedback"><font
    588. 

  588.         size="3" face="Arial"><b><i>OnGiveFeedback</i></b></font></a><font
    589. 

  589.         size="3" face="Arial"> and </font><a
    590. 

  590.         href="TDragDrop.htm#OnQueryContinueDrag"><font size="3"
    591. 

  591.         face="Arial"><b><i>OnQueryContinueDrag</i></b></font></a><font
    592. 

  592.         size="3" face="Arial">, but often you need not.</font></td>
    593. 

  593.     </tr>
    594. 

  594.     <tr>
    595. 

  595.         <td valign="top">&nbsp;</td>
    596. 

  596.         <td valign="top">&nbsp;</td>
    597. 

  597.         <td valign="top">&nbsp;</td>
    598. 

  598.     </tr>
    599. 

  599.     <tr>
    600. 

  600.         <td valign="top">&nbsp;</td>
    601. 

  601.         <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
    602. 

  602.     </tr>
    603. 

  603.     <tr>
    604. 

  604.         <td valign="top">&nbsp;</td>
    605. 

  605.         <td valign="top" colspan="2"><ul>
    606. 

  606.             <li><font size="3" face="Arial">Drag&amp;drop
    607. 

  607.                 operations cannot be done at design-time!</font></li>
    608. 

  608.             <li><font size="3" face="Arial">IMPORTANT: If you use
    609. 

  609.                 the drag-detection, it's high recommended to
    610. 

  610.                 check the section &quot;</font><a
    611. 

  611.                 href="TDragDrop.htm#DragDetectionProblem"><font
    612. 

  612.                 size="3" face="Arial">Problems With The
    613. 

  613.                 Drag-Detection</font></a><font size="3"
    614. 

  614.                 face="Arial">&quot;.</font></li>
    615. 

  615.         </ul>
    616. 

  616.         </td>
    617. 

  617.     </tr>
    618. 

  618.     <tr>
    619. 

  619.         <td height="50">&nbsp;</td>
    620. 

  620.         <td colspan="2">&nbsp;</td>
    621. 

  621.     </tr>
    622. 

  622. </table>
    623. 

  623. 

  624. <table border="0" width="600">
    625. 

  625.     <tr>
    626. 

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

  627.         <td rowspan="2" colspan="2" width="590"><font size="5"
    628. 

  628.         face="Arial">How Do I Use It As Drag&amp;Drop Target</font></td>
    629. 

  629.     </tr>
    630. 

  630.     <tr>
    631. 

  631.         <td>&nbsp;</td>
    632. 

  632.     </tr>
    633. 

  633.     <tr>
    634. 

  634.         <td>&nbsp;</td>
    635. 

  635.         <td valign="top"><font face="Arial">1.</font></td>
    636. 

  636.         <td><font face="Arial">Drop a TWinControl on the form
    637. 

  637.         (e.g. a listbox).</font></td>
    638. 

  638.     </tr>
    639. 

  639.     <tr>
    640. 

  640.         <td>&nbsp;</td>
    641. 

  641.         <td valign="top"><font face="Arial">2.</font></td>
    642. 

  642.         <td><font face="Arial">Choose the TWinControl (listbox)
    643. 

  643.         in </font><a href="TDragDrop.htm#DragDropControl"><font
    644. 

  644.         face="Arial"><em><strong>DragDropControl</strong></em></font></a><font
    645. 

  645.         face="Arial">.</font></td>
    646. 

  646.     </tr>
    647. 

  647.     <tr>
    648. 

  648.         <td>&nbsp;</td>
    649. 

  649.         <td valign="top"><font face="Arial">3. </font></td>
    650. 

  650.         <td><font face="Arial">Choose the drag&amp;drop effects
    651. 

  651.         under </font><a href="TDragDrop.htm#TargetEffects"><font
    652. 

  652.         face="Arial"><em><strong>TargetEffects</strong></em></font></a><font
    653. 

  653.         face="Arial"> which the <em><strong>DragDropControl </strong></em>(listbox)
    654. 

  654.         should support. If you don't want any longer that the <em><strong>DragDropControl</strong></em>
    655. 

  655.         serve as drag&amp;drop target all items must be set to
    656. 

  656.         false.</font></td>
    657. 

  657.     </tr>
    658. 

  658.     <tr>
    659. 

  659.         <td>&nbsp;</td>
    660. 

  660.         <td valign="top"><font face="Arial">4.</font></td>
    661. 

  661.         <td><font size="3" face="Arial">Now, you have to program
    662. 

  662.         what happen, if the user drops files on your </font><a
    663. 

  663.         href="TDragDrop.htm#DragDropControl"><font size="3"
    664. 

  664.         face="Arial"><b><i>DragDropControl</i></b></font></a><font
    665. 

  665.         size="3" face="Arial"> (listbox). For this, the best is
    666. 

  666.         to use the event </font><a
    667. 

  667.         href="TDragDrop.htm#OnProcessDropped"><font size="3"
    668. 

  668.         face="Arial"><b><i>OnProcessDropped</i></b></font></a><font
    669. 

  669.         size="3" face="Arial">. At first, you should check what
    670. 

  670.         drag&amp;drop effect was chosen by the user. You get the
    671. 

  671.         effect from method's parameter <b><i>dwEffect</i></b>.
    672. 

  672.         You get the files from this component with following
    673. 

  673.         line:</font><blockquote>
    674. 

  674.             <p><font size="3" face="Arial"><code>...
    675. 

  675.             :=DragDropFiles1.FileList[&lt;Index&gt;]^.Name; <br>
    676. 

  676.             </code></font><font color="#000080" size="3"
    677. 

  677.             face="Arial"><code><strong><i>// returns the
    678. 

  678.             filename; if not available, the result is an empty
    679. 

  679.             string</i></strong></code></font><font size="3"
    680. 

  680.             face="Arial"><code><strong><br>
    681. 

  681.             </strong></code><code>...
    682. 

  682.             :=DragDropFiles1.FileList[&lt;Index&gt;]^.pidlFQ; <br>
    683. 

  683.             </code></font><font color="#000080" size="3"
    684. 

  684.             face="Arial"><code><strong><i>// returns the pidl; if
    685. 

  685.             not available, the result is nil</i></strong></code></font></p>
    686. 

  686.         </blockquote>
    687. 

  687.         <p><a href="#FileList"><font size="3" face="Arial"><b><i>FileList</i></b></font></a><font
    688. 

  688.         size="3" face="Arial"> is an instance of </font><a
    689. 

  689.         href="#TFileList_Info"><font size="3" face="Arial"><em><strong>TFileList</strong></em></font></a><font
    690. 

  690.         size="3" face="Arial">. For more info check </font><a
    691. 

  691.         href="#TFileList_Info"><font size="3" face="Arial">below</font></a><font
    692. 

  692.         size="3" face="Arial">. Now, do with the files what you
    693. 

  693.         have to do, e.g. copy, move, delete, etc.</font></p>
    694. 

  694.         </td>
    695. 

  695.     </tr>
    696. 

  696.     <tr>
    697. 

  697.         <td>&nbsp;</td>
    698. 

  698.         <td valign="top"><font face="Arial">5.</font></td>
    699. 

  699.         <td valign="top"><font size="3" face="Arial">You may use
    700. 

  700.         the events </font><a href="TDragDrop.htm#OnDragEnter"><font
    701. 

  701.         size="3" face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    702. 

  702.         size="3" face="Arial">, </font><a
    703. 

  703.         href="TDragDrop.htm#OnDragOver"><font size="3"
    704. 

  704.         face="Arial"><b><i>OnDragOver</i></b></font></a><font
    705. 

  705.         size="3" face="Arial"> and </font><a
    706. 

  706.         href="TDragDrop.htm#OnDragLeave"><font size="3"
    707. 

  707.         face="Arial"><b><i>OnDragLeave</i></b></font></a><font
    708. 

  708.         size="3" face="Arial">, but often you need not.</font></td>
    709. 

  709.     </tr>
    710. 

  710.     <tr>
    711. 

  711.         <td valign="top">&nbsp;</td>
    712. 

  712.         <td valign="top">&nbsp;</td>
    713. 

  713.         <td valign="top">&nbsp;</td>
    714. 

  714.     </tr>
    715. 

  715.     <tr>
    716. 

  716.         <td valign="top">&nbsp;</td>
    717. 

  717.         <td valign="top" colspan="2"><font face="Arial"><strong>Hints:</strong></font></td>
    718. 

  718.     </tr>
    719. 

  719.     <tr>
    720. 

  720.         <td valign="top">&nbsp;</td>
    721. 

  721.         <td valign="top" colspan="2"><ul>
    722. 

  722.             <li><font size="3" face="Arial">Drag&amp;drop
    723. 

  723.                 operations cannot be done at design-time!</font></li>
    724. 

  724.         </ul>
    725. 

  725.         </td>
    726. 

  726.     </tr>
    727. 

  727.     <tr>
    728. 

  728.         <td height="50">&nbsp;</td>
    729. 

  729.         <td colspan="2">&nbsp;</td>
    730. 

  730.     </tr>
    731. 

  731. </table>
    732. 

  732. 

  733. <table border="0" width="600">
    734. 

  734.     <tr>
    735. 

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

  736.         <td rowspan="2" width="590"><a name="TFileList_Info"><font
    737. 

  737.         size="5" face="Arial">Details about <strong>TFileList</strong></font></a></td>
    738. 

  738.     </tr>
    739. 

  739.     <tr>
    740. 

  740.         <td>&nbsp;</td>
    741. 

  741.     </tr>
    742. 

  742.     <tr>
    743. 

  743.         <td>&nbsp;</td>
    744. 

  744.         <td><font size="3" face="Arial"><b><i>TFileList</i></b>
    745. 

  745.         is a child of <b><i>TList</i></b>. Therefore, I don't
    746. 

  746.         explain the list, again. You can find a documentation in
    747. 

  747.         the online-help. Now, the new features of <b><i>TFileList</i></b>:</font><p><font
    748. 

  748.         size="3" face="Arial">You add items to the list with the
    749. 

  749.         function <b><i>AddItem</i></b> (or <b><i>AddItemEx</i></b>,
    750. 

  750.         if you want to use mapped filenames). The function make
    751. 

  751.         itself a copy of the pidl (absolute needed!) to relieve
    752. 

  752.         you of this dirty job. If you don't know the pidl, set
    753. 

  753.         the parameter to nil. If you don't know or have the
    754. 

  754.         filename (including the whole path), set this parameter
    755. 

  755.         to a emtpy string.</font></p>
    756. 

  756.         <p><font size="3" face="Arial">You can delete items or
    757. 

  757.         clear as common to lists. You needn't care about
    758. 

  758.         releasing resources - the <b><i>TFileList</i></b> cares
    759. 

  759.         about itself!</font></p>
    760. 

  760.         <p><font size="3" face="Arial">Besides, there are the
    761. 

  761.         functions <b><i>RenderPIDLs</i></b> and <b><i>RenderNames</i></b>.
    762. 

  762.         <b><i>RenderPIDLs</i></b> tries to get the according
    763. 

  763.         pidls to the filenames in the list. <b><i>RenderNames</i></b>
    764. 

  764.         tries to get the according filenames (including full
    765. 

  765.         path) to the pidls in the list. If the functions succeed
    766. 

  766.         the result is true else false. You need not to call them
    767. 

  767.         before a drag&amp;drop operation. This will be
    768. 

  768.         automaticly done by the component itself, if you set the
    769. 

  769.         property <b><i>CompleteFileList</i></b> to true. But it
    770. 

  770.         may be useful to call them after receiving data to
    771. 

  771.         complete the list. </font></p>
    772. 

  772.         </td>
    773. 

  773.     </tr>
    774. 

  774.     <tr>
    775. 

  775.         <td height="50">&nbsp;</td>
    776. 

  776.         <td>&nbsp;</td>
    777. 

  777.     </tr>
    778. 

  778. </table>
    779. 

  779. 

  780. <table border="0" width="600">
    781. 

  781.     <tr>
    782. 

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

  783.         <td rowspan="2" width="590"><a name="pidl_Info"><font
    784. 

  784.         size="5" face="Arial">Details about <strong>PIDL</strong>s</font></a></td>
    785. 

  785.     </tr>
    786. 

  786.     <tr>
    787. 

  787.         <td>&nbsp;</td>
    788. 

  788.     </tr>
    789. 

  789.     <tr>
    790. 

  790.         <td>&nbsp;</td>
    791. 

  791.         <td><font size="3" face="Arial">Since Win95 the
    792. 

  792.         file-system is more difficult. It is object orientated
    793. 

  793.         and is named &quot;namespace&quot;. Every file, folder,
    794. 

  794.         etc. is an object in the object-tree of the namespace.
    795. 

  795.         Every object is an instance of the class <b><i>IShellFolder</i></b>
    796. 

  796.         (more info in the online-help). If you have the instance
    797. 

  797.         of the object, you can many do. E.g. you can determine
    798. 

  798.         the properties (attributes) of the object (is it a file?,
    799. 

  799.         is it a folder?, can I copy it?, ...). Every object can
    800. 

  800.         be identified by an ID: the <b><i>pidl</i></b>. By the
    801. 

  801.         pidl you can determine the IShellFolder-instance (use the
    802. 

  802.         enclosed unit &quot;pidl&quot;; description only in the
    803. 

  803.         code available).</font><p><font size="3" face="Arial">Pay
    804. 

  804.         attention about relative and absolute pidls. The instance
    805. 

  805.         itself has only a relative pidl (sometimes named as
    806. 

  806.         &quot;item pidl&quot;). The path of concatenated pidls
    807. 

  807.         from the root-object (desktop) to the child-object is the
    808. 

  808.         absolute pidl! Pay attentions about this difference. You
    809. 

  809.         can quickly fooled!</font></p>
    810. 

  810.         <p><font size="3" face="Arial">Very important: Shortscuts
    811. 

  811.         are only possible, if the pidl is available.</font></p>
    812. 

  812.         </td>
    813. 

  813.     </tr>
    814. 

  814.     <tr>
    815. 

  815.         <td height="50">&nbsp;</td>
    816. 

  816.         <td>&nbsp;</td>
    817. 

  817.     </tr>
    818. 

  818. </table>
    819. 

  819. 

  820. <table border="0" width="600">
    821. 

  821.     <tr>
    822. 

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

  823.         <td rowspan="2" width="590"><font size="5" face="Arial">Details
    824. 

  824.         about <strong>mapped filenames</strong></font></td>
    825. 

  825.     </tr>
    826. 

  826.     <tr>
    827. 

  827.         <td>&nbsp;</td>
    828. 

  828.     </tr>
    829. 

  829.     <tr>
    830. 

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

  831.         <td><font size="3" face="Arial">If a mapped filename is
    832. 

  832.         set, the source inform you, that you have to rename the
    833. 

  833.         received name into the mapped name after to
    834. 

  834.         d&amp;d-operation. The mapped filenames are used, if you
    835. 

  835.         drag files from the &quot;RecycleBin&quot;.</font></td>
    836. 

  836.     </tr>
    837. 

  837.     <tr>
    838. 

  838.         <td height="50">&nbsp;</td>
    839. 

  839.         <td>&nbsp;</td>
    840. 

  840.     </tr>
    841. 

  841. </table>
    842. 

  842. 

  843. <table border="0" width="600">
    844. 

  844.     <tr>
    845. 

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

  846.         <td rowspan="2" width="590"><font size="5" face="Arial">FAQ</font></td>
    847. 

  847.     </tr>
    848. 

  848.     <tr>
    849. 

  849.         <td>&nbsp;</td>
    850. 

  850.     </tr>
    851. 

  851.     <tr>
    852. 

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

  853.         <td><font size="3" face="Arial"><b>Q:</b> My application
    854. 

  854.         supports only some special file-formats. How can I forbid
    855. 

  855.         the other formats during the drop?</font><p><font
    856. 

  856.         size="3" face="Arial"><b>A:</b> Set the property </font><a
    857. 

  857.         href="TDragDrop.htm#RenderOn"><font size="3" face="Arial"><em><strong>RenderOn</strong></em></font></a><font
    858. 

  858.         size="3" face="Arial"> to <b><i>rdoDropEnterAndDropSync</i></b>
    859. 

  859.         and check out the </font><a href="#FileList"><font
    860. 

  860.         size="3" face="Arial"><em><strong>Filelist</strong></em></font></a><font
    861. 

  861.         size="3" face="Arial"> in the event </font><a
    862. 

  862.         href="TDragDrop.htm#OnDragEnter"><font size="3"
    863. 

  863.         face="Arial"><b><i>OnDragEnter</i></b></font></a><font
    864. 

  864.         size="3" face="Arial">. Set the parameter <em><strong>Accept</strong></em>
    865. 

  865.         in this event to true, if your application support the
    866. 

  866.         files in the <em><strong>Filelist</strong></em> otherwise
    867. 

  867.         set the parameter to false. If you only use the first
    868. 

  868.         file, check only the first item in the <em><strong>Filelist</strong></em>.</font></p>
    869. 

  869.         </td>
    870. 

  870.     </tr>
    871. 

  871.     <tr>
    872. 

  872.         <td height="50">&nbsp;</td>
    873. 

  873.         <td>&nbsp;</td>
    874. 

  874.     </tr>
    875. 

  875. </table>
    876. 

  876. 

  877. <table border="0" width="600">
    878. 

  878.     <tr>
    879. 

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

  880.         <td rowspan="2" width="590"><font size="5" face="Arial">Known
    881. 

  881.         Bugs</font></td>
    882. 

  882.     </tr>
    883. 

  883.     <tr>
    884. 

  884.         <td>&nbsp;</td>
    885. 

  885.     </tr>
    886. 

  886.     <tr>
    887. 

  887.         <td>&nbsp;</td>
    888. 

  888.         <td><ul>
    889. 

  889.             <li><font size="3" face="Arial">Shortcuts are only
    890. 

  890.                 possible, if the pidl is available (not really a
    891. 

  891.                 bug) </font></li>
    892. 

  892.         </ul>
    893. 

  893.         </td>
    894. 

  894.     </tr>
    895. 

  895.     <tr>
    896. 

  896.         <td height="50">&nbsp;</td>
    897. 

  897.         <td>&nbsp;</td>
    898. 

  898.     </tr>
    899. 

  899. </table>
    900. 

  900. 

  901. <hr>
    902. 

  902. 

  903. <p><font size="3" face="Arial"><i>© 1998,99 by </i></font><a
    904. 

  904. href="mailto:[email protected]"><font size="3" face="Arial"><i>Dieter
    905. 

  905. Steinwedel</i></font></a><font size="3" face="Arial"> </font></p>
    906. 

  906. 

  907. <p><a href="Index.htm"><font face="Arial">Back</font></a><font
    908. 

  908. face="Arial"> to index</font></p>
    909. 

  909. </body>
    910. 

  910. </html>
    911.