OpenReport Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.  

The OpenReport method carries out the OpenReport action in Visual Basic.

expression.OpenReport(ReportName, View, FilterName, WhereCondition, WindowMode, OpenArgs)

expression   Required. An expression that returns a DoCmd object.

ReportName  Required Variant. A string expression that's the valid name of a report in the current database. If you execute Visual Basic code containing the OpenReport method in a library database, Microsoft Access looks for the report with this name, first in the library database, then in the current database.

AcView

FilterName  Optional Variant. A string expression that's the valid name of a query in the current database.

WhereCondition  Optional Variant. A string expression that's a valid SQL WHERE clause without the word WHERE.

AcWindowMode

OpenArgs  Optional Variant. Sets the OpenArgs property.

Remarks

For more information on how the action and its arguments work, see the action topic.

The maximum length of the WhereCondition argument is 32,768 characters (unlike the Where Condition action argument in the Macro window, whose maximum length is 256 characters).

You can leave an optional argument blank in the middle of the syntax, but you must include the argument's comma. If you leave one or more trailing arguments blank, don't use a comma following the last argument you specify.

Example

The following example prints Sales Report while using the existing query Report Filter.

  DoCmd.OpenReport "Sales Report", acViewNormal, "Report Filter"