Skip to main content
.NET 6.0+

ShowNavigationItemController.CustomShowNavigationItem Event

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

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

public event EventHandler<CustomShowNavigationItemEventArgs> CustomShowNavigationItem

Event Data

The CustomShowNavigationItem event's data class is CustomShowNavigationItemEventArgs. 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.

Remarks

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.

The following code snippets (auto-collected from DevExpress Examples) contain references to the CustomShowNavigationItem event.

Note

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.

See Also