Common Dialog Custom Control: FilterIndex Can Be Negative

Last reviewed: June 21, 1995
Article ID: Q80934

The information in this article applies to:

- Professional Edition of Microsoft Visual Basic for Windows, versions

  2.0 and 3.0

- Microsoft Professional Toolkit for Microsoft Visual Basic programming

  system for Windows, version 1.0

SUMMARY

The FilterIndex property of the Common Dialog custom control (COMMDLG.DLL) can be any long integer value, including negative numbers and 0 (zero).

MORE INFORMATION

Normally, the smallest value to which you would set the FilterIndex property is 1, because the first filter is defined as 1. If you use a number less than 1, such as 0 or any negative number (within the range of a long integer), you will get the same result as if you set it equal to 1.

Likewise, if you use a number greater that the total number of filters, the FilterIndex property will function as if you set it to the last of the filters.

For example, if you have three filters and you set FilterIndex to -2, it will function as if you set FilterIndex to 1. If you set FilterIndex to 23, it will function as if you set FilterIndex to 3.

Additional reference words: 1.00 2.00 3.00
KBCategory: kbprg
KBSubcategory: PrgCtrlsStd

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: June 21, 1995
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.