PRJ: Creating a Multi-Line Filter Using the FilterEdit Method (126941)



The information in this article applies to:

  • Microsoft Project 98 for Windows
  • Microsoft Project for Windows 95 4.1
  • Microsoft Project for Windows 95 4.1a
  • Microsoft Project for Windows 4.0

This article was previously published under Q126941

SUMMARY

In Microsoft Project, you can use the FilterEdit method in a Visual Basic, Applications Edition, macro to create a multi-line filter using the NewFieldName argument in Microsoft Project.

MORE INFORMATION

To create this filter, follow the procedure below.

Microsoft provides examples of Visual Basic procedures for illustration only, without warranty either expressed or implied, including but not limited to the implied warranties of merchantability and/or fitness for a particular purpose. This Visual Basic procedure is provided 'as is' and Microsoft does not guarantee that it can be used in all situations. Microsoft does not support modifications of this procedure to suit customer requirements for a particular purpose. Note that a line that is preceded by an apostrophe introduces a comment in the code--comments are provided to explain what the code is doing at a particular point in the procedure. Note also that an underscore character (_) indicates that code continues from one line to the next. You can type lines that contain this character as one logical line or you can divide the lines of code and include the line-continuation character.

Creating the Macro

  1. From the Tools menu, choose Macro.
  2. In the Macro Name field, type MultiLineFilter, and then choose OK.
  3. In the Module Editor view, enter the code for the procedure that follows, (enter the code exactly as shown):
       Sub MultiLineFilter()
    
       ' Creates the filter named "MyFilter" or overwrites it if it already
       ' exists. Also adds the first line of the filter. The first line will
       ' read: "ID - grt or equal - 5 - and"
    
         FilterEdit Name:="MyFilter", TaskFilter:=True, create:=True, _
                  overwriteexisting:=True, FieldName:="id", _
                  test:="gtr or equal", Value:="5", Operation:="and", _
                  ShowInMenu:=True
    
       ' Creates the second line in the same filter and
       ' will read: "ID - less or equal - 5"
    
         FilterEdit Name:="MyFilter", TaskFilter:=True, create:=False, _
                  overwriteexisting:=False, newfieldname:="id", _
                  test:="less or equal", Value:="5"
       End Sub
    						
    NOTE: The "create" and "overwriteexisting" arguments are False. The "NewFieldName" parameter specifies the field name of the next available line in the filter.
If "FieldName" was used instead of "NewFieldName," the first line is overwritten with the new values since the same field name was used twice. If a different field had been used along with the "FieldName" parameter, the line would have been ignored because a line with the same name couldn't be matched so that the new values could be applied to it.

By adding additional FilterEdit lines, you can create up to a 20-line filter.

REFERENCES

For more information about Filters, choose the Search button in Microsoft Project Help and type:

Filter Definition Table.

For more information about the FilterEdit Method, choose the Search button in Microsoft Project Visual Basic Reference and type:

FilterEdit


Modification Type:MajorLast Reviewed:11/25/2003
Keywords:kbcode kbhowto kbProgramming KB126941