[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Collapse]Editors and Simple Controls
    Included Controls and Components
   [Expand]Common Editor Features and Concepts
   [Expand]Lookup Editors
    Popup Container Editor
   [Expand]Token Edit Control
   [Collapse]Breadcrumb Edit Control
     Breadcrumb Modes
     How to: Create Breadcrumb Nodes at Design Time
     How to: Create Breadcrumb Nodes at Runtime
     How To: Add Custom Buttons to the Breadcrumb Edit Control
     How To: Create a File Explorer
   [Expand]Range Control
   [Expand]Image Slider
    Camera Control
    Templated ListBox Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Breadcrumb Modes

The Breadcrumb Edit Control can operate in two modes - Edit and Select. Both modes are complementary forms between which the Breadcrumb Modes switches dynamically at runtime depending on end-user actions (see the animation below). However, you can explicitly set in which mode the editor should operate at the moment. To do so, use the RepositoryItemBreadCrumbEdit.BreadCrumbMode property. Note that this setting does not prevent the editor from entering another mode, if required.

Expanded Select Mode

Select mode is the default mode in which end-users operate at runtime. All navigation is perfomed by using a mouse.

The following list enumerates end-user capabilities available in select mode.

  • Clicking a node displayed in the current path navigates a user back to this node. Each node in this mode displays its caption.
  • Its is possible to click a drop-down arrow (if any) for a node and view its child nodes.
  • End-users cannot navigate to non-existing nodes.
  • End-users are able to invoke the editor's drop-down menu to view the navigation history that stores navigation performed in Edit mode (see the History section below).
  • Right-clicking the editor invokes the User Action Menu that contains three default actions: 'Copy Address', 'Edit Address' and 'Delete History' (see the figure below).

    You can remove these default actions or add your custom items. To do so, handle the RepositoryItemBreadCrumbEdit.ShowUserActionMenu event and populate the e.PopupMenu.Items collection with DXMenuItem objects.

Expanded Edit Mode

The Breadcrumb Edit Control switches to Edit mode when an end-user clicks the empty space in the editor's path or chooses the 'Edit Address' item in User Action Menu. You can disable the RepositoryItemBreadCrumbEdit.AllowEdit property to prevent the control from entering this mode and force it to operate in Select mode at all times.

This mode provides the following capabilities and specifics.

  • The editor's current path is presented as a plain text string: node values and separator chars. Note that since persistent nodes are excluded from the regular node hierarchy and do not participate in navigation, their values are not displayed.
  • End-users modify this path as a regular string. When the Enter key is pressed, the modified path is passed to the editor and it switches back to Select mode.
  • The Edit mode allows for the dynamic new nodes creation. If an end-user entered an incorrect string as the editor path, the RepositoryItemBreadCrumbEdit.ValidatePath event is raised.
  • While end-users type the path, the auto-complete feature suggests existing nodes that match the path entered.

  • Whenever a user navigates to a specific node in Edit mode, this path is recorded to history. The history can be viewed in Select mode by clicking the editor's drop-down button (see the History section below).

Is this topic helpful?​​​​​​​