Microsoft KB Archive/80935

From BetaArchive Wiki
Knowledge Base


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

Article ID: 80935

Article Last Modified on 11/18/2003



APPLIES TO

  • Microsoft Visual Basic 2.0 Professional Edition
  • Microsoft Visual Basic 3.0 Professional Edition
  • Microsoft Professional Toolkit for Microsoft Visual Basic programming system for Windows



This article was previously published under Q80935

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.


Additional query words: 1.00 2.00 3.00

Keywords: KB80935