home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1998 April A / Pcwk4a98.iso / PROGRAM / DELPHI16 / Filefind / FILEFIND.TXT < prev    next >
Text File  |  1995-12-12  |  4KB  |  106 lines
  1. Readme file for TFileFind Component
  2.  
  3. I beg your pardon for any mistake, my mother language is Portuguese.
  4.  
  5. 1. CONTENTS OF FILEFIND.ZIP
  6.  
  7. This zipped pack has the following files:
  8.  
  9. . README.WRI    Write version version of this file
  10. . FILEFIND.TXT    This file
  11. . FILEFIND.PAS    Complete sourcecode of TFileFind component
  12. . FFDEMO.DPR    Demo of TFileFind
  13. . FFDEMO.RES    "    "
  14. . FFMAIN.PAS    "    "
  15. . FFMAIN.DFM    "    "
  16.  
  17. 2. HOW TO INSTALL
  18.  
  19. You may install this component like any other Delphi VCL Component. Just install the
  20. FILEFIND.PAS module. The FileFind component will be added in the Samples page.
  21.  
  22. 3. WHAT FOR IS THIS COMPONENT?
  23.  
  24. TFindFile is a full featured component very useful that implements file search. It works 
  25. very like The Norton FileFind (Norton Utilities), although the text search has not been 
  26. implemented (yet). You can use wildcards to make a search mask.
  27.  
  28. 4. HOW DOES IT WORK?
  29.  
  30. Once installed in the VCL pallete, a TFileFind can be dropped in the form and adjusted 
  31. to works on your purpose. The FFDEMO project shows the most of the capabilities of 
  32. TFileFind. See the events (OnChangeDirectory, OnChangeDrive, OnMatch and OnStop) and the
  33. OnClick events of the buttons Start an Stop.
  34.  
  35. The keys properties are:
  36.  
  37. DriveList: Holds the drives to search. For example, to search in A:, B: and C: just put 
  38. 'ABC' on DriveList. An empty string forces search in all existent drives (A: to Z:)
  39.  
  40. FileName: File to find. You can use wildcards. If a drive letter is present here, it 
  41. will be used instead DriveList. If a directory name is present here, it will be used as 
  42. starting directory.
  43.  
  44. SearchScope: ssCurrentDir: searches only in the current directory (or directory in 
  45. FileName); ssCurrentAndBellow: searches in the current directory (or directory in 
  46. FileName) and bellow; or ssEntireDisk force search in the whole disk.
  47.  
  48. StopOnFirsMatch: if true, the search finishes on the first match. It's very useful when
  49. you are looking for at least one occurrence of the file. If no file was found, LastMatch 
  50. holds an empty string.
  51.  
  52. The most important property is read only:
  53.  
  54. LastMatch: holds the last file found by the engine.
  55.  
  56. There are 4 event handlers available:
  57.  
  58. OnChangeDirectory: whenever the engine changes the directory. Useful to show the current
  59. directory.
  60.  
  61. OnChangeDrive: whenever the engine changes the drive. Useful to show the current drive.
  62.  
  63. OnMatch: whenever the engine finds a file. Remember, the LastMatch holds the path of the
  64. last found file. You process the filename here!
  65.  
  66. OnStop: whenever the Stop method is called. Useful to have a user's confirmation before
  67. to shut down the search.
  68.  
  69. There are just 2 methods:
  70.  
  71. Start: to start the search.
  72.  
  73. Stop: to cancel the running search. In this case, and only in this case, an OnStop event is
  74. triggered.
  75.  
  76. You don't need to use Stop after a search, to 'close' or finish it. This method is only 
  77. used to abort the search.
  78.  
  79. 5. DISCLAIMER
  80.  
  81. I do not assume responsibility for any harm or rack due the use of this software program,
  82. although I believe it is quite harmless as you can see on its sourcecode. You can remove
  83. bugs yourself since the sourcecode is available. If you find a bug, please let me know.
  84.  
  85. TFileFind is a freeware. Feel free to use this software in your own Delphi applications.
  86. You don't have to pay me any fee, although you are not allowed to charge any license fee
  87. for components you have derived from TFileFind. You cannot change and redistribute the
  88. sourcecode. If you think this software will be useful for you, just send me a postal card
  89. from your town. I am wonder to know how far this package has got!
  90.  
  91. 6. HOW TO REACH ME
  92.  
  93. I will be pleased if you send me comments, questions or suggestions,  and of course, if
  94. you find a bug, please let me know. My addresses are (postal and e-mail):
  95.  
  96. Gabriel Cherem
  97. Rua Manfredo Leite 136
  98. Stodieck
  99. 88025-110 Florianopolis, SC
  100. BRAZIL
  101.  
  102. e-mail: egr7jmc@npd.ufsc.br
  103.  
  104.  
  105. ------------------------------------------------------------------------------
  106. TFileFind for Delphi VCL, by Gabriel Cherem, dec 1995