In This Article

Edit Mode

The Breadcrumb control supports an edit mode, in which the user can manually type a new path or select an item from a drop-down list. The edit mode is supported using an embedded ComboBox, whose drop-down items can be fully customized. Typically, this list would include recently selected items and/or favorite items.

The user can enter edit mode by:

  • Pressing the Space key when the breadcrumb has the keyboard focus

  • Clicking on the icon on the left

  • Clicking in the empty space on the right

  • Opening the drop-down list

The user can exit edit mode by:

  • Pressing the Enter key when the text box has the keyboard focus

  • Pressing the Escape key when the text box has the keyboard focus (any changes will be discarded)

  • Selecting an item from the drop-down list

  • Moving focus away from the Breadcrumb control (any changes will be discarded)

Screenshot

The Breadcrumb control using the Aero theme in edit mode and drop-down list open

Disabling Edit Mode

The edit mode can be disabled by setting the IsEditable property to false. When the edit mode is disabled, the drop-down list is hidden and the user cannot directly enter a path.

Populating the Drop-Down List

The embedded combo box drop-down list is populated using the ComboBoxItemsSource property. This property can be set in the same manner as the ComboBox.ItemsSource property.

Note

Logic to convert a combo box item to a trail must be provided. See the Item Conversion topic for more information.

Associated Members

The following Breadcrumb members are associated with edit mode:

Member Description
ComboBoxIsReadOnly Property Gets or sets a value that enables selection-only mode, in which the contents of the embedded combo box are selectable but not editable. The default value is false.
ComboBoxItemContainerStyle Property Gets or sets the Style that is applied to the ComboBoxItem elements generated for items in the embedded combo box. The default value is null.
ComboBoxItemContainerStyleSelector Property Gets or sets custom logic for choosing a Style that can be applied to ComboBoxItem elements generated by the embedded combo box. The default value is null.
ComboBoxItemsSource Property Gets or sets a collection used to generate the content of the embedded combo box. The default value is null.
ComboBoxItemTemplate Property Gets or sets the DataTemplate used to display each item in the embedded combo box. The default value is null.
ComboBoxItemTemplateSelector Property Gets or sets the custom logic for choosing a template used to display each item in the embedded combo box. The default value is null.
ComboBoxStaysOpenOnEdit Property Gets or sets whether the drop-down control for the embedded combo box will remain open when a user clicks the text area. The default value is false.
IsEditable Property Gets or sets a value indicating whether the breadcrumb control can enter edit mode. The default value is true.
IsEditing Property Gets or sets a value indicating whether the breadcrumb control is currently in edit mode. The default value is false.