FilterDialog

The FilterDialog (FD) allows you to select for display, a subset of all 
entries in the ScrolledList of the screen from which the dialog is popped up.

The selection criteria involves a number of column fields from the 
ScrolledList. Each column field displayed on a FilterDialog may be set up 
with a pattern value.  Two types of pattern specification exist. A user can 
specify one of a number of predefined values for a column field by selecting
a value from an OptionMenu.  If a TextField is displayed beside the column 
field, a basic regular expression may be specified by typing a pattern in the
TextField. A basic regular expression of ordinary characters matches a string
of the same character format when compared to a column field value. For example,
the basic regular expression 'abc' matches the field value 'abc' but not 'abd'.

Basic regular expressions may also contain characters that have special 
meaning depending on their relative position in the regular expression. When 
these characters are used in a comparison they can take on a different 
meaning compared to ordinary characters. Special characters include:

     .            matches a single occurence of any printable or 
                  nonprintable character except a newline character.

     *            matches zero or more occurences of the character
                  preceding it. If its the first character of a regular
                  expression it is treated as an ordinary character.

     [            indicates the start of a bracket expression.

     $            is special when specified as the last character of a 
                  regular expression, otherwise its an ordinary character.

     ^            is special when specified as the first character of a 
                  regular expression, otherwise its an ordinary character.

     \            any special character preceded with a backslash is
                  treated as an ordinary character. 

These characters may take on different meanings when used inside a bracket
expression. See the man pages on regexp(5) for full details of the basic
regular expression on your machine.              

Once the Filter Dialog column fields are set up with the criteria to match 
the required entries from the ScrolledList, the Apply button may be 
pressed. Sun MTPScan extracts the entries that match all column specifications
and places them in the ScrolledList. The Visible Count value is updated
to reflect the number of matching visible entries in the ScrolledList.
The labels showing the current filter pattern of filter fields are 
updated above the column title header of the ScrolledList.

The Ok button performs the same action as the Apply button. In addition, it
will close the dialog.

The Default button sets all column fields in the Filter Dialog with the 
pattern values that will display all ScrolledList entries when applied. 
The Apply or the Ok buttons must still be pressed to actually apply the
filter specifications.

The Cancel button retains the current column values and closes the dialog.

See also: Dialog, OptionMenu, ScrolledList, TextField.  
