Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [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
   [Expand]Simple Editors
   [Expand]Lookup Editors
   [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
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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.

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).

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