readme.htm

delphi开发的文件搜索组件。 速度极快。

            <td WIDTH="20%" NOWRAP VALIGN="TOP"><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">ExactMatch := False;</font></td> 
            <td><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">{ TFindFile locates for files by Read-only <b>OR</b> Hidden attribute bit set. }</font></td> 
          </tr> 
          <tr> 
            <td WIDTH="20%" NOWRAP VALIGN="TOP"><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">ExactMatch := True;</font></td> 
            <td><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">{ TFindFile locates for files by Read-only <b>AND</b> Hidden attribute bit set. }</font></td> 
          </tr> 
        </table> 
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br> 
        </font></li> 
    </ul> 
    <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">AttributeEx: TAttributeExCriteria<br> 
      </font></b><font SIZE="2">Contains NT file attributes criteria.<b><br>
      <br>
      </b>
      <b> 
      </b></font></font> </li> 
    <ul> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Archive: TFileAttributeStatus<br>
        </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
        </b></font></font><font SIZE="2">
        </font></b><font SIZE="2"> 
         Determines the desired status of the archive attribute for the target file(s). </font></font><br>
         <br> 
    </li> 
    </ul> 
    <ul> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Readonly: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">            </font></b><font SIZE="2"> Determines the desired status of the readonly attribute for the target file(s). </font></font><br>
      <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Hidden: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the hidden attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">System: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the system attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Directory: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the directory attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Compressed: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the compressed attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Encrypted: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the encrypted attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Offline: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the offline attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">ReparsePoint: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the re-parse point attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">SparseFile: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the sparse file attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font></li>
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Temporary: TFileAttributeStatus<br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> </font><font FACE="Verdana, Arial, Helvetica, sans-serif"><font SIZE="2"><strong>TFileAttributeStatus = (fsIgnore, fsSet, fsUnset)</strong> <b><br>
      </b></font></font></b></font><font SIZE="2">              </font></b><font SIZE="2"> Determines the desired status of the temporary attribute for the target file(s). </font></font><br>
        <font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br>
      </font><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">        </font></li>
    </ul> 
    <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Size: TSizeCriteria</b><br> 
      Contains file size criteria.<br> 
      <br> 
      </font></li> 
    <ul> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Min: TFileSize<br>
        TFileSize = Int64 /* for Delphi 3 it is DWORD */<br>
        </b> Determines the lower range of the file size. Set this property to zero if you do not need this limit.<br> 
        <br> 
      </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Max: TFileSize<br>
        TFileSize = Int64 /* for Delphi 3 it is DWORD */<br> 
        </b> Determines the upper range of the file size. Set this property to zero if you do not need this limit.<br> 
        <br> 
      </font></li> 
    </ul> 
    <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">TimeStamp: TDateTimeCriteria</font></b><font SIZE="2"><br> 
      Contains file date and time criteria.<br> 
      <br> 
      </font></font></li> 
    <ul> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">CreatedAfter: TDateTime</font></b><font SIZE="2"><br> 
        Determines the lower range of the file creation date and time. To ignore lower date limit, set date part to zero and to ignore lower time limit, set time part to zero.<br> 
        <br> 
        </font></font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2"> CreatedBefore: TDateTime</font></b><font SIZE="2"> <br> 
        Determines the upper range of the file creation date and time. To ignore upper date limit, set date part to zero and to ignore upper time limit, set time part to zero.<br> 
        <br> 
        </font></font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>ModifiedAfter: TDateTime</b><br> 
        Determines the lower range of the file last modified date and time. To ignore lower date limit, set date part to zero and to ignore lower time limit, set time part to zero.<br> 
        <br> 
        </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>ModifiedBefore: TDateTime</b><br> 
        Determines the upper range of the file last modified date and time. To ignore upper date limit, set date part to zero and to ignore upper time limit, set time part to zero.<br> 
        <br> 
        </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>AccessedAfter: TDateTime</b> <br> 
        Determines the lower range of the file last accessed date and time. To ignore lower date limit, set date part to zero and to ignore lower time limit, set time part to zero.<br> 
        <br> 
        </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>AccessedBefore: TDateTime</b><br> 
        Determines the upper range of the file last accessed date and time. To ignore upper date limit, set date part to zero and to ignore upper time limit, set time part to zero.<br> 
        <br> 
        </font></li> 
    </ul> 
    <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Content: TContentCriteria</font></b><font SIZE="2"><br> 
      Contains criteria about the file(s) content.<br> 
      </font></font><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><br> 
      </font></li> 
    <ul> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><font SIZE="2">Phrase: String<br> 
        </font></b><font SIZE="2"> Specifies the text that should be located in the content of the file(s). Set this property to empty if you do not need this option.<br> 
        <br> 
        </font></font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>IgnoreCase: Boolean</b><br> 
        If set to true, the component performs a case insensitive search to locate the phrase inside the file.<br> 
        <br> 
        </font></li> 
      <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>WholeWord: Boolean</b><br> 
        If set to true, the component searches for whole words only.<br> 
        <br> 
        </font></li> 
    </ul> 
  </ul> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Aborted: Boolean</b> (Read-only)<br> 
    When is true, indicates that the last search has been aborted.<br> 
    <br> 
    </font></li> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Busy: Boolean</b> (Read-only)<br> 
    When is true a search is running and it is not finished yet.<br> 
    <br> 
    </font></li> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>CurrentLevel: Word</b> (Read-only)<br> 
    Determines on which directory level search is running now.<br> 
    <br> 
    </font></li> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>Threaded: Boolean</b><br> 
    If set to true, the component a separated thread for its process.<br> 
    <br> 
    </font></li> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>ThreadPriority: TThreadPriority</b><br> 
    Determines priority of the thread when component is in threaded mode.</font></li> 
</ul> 
<p><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><a NAME="METHODS"></a><br> 
  <font SIZE="4">METHODS</font></b></font></p> 
<ul> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>procedure Execute<br> 
    </b> Starts the search process. <br> 
    <br> 
    </font></li> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b> procedure Abort<br> 
    </b> Aborts the search and sets the aborted property to true. Calling <i>Abort</i> method does not mean that it halts the search immediately. You have to use <i>OnSearchFinish</i> event to know exactly when the search is stopped.</font></li> 
</ul> 
<p><font FACE="Verdana, Arial, Helvetica, sans-serif"><b><a NAME="EVENTS"></a><br> 
  <font SIZE="4">EVENTS</font></b></font></p> 
<ul> 
  <li><font FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><b>OnFileMatch: TFileMatchEvent<br> 
    </b> <b>TFileMatchEvent = procedure (Sender: TObject; const Folder: String; const FileInfo: TSearchRec) of object<br> 
    </b> <font COLOR="#990000">NOTE: In threaded mode, the event handler calls by the search thread, not the main VCL thread.</font><br> 
    This event will be triggered when a file matches with the search criteria. <i>&quot;Folder&quot;</i> specifies the location of the file and <i>&quot;FileInfo&quot;</i> contains the file information details (Name, Size, Time, Attr, and...).<br> 
    <br>