.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+
.NET Core 3.0+

ShowNavigationItemController.CustomShowNavigationItem Event

Occurs when an end-user clicks a navigation item in the navigation control.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v20.1.dll


public event EventHandler<CustomShowNavigationItemEventArgs> CustomShowNavigationItem
Public Event CustomShowNavigationItem As EventHandler(Of CustomShowNavigationItemEventArgs)

Event Data

The CustomShowNavigationItem event's handler receives an argument of the CustomShowNavigationItemEventArgs type. The following properties provide information specific to this event:

Property Description
ActionArguments Represents arguments passed to the navigation Action's SingleChoiceAction.Execute event.
Handled Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. Inherited from HandledEventArgs.


This event is raised as a result of calling the ShowNavigationItem method, which serves as the Navigation Action's SingleChoiceAction.Execute event handler. If you need to show a custom View or a separate form, handle this event. Use the handler's CustomShowNavigationItemEventArgs.ActionArguments.SelectedChoiceActionItem parameter, to get the clicked item. Set the handler's CustomShowNavigationItemEventArgs.Handled parameter to true to avoid display of the default View set for the clicked item. To see an example, refer to the How to: Create a New Object using the Navigation Control topic.

As an alternative to this event, you can override the ShowNavigationItem method in the ShowNavigationItemController's descendant.

See Also