[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Collapse]Common Features
  [Expand]Data Binding Common Concepts
  [Expand]Data Source Wizard
    File and Folder Browser Behaviors
    Persistence Behavior
    Indicator Behaviors
    Stub Glyph Behavior
    Banner Behavior
    Breadcrumb Behavior
    Disabled Cell Behavior
    Drag-and-Drop Behavior
    Magnifier Behavior
    Pager Navigation Behavior
    Scrollbar Annotation Behavior
    Snap Window Behavior
  [Expand]Application Appearance and Skin Colors
  [Expand]Filtering UI Context
   Find Panel Syntax
  [Expand]Graphics Performance and High DPI
  [Expand]Scaffolding Wizard
  [Expand]Formatting Values
   HTML-inspired Text Formatting
  [Expand]Save and Restore Layouts
   Clipboard - Copy and Paste Operations. Data Formatting
   Version Compatibility: Default Property Values
  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 Behavior

This Behavior allows you to implement breadcrumb navigation within the TreeList's hierarchy. This navigation is provided by a separate BreadCrumbEdit control.

The Breadcrumb Behavior pairs the TreeList and BreadCrumbEdit controls. In this pairing mode, the BreadCrumbEdit automatically populates its contents based on the bound TreeList's hierarchy. The BreadCrumbEdit control's selection is then in sync with the TreeList's focused node.

Demo: Explorer(Virtual Tree) module in the XtraTreeList MainDemo


Create Behavior

  1. Ensure that your form already contains TreeList and BreadCrumbEdit controls.
  2. From the TreeList's smart tag, select Add Behaviors.... This opens the Behaviors dialog allowing you to add BreadCrumbBehavior.


    You can also add this behavior using the BehaviorManager component, which you can find in the Visual Studio Toolbox.

  3. Set up the created BreadCrumbBehavior by specifying the following settings.

    • BreadCrumbControl - the target BreadCrumbEdit control.

    • Target - the target TreeList control; this property is visible and needs to be explicitly specified if you open the dialog using the BehaviorManager component. This property is automatically initialized and hidden from the Behaviors dialog if you invoked the dialog from the TreeList's smart tag.

    • DisplayMember - specifies the data source field name or TreeListColumn.FieldName whose contents the BreadCrumbEdit control will display.

    The TreeList is a multi-column control, while the BreadCrumbEdit can only display a single field's contents. Thus, you should identify the display field name using the DisplayMember property. These field values are used to initialize the BreadCrumb item display text (BreadCrumbNode.Caption).


    It is recommended that you provide unique display values for sibling nodes. If sibling nodes must have duplicate display values, provide unique values for sibling nodes. See the ValueMember setting below to learn more.

Expanded Example


Optional Settings and Events

  • ValueMember - specifies the field whose contents are used to initialize BreadCrumbEdit item values (BreadCrumbNode.Value). To ensure correct item identification, item values (if specified) must be unique among sibling nodes. You can also provide unique item values by handling the CustomItemContents event.
  • CustomItemContents event - Allows you to customize the display text, image and other settings of BreadCrumbEdit items.

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