DoCmd.SetDisplayedCategories Method
| Access Developer Reference |
Specifies which categories are displayed under Navigate to Category in the title bar of the Navigation Pane. .
Version Information
Version Added: Access 2007
Syntax
expression.SetDisplayedCategories(Show, Category)
expression A variable that represents a DoCmd object.
Parameters
| Name | Required/Optional | Data Type | Description |
|---|---|---|---|
| Show | Required | Variant | Set to Yes to show the category or categories. Set to No to hide them. |
| Category | Optional | Variant | The name of the category you want to show or hide. Leave blank to show or hide all categories. |
Remarks
For example, if you want to prevent users from switching the Navigation Pane so that it displays objects sorted by Created Date, you can use this method to hide that option in the title bar's drop-down list.
The caption in the title bar of the Navigation Pane indicates which filter, if any, is currently active. Click anywhere in the bar to display the drop-down list. The items that this method controls are listed under Navigate to Category.
This method only enables or disables the display of the specified category or categories; it does not perform any switching of the Navigation Pane display. For example, if you are displaying objects sorted by Creation Date and you use the SetDisplayedCategories method to disable the Creation Date option, Access does not switch the Navigation Pane to another category.