[Overview][Constants][Types][Classes][Procedures and functions][Index] Reference for unit 'FileUtil' (#lazutils)

TFileSearcher.OnFileFound

Event handler signalled when a file matching the file mask is found in the Search method.

Declaration

Source position: fileutil.pas line 153

public property TFileSearcher.OnFileFound : TFileFoundEvent
  read FOnFileFound
  write FOnFileFound;

Description

OnFileFound is a TFileFoundEvent property with the event handler signalled when a file matching the search criteria is found in the Search method. It is signalled for each file that matches the search path and file mask arguments passed to the method. The event occurs after values in the Path, FileInfo, and Level properties have been updated in the file iterator.

An application must implement and assign an object procedure to the handler to respond to the event notification. The FileIterator argument is the TFileIterator instance for the event notification, and allows access to its properties and methods. Call the Stop method in FileIterator to stop the search process.

Use OnDirectoryFound to respond to directory names found in the Search method.

Use OnDirectoryEnter to respond to a new directory processed in the Search method.

See also

TFileSearcher.Search

  

Searches for files or directories in the specified path(s) using the specified options.

TFileSearcher.DirectoryAttribute

  

File attribute needed for directories considered a match in the Search method.

TFileSearcher.OnDirectoryFound

  

Event handler signalled when a new directory is found in the Search method.

TFileSearcher.OnDirectoryEnter

  

Event handler signalled when a new directory is processed in the Search method.

TFileIterator

  

Implements an iterator for file and directory names on the local file system.

TFileIterator.Path

  

Contains the path to the current file or directory in the iterator.

TFileIterator.FileInfo

  

Contains file information for the current entry in the iterator.

TFileIterator.Level

  

Gets the current directory level relative to the base search path.

TFileFoundEvent

  

Specifies an event handler signalled when a file name is found for the specified iterator.


Version 3.2 Generated 2024-02-25 Home