filter

Type: String

Default Value: "All files|*.*"

The filter property of the CMDFileSave class contains the filters that are displayed in the Type list box of the common File Save dialog. Use this property to provide the user with a list of filters that can be selected when the dialog is displayed.

A filter specifies the type of files that are displayed in the File list box of the dialog; for example, select the *.txt filter to display all text files. Each type consists of two parts, as follows.

• A description that is displayed to the user

• The actual file type; for example, *.txt for text files

Use the pipe (|) symbol to separate each of the description and filter arguments. Do not include spaces before or after the pipe symbol, as these spaces are then displayed with the description and filter values. The following text shows an example of a filter that enables the user to choose text files or picture files that include bitmaps and icons.

Text (*.txt)|*.txt|Pictures(*.bmp;*.ico)|*.bmp;*.ico

Use the filterIndex property to determine which filter is displayed as the default when you specify more than one filter for a dialog.