Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Expand]Concepts
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Expand]Deployment
 [Expand]Task-Based Help
 [Expand]Frequently Asked Questions
 [Collapse]API Reference
  [Expand]DevExpress.EasyTest.Framework
  [Expand]DevExpress.ExpressApp
  [Expand]DevExpress.ExpressApp.Actions
  [Expand]DevExpress.ExpressApp.AuditTrail
  [Expand]DevExpress.ExpressApp.Chart
  [Expand]DevExpress.ExpressApp.Chart.Web
  [Expand]DevExpress.ExpressApp.Chart.Win
  [Expand]DevExpress.ExpressApp.CloneObject
  [Expand]DevExpress.ExpressApp.ConditionalAppearance
  [Expand]DevExpress.ExpressApp.Dashboards
  [Expand]DevExpress.ExpressApp.Dashboards.Web
  [Expand]DevExpress.ExpressApp.Dashboards.Win
  [Expand]DevExpress.ExpressApp.Data
  [Expand]DevExpress.ExpressApp.DC
  [Expand]DevExpress.ExpressApp.DC.ClassGeneration
  [Expand]DevExpress.ExpressApp.Editors
  [Expand]DevExpress.ExpressApp.EF
  [Expand]DevExpress.ExpressApp.EF.Utils
  [Expand]DevExpress.ExpressApp.FileAttachments.Web
  [Expand]DevExpress.ExpressApp.FileAttachments.Win
  [Expand]DevExpress.ExpressApp.Filtering
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Web
  [Expand]DevExpress.ExpressApp.HtmlPropertyEditor.Win
  [Expand]DevExpress.ExpressApp.Kpi
  [Expand]DevExpress.ExpressApp.Layout
  [Expand]DevExpress.ExpressApp.Maps.Mobile
  [Expand]DevExpress.ExpressApp.Maps.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Maps.Web
  [Expand]DevExpress.ExpressApp.Maps.Web.Helpers
  [Expand]DevExpress.ExpressApp.MiddleTier
  [Expand]DevExpress.ExpressApp.Mobile
  [Expand]DevExpress.ExpressApp.Mobile.Editors
  [Expand]DevExpress.ExpressApp.Mobile.MobileModel
  [Expand]DevExpress.ExpressApp.Mobile.SystemModule
  [Expand]DevExpress.ExpressApp.Model
  [Expand]DevExpress.ExpressApp.Model.Core
  [Expand]DevExpress.ExpressApp.Model.NodeGenerators
  [Expand]DevExpress.ExpressApp.ModelEditor
  [Expand]DevExpress.ExpressApp.Notifications
  [Expand]DevExpress.ExpressApp.Notifications.Web
  [Expand]DevExpress.ExpressApp.Notifications.Win
  [Expand]DevExpress.ExpressApp.PivotChart
  [Expand]DevExpress.ExpressApp.PivotChart.Web
  [Expand]DevExpress.ExpressApp.PivotChart.Win
  [Expand]DevExpress.ExpressApp.PivotGrid
  [Expand]DevExpress.ExpressApp.PivotGrid.Web
  [Expand]DevExpress.ExpressApp.PivotGrid.Win
  [Expand]DevExpress.ExpressApp.Reports
  [Expand]DevExpress.ExpressApp.Reports.Web
  [Expand]DevExpress.ExpressApp.Reports.Win
  [Expand]DevExpress.ExpressApp.ReportsV2
  [Expand]DevExpress.ExpressApp.ReportsV2.Web
  [Expand]DevExpress.ExpressApp.ReportsV2.Win
  [Expand]DevExpress.ExpressApp.Scheduler
  [Expand]DevExpress.ExpressApp.Scheduler.Web
  [Expand]DevExpress.ExpressApp.Scheduler.Win
  [Expand]DevExpress.ExpressApp.ScriptRecorder
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Web
  [Expand]DevExpress.ExpressApp.ScriptRecorder.Win
  [Expand]DevExpress.ExpressApp.Security
  [Expand]DevExpress.ExpressApp.Security.Adapters
  [Expand]DevExpress.ExpressApp.Security.ClientServer.Wcf
  [Expand]DevExpress.ExpressApp.Security.EF.Adapters
  [Expand]DevExpress.ExpressApp.Security.Strategy
  [Expand]DevExpress.ExpressApp.Security.Xpo.Adapters
  [Expand]DevExpress.ExpressApp.StateMachine
  [Collapse]DevExpress.ExpressApp.SystemModule
   [Expand]AboutInfo Class
   [Expand]ActionControlsSiteController Class
   [Expand]CustomBuildCriteriaEventArgs Class
   [Expand]CustomExportAnalysisEventArgs Class
   [Expand]CustomExportEventArgs Class
   [Expand]CustomGetDefaultFileNameEventArgs Class
   [Expand]CustomGetFiltersEventArgs Class
   [Expand]CustomGetFullTextSearchPropertiesEventArgs Class
   [Expand]CustomizeShowViewParametersEventArgs Class
   [Expand]CustomizeWindowCaptionEventArgs Class
   [Expand]CustomizeWindowStatusMessagesEventArgs Class
   [Expand]CustomShowNavigationItemEventArgs Class
   [Expand]DeleteObjectsViewController Class
   [Expand]DialogController Class
   [Expand]DialogControllerAcceptingEventArgs Class
   [Expand]ExportAnalysisController Class
   [Expand]ExportController Class
   [Expand]FilterController Class
    FullTextSearchTargetPropertiesMode Enumeration
   [Expand]IDataAwareExportable Interface
   [Expand]IDataAwareExportableCsv Interface
   [Expand]IDataAwareExportableXls Interface
   [Expand]IDataAwareExportableXlsx Interface
   [Expand]IExportable Interface
   [Expand]IExportableAnalysisEditor Interface
   [Expand]IModelActionContainer Interface
   [Expand]IModelActionDesignContainerMapping Interface
   [Expand]IModelActionLink Interface
   [Expand]IModelActionToContainerMapping Interface
   [Expand]IModelApplicationCreatableItems Interface
   [Expand]IModelApplicationNavigationItems Interface
   [Expand]IModelClassNavigation Interface
   [Expand]IModelClassNewItemRow Interface
   [Expand]IModelClassShowAutoFilterRow Interface
   [Expand]IModelCreatableItem Interface
   [Expand]IModelCreatableItems Interface
   [Expand]IModelDetailViewDefaultFocusedItem Interface
   [Expand]IModelHiddenActions Interface
   [Expand]IModelListViewFilter Interface
   [Expand]IModelListViewFilterItem Interface
   [Expand]IModelListViewFilters Interface
   [Expand]IModelListViewNewItemRow Interface
   [Expand]IModelListViewPreviewColumn Interface
   [Expand]IModelListViewShowAutoFilterRow Interface
   [Expand]IModelNavigationItem Interface
   [Expand]IModelNavigationItems Interface
   [Expand]IModelOptionsDashboard Interface
   [Expand]IModelOptionsDashboards Interface
   [Expand]IModelPropertyEditorLinkView Interface
   [Expand]IModelRootNavigationItems Interface
   [Expand]IModelViewHiddenActions Interface
   [Expand]LinkUnlinkController Class
   [Expand]ListViewFilterAttribute Class
   [Expand]ListViewProcessCurrentObjectController Class
   [Expand]LogoffController Class
   [Expand]ModelActionContainersGenerator Class
   [Expand]ModelCreatableItemsGenerator Class
   [Expand]ModelListViewFiltersGenerator Class
    ModificationsCheckingMode Enumeration
   [Expand]ModificationsController Class
    ModificationsHandlingMode Enumeration
   [Expand]NavigationItemCreatedEventArgs Class
   [Expand]NavigationItemNodeGenerator Class
    NewObjectActionItemListMode Enumeration
   [Expand]NewObjectViewController Class
   [Expand]ObjectCreatingEventArgs Class
   [Expand]PrintableChangedEventArgs Class
   [Expand]RecordsNavigationController Class
   [Expand]RefreshController Class
   [Collapse]ShowNavigationItemController Class
     ShowNavigationItemController Members
     ShowNavigationItemController Constructor
    [Expand]ShowNavigationItemController Properties
    [Collapse]ShowNavigationItemController Events
      CustomGetStartupNavigationItem Event
      CustomInitializeItems Event
      CustomShowNavigationItem Event
      CustomUpdateSelectedItem Event
      ItemsInitialized Event
      NavigationItemCreated Event
    [Expand]ShowNavigationItemController Methods
   [Expand]SystemModule Class
   [Expand]WindowTemplateController Class
  [Expand]DevExpress.ExpressApp.Templates
  [Expand]DevExpress.ExpressApp.Templates.ActionContainers
  [Expand]DevExpress.ExpressApp.TreeListEditors
  [Expand]DevExpress.ExpressApp.TreeListEditors.Web
  [Expand]DevExpress.ExpressApp.TreeListEditors.Win
  [Expand]DevExpress.ExpressApp.Updating
  [Expand]DevExpress.ExpressApp.Utils
  [Expand]DevExpress.ExpressApp.Validation
  [Expand]DevExpress.ExpressApp.Validation.Web
  [Expand]DevExpress.ExpressApp.Validation.Win
  [Expand]DevExpress.ExpressApp.ViewVariantsModule
  [Expand]DevExpress.ExpressApp.Web
  [Expand]DevExpress.ExpressApp.Web.Controls
  [Expand]DevExpress.ExpressApp.Web.Editors
  [Expand]DevExpress.ExpressApp.Web.Editors.ASPx
  [Expand]DevExpress.ExpressApp.Web.SystemModule
  [Expand]DevExpress.ExpressApp.Web.Templates
  [Expand]DevExpress.ExpressApp.Web.Utils
  [Expand]DevExpress.ExpressApp.Win
  [Expand]DevExpress.ExpressApp.Win.Core
  [Expand]DevExpress.ExpressApp.Win.Editors
  [Expand]DevExpress.ExpressApp.Win.Model
  [Expand]DevExpress.ExpressApp.Win.SystemModule
  [Expand]DevExpress.ExpressApp.Win.Templates
  [Expand]DevExpress.ExpressApp.Win.Templates.Navigation
  [Expand]DevExpress.ExpressApp.Workflow
  [Expand]DevExpress.ExpressApp.Workflow.Win
  [Expand]DevExpress.ExpressApp.Xpo
  [Expand]DevExpress.ExpressApp.Xpo.Utils
  [Expand]DevExpress.Persistent.Base
  [Expand]DevExpress.Persistent.Base.General
  [Expand]DevExpress.Persistent.Base.ReportsV2
  [Expand]DevExpress.Persistent.Base.Security
  [Expand]DevExpress.Persistent.BaseImpl
  [Expand]DevExpress.Persistent.BaseImpl.EF
  [Expand]DevExpress.Persistent.BaseImpl.EF.PermissionPolicy
  [Expand]DevExpress.Persistent.BaseImpl.PermissionPolicy
  [Expand]DevExpress.Persistent.Validation
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

ShowNavigationItemController.CustomShowNavigationItem Event

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

Namespace:DevExpress.ExpressApp.SystemModule
Assembly:DevExpress.ExpressApp.v17.1.dll

Expanded Syntax

Expanded Event Data

The event handler receives an argument of type CustomShowNavigationItemEventArgs containing data related to this event.

The following CustomShowNavigationItemEventArgs 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.

Expanded 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: Implement Custom Context Navigation topic.

As an alternative to this event, you can override the ShowNavigationItem method in the ShowNavigationItemController's descendant. To see an example, refer to the How to: Create a New Object using the Navigation Control topic.

Expanded See Also

How would you rate this topic?​​​​​​​