Recurse property

Recurse property

Applies to

Declaration

property Recurse: Boolean;

Description

The Recurse property determines whether subdirectories will be recursed to look for files to be compressed when zipping with a wildcard mask. Set to true if you wish subdirectories to be traversed.

If this value is set to True, and a wildcard mask is specified in the FilesList without any path information, then the value of the RootDir Property will determine which directory zipping will start in. Results may be unexpected or even bad if you do not supply path information either in the FilesList or the RootDir Property.

NOTE: Overriding the Recurse Propery for some FilesList entries:

By adding the following characters to the beginning of the filenames being added to the FilesList, you can override whatever the current setting is for the RECURSE property:

'>' will force recursion into subdirectories '|' will force NO-recursion

For instance:

VCLZip1.FilesList.add('>c:\windows\*.ini');

will get all .ini files in and below the windows directory reguardless of what the recurse property setting is.

and:

VCLZip1.FilesList.add('|c:\windows\sys*\*.dll');

will get all .dll files in subdirectories of the windows directories that start with 'sys' but will not recurse into any directories below the sys* directories.

It is important to note that this is only useful for zipping, not unzipping operations.