The ShowNavigationItemController is a part of the Navigation System. This Controller is intended for presenting the ShowNavigationItem Action.
In a Windows Forms Application:
In an ASP.NET Web Forms application:
For details on the ShowNavigationItem Action, refer to the description of the ShowNavigationItemController.ShowNavigationItemAction property that provides access to this Action.
To customize the default behavior of the ShowNavigationItem Action, you can inherit from this Controller, or subscribe to its events. In addition, you can access the Action to modify its behavior.
If you need to inherit from the ShowNavigationItemController, the following protected virtual methods are available for overriding:
When is it called?
Invoked as a result of calling the InitializeItems method when populating the Navigation‘s Items collection.
Determines whether the application’s Security System grants permission to read the object(s) of the passed item’s View. If a Views | View node describing the item’s View cannot be found, this method returns true. The items for which this method returns false, are disabled by the ShowNavigationItemController.SynchronizeItemsWithSecurity method.
Called after the ShowNavigationItemController is activated.
Called after the ShowNavigationItem Action’s Items collection is populated via the InitializeItems method.
Raises the ShowNavigationItemController.ItemsInitialized event.
Called by the ShowNavigationItem Action’s SingleChoiceAction.Execute event handler.
Public members are described individually in the documentation.
This Controller does not have UI-specific descendants. If you require, you can inherit from this Controller to implement a UI-specific functionality.
To ascertain whether the Controller is active, use the Controller.Active property (see How to: Detect a Lookup List View in Code). If you need to know the reason for its deactivation or activation at runtime, use the DiagnosticInfo Action.
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowNavigationItemController class.
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.