Define Watch List

The Define Watch List dialog box appears when you choose New Watch List... on the Files and folders page or when you click New... or Edit... in the Watch Lists dialog box. It is based on the standard Windows Open dialog, but adds the filter definition used for the folder's watch list.

The upper portion of the dialog, including the Open and Cancel buttons, works as normal with one exception: the Open button only works to apply a new filter on the displayed files or to enter a different folder; it does not close the dialog box.

To close the dialog box with a new watch list, click Add as filter; to close the dialog box without changes, click Cancel.

Dialog fields and options

This dialog box contains the following fields and options.

Attribute	Description
Include Hidden	Check this box to include files that match the File filter pattern even if they are marked Hidden. In many cases, Hidden files are auxiliary files that should not be installed, but are instead created automatically by the application or Windows. For example, Windows Help uses Hidden files for keyword search and indexing information; these files are automatically re-created as needed and should not be installed separately.
Include System	Check this box to include files that match the File filter pattern even if they are marked System. In many cases, System files are special-purpose files that should not be installed as part of the normal Setup process.
Include Setup files	Check this box to include files that match the File filter pattern even if they are part of Setup applications; clear it to omit them. The reason to omit them is that InstallMate automatically installs its own Setup files for the project (specifically, Setup.exe and Setup.dat); if you include others yourself, this might cause unintended interactions between InstallMate's Setup files and others. Moreover, they would not serve any useful purpose and just take up space in the distribution package.
Include empty files	Check this box to include files that match the File filter pattern even if they are empty, i.e., have a file size of 0. Although these files will install correctly, they are often used as markers or lock files that should not be installed, but are instead created by the application when needed.
Include subfolders	Check this box to add all eligible files from subfolders in addition to the files in the current folder. InstallMate applies the same filter patterns and inclusion or exclusion criteria to files in subfolders as it does for files in the main folder. Note: These criteria are not applied to the subfolders themselves; that is, all subfolders will be searched, whether or not their names match any of the filter patterns or other attributes.
Preserve folders	Check this box if you checked Include subfolders and want to preserve the existing folder structure. In that case, InstallMate will add not just all matching files, but will also re-create the subfolder tree on the Files and folders page. If you clear this box, all files will end up in the main folder, in effect "flattening" the original folder tree.
Include empty folders	Check this box if you checked both Include subfolders and Preserve folders and want to include all subfolders, even if they do not contain files or subfolders with files. If you clear this box, InstallMate will only re-create non-empty subfolders on the Files and folders page.
Exclude files matching	Enter the file filter patterns for files to exclude even if they pass all other criteria. This option is intended to filter out classes of files that typically are used for "scratch" purposes only, or should otherwise not be installed as files. The default pattern list filters out backup files, various temporary and system files, and shortcut (.lnk) files that cannot be reliably installed as simple files, but should be re-created on the Files and folders page instead.
Add with filter	Click this button to accept the current filter expression and close the dialog box.
Reset filter	Click this button to reset all filter settings to the values they had when you opened the Define Watch List dialog box, i.e., the settings that you used the last time. This command is useful to quickly restore the filter settings.
Defaults	Click this button to reset all filter settings to the "factory" defaults. This is useful if you have modified the filters extensively and want to restart with reasonable defaults.
Automatic component assignment	Select this option to assign the files and folders to the same component as their parent folder, or to a newly generated WATCHxxx component.
Assign to component	Select this option to assign the files and folders to a named component. You can select the component by clicking on the Select... button.
Select...	Click this button to open the Select Component dialog box. This dialog box lets you select an existing component, or create a new one if desired.