Common Dialog Control: Pipe (|) Optional in Filter Property (80935)

SUMMARY

The pipe character (|), which is placed at the end of each selection in the Filter property of the Common Dialog custom control, is optional on the last item in the string.

This information applies to the Common Dialog custom control supplied with Microsoft Professional Toolkit for Microsoft Visual Basic programming system version 1.0 for Windows and with the Professional Edition of Visual Basic version 2.0 for Windows.

MORE INFORMATION

Filter is a property of the Common Dialog custom control (COMMDLG.DLL). The Filter property is assigned a string that contains sets of "description" and "filter". Each set represents one entry in the List Files of Type list box.

Each of these items in the string are followed by a pipe character (|). The last item in the list need not be followed by a pipe, although it is allowed.

The syntax for using the Filter property is as follows:

   CommonDialog.Filter[= desc1$|filter1$|desc2$|filter2$]

Either of the following code examples will work:

   CMDialog1.Filter = "Text Files (*.txt)|*.txt"

-or-

   CMDialog1.Filter = "Text Files (*.txt)|*.txt|"

The Microsoft Visual Basic Professional Toolkit documentation uses both of these methods in its code examples.