New to Telerik UI for WPF? Start a free 30-day trial

Represents an item in the RadPanelBar control.

The RadPanelBar control is made up of items. Items which are immediate children of the PanelBar are root items. Items which are children of root items are child items.

An item usually stores data in two properties, the Header property and the Item property. The value of the Header property is always displayed in the RadPanelBar control, and the Item property property is used to store the actual content of the RadPanelBarItem and is visible only when the RadPanelBarItem is expanded.

To create panel items, use one of the following methods:

  • Use declarative syntax to define items inline in your page or user control.
  • Use the constructor to dynamically create new instances of the RadPanelBarItem class. These items can then be added to the Items collection of another item or PanelBar.
  • Data bind the RadPanelBar control to a data source.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:

C#
[TelerikToolboxCategory("Navigation")]
public class RadPanelBarItem : RadTreeViewItem, ICommandSource

Inheritance: objectEditableHeaderedItemsControlRadTreeViewItemRadPanelBarItem

Implements: ICommandSource

Inherited Members RadTreeViewItem.CommandPropertyRadTreeViewItem.CommandParameterPropertyRadTreeViewItem.CommandTargetPropertyRadTreeViewItem.ExpandedEventRadTreeViewItem.CollapsedEventRadTreeViewItem.PreviewCollapsedEventRadTreeViewItem.PreviewExpandedEventRadTreeViewItem.SelectedEventRadTreeViewItem.UnselectedEventRadTreeViewItem.PreviewSelectedEventRadTreeViewItem.PreviewUnselectedEventRadTreeViewItem.PreviewCheckedEventRadTreeViewItem.CheckedEventRadTreeViewItem.PreviewUncheckedEventRadTreeViewItem.UncheckedEventRadTreeViewItem.LoadOnDemandEventRadTreeViewItem.ClickEventRadTreeViewItem.DoubleClickEventRadTreeViewItem.IsSelectionActivePropertyKeyRadTreeViewItem.IsSelectionActivePropertyRadTreeViewItem.OptionTypePropertyRadTreeViewItem.ExpanderStylePropertyRadTreeViewItem.ExpanderButtonMinWidthPropertyRadTreeViewItem.IsExpandedPropertyRadTreeViewItem.IsDropAllowedPropertyRadTreeViewItem.IsDragOverPropertyRadTreeViewItem.DropPositionPropertyRadTreeViewItem.CheckStatePropertyRadTreeViewItem.IsLoadOnDemandEnabledPropertyRadTreeViewItem.IsLoadingOnDemandPropertyRadTreeViewItem.IsCheckedPropertyRadTreeViewItem.DefaultImageSrcPropertyRadTreeViewItem.SelectedImageSrcPropertyRadTreeViewItem.ExpandedImageSrcPropertyRadTreeViewItem.IsCheckBoxEnabledPropertyRadTreeViewItem.IsSelectedPropertyRadTreeViewItem.IsSelectablePropertyRadTreeViewItem.CommandExecutionTriggerPropertyRadTreeViewItem.ItemVisibilityPropertyRadTreeViewItem.IsMouseOverHeaderPropertyRadTreeViewItem.ExpandAll()RadTreeViewItem.CollapseAll()RadTreeViewItem.IsBefore(RadTreeViewItem)RadTreeViewItem.Contains(RadTreeViewItem)RadTreeViewItem.EnsureVisible()RadTreeViewItem.ToString()RadTreeViewItem.IsDropPossible(IEnumerable)RadTreeViewItem.BringIndexIntoView(int)RadTreeViewItem.BringItemIntoView(object)RadTreeViewItem.BeginEdit()RadTreeViewItem.CancelEdit()RadTreeViewItem.CommitEdit()RadTreeViewItem.OnIsEnabledChanged(object, DependencyPropertyChangedEventArgs)RadTreeViewItem.ClearContainerForItemOverride(DependencyObject, object)RadTreeViewItem.OnPreviewEditorPrepare(EditorPrepareEventArgs)RadTreeViewItem.OnHeaderChanged(object, object)RadTreeViewItem.OnClick(RadRoutedEventArgs)RadTreeViewItem.OnDoubleClick(RadRoutedEventArgs)RadTreeViewItem.OnLoadOnDemand(RadRoutedEventArgs)RadTreeViewItem.OnPreviewExpanded(RadRoutedEventArgs)RadTreeViewItem.OnUnchecked(RadTreeViewCheckEventArgs)RadTreeViewItem.OnPreviewUnchecked(RadTreeViewCheckEventArgs)RadTreeViewItem.OnChecked(RadTreeViewCheckEventArgs)RadTreeViewItem.OnPreviewChecked(RadTreeViewCheckEventArgs)RadTreeViewItem.OnPreviewUnselected(RadRoutedEventArgs)RadTreeViewItem.OnPreviewSelected(RadRoutedEventArgs)RadTreeViewItem.OnUnselected(RadRoutedEventArgs)RadTreeViewItem.OnSelected(RadRoutedEventArgs)RadTreeViewItem.OnExpanded(RadRoutedEventArgs)RadTreeViewItem.OnCollapsed(RadRoutedEventArgs)RadTreeViewItem.OnPreviewCollapsed(RadRoutedEventArgs)RadTreeViewItem.OnGotFocus(RoutedEventArgs)RadTreeViewItem.OnLostFocus(RoutedEventArgs)RadTreeViewItem.OnKeyDown(KeyEventArgs)RadTreeViewItem.OnHeaderEditElementKeyDown(object, KeyEventArgs)RadTreeViewItem.OnIsInEditModeChanged(bool, bool)RadTreeViewItem.CommandRadTreeViewItem.CommandParameterRadTreeViewItem.CommandTargetRadTreeViewItem.IsInSelectedPathRadTreeViewItem.DropPositionRadTreeViewItem.RootItemRadTreeViewItem.IsCheckedRadTreeViewItem.CheckStateRadTreeViewItem.IsLoadOnDemandEnabledRadTreeViewItem.IsDragOverRadTreeViewItem.IsDropAllowedRadTreeViewItem.DefaultImageSrcRadTreeViewItem.SelectedImageSrcRadTreeViewItem.ExpandedImageSrcRadTreeViewItem.ExpanderStyleRadTreeViewItem.IsExpandedRadTreeViewItem.IsSelectedRadTreeViewItem.IsSelectableRadTreeViewItem.CommandExecutionTriggerRadTreeViewItem.ItemVisibilityRadTreeViewItem.IsMouseOverHeaderRadTreeViewItem.IsInViewportRadTreeViewItem.OptionTypeRadTreeViewItem.IsCheckBoxEnabledRadTreeViewItem.IsLoadingOnDemandRadTreeViewItem.IsSelectionActiveRadTreeViewItem.IsRootItemRadTreeViewItem.ParentTreeViewRadTreeViewItem.IndexRadTreeViewItem.FullPathRadTreeViewItem.NextItemRadTreeViewItem.NextSiblingItemRadTreeViewItem.PreviousItemRadTreeViewItem.PreviousSiblingItemRadTreeViewItem.ItemRadTreeViewItem.ExpanderButtonMinWidthRadTreeViewItem.ExpandedRadTreeViewItem.CollapsedRadTreeViewItem.PreviewCollapsedRadTreeViewItem.PreviewExpandedRadTreeViewItem.SelectedRadTreeViewItem.UnselectedRadTreeViewItem.PreviewSelectedRadTreeViewItem.PreviewUnselectedRadTreeViewItem.PreviewCheckedRadTreeViewItem.CheckedRadTreeViewItem.PreviewUncheckedRadTreeViewItem.UncheckedRadTreeViewItem.LoadOnDemandRadTreeViewItem.ClickRadTreeViewItem.DoubleClickEditableHeaderedItemsControl.EditedEventEditableHeaderedItemsControl.EditCanceledEventEditableHeaderedItemsControl.PreviewEditCanceledEventEditableHeaderedItemsControl.PreviewEditedEventEditableHeaderedItemsControl.PreviewEditStartedEventEditableHeaderedItemsControl.EditStartedEventEditableHeaderedItemsControl.PreviewEditorPrepareEventEditableHeaderedItemsControl.EditorPrepareEventEditableHeaderedItemsControl.IsInEditModePropertyEditableHeaderedItemsControl.HeaderEditTemplateSelectorPropertyEditableHeaderedItemsControl.HeaderEditTemplatePropertyEditableHeaderedItemsControl.IsEditablePropertyEditableHeaderedItemsControl.AddEditStartedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.RemoveEditStartedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.AddEditCanceledHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.RemoveEditCanceledHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.AddEditedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.RemoveEditedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.AddPreviewEditStartedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.RemovePreviewEditStartedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.AddPreviewEditedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.RemovePreviewEditedHandler(UIElement, RadTreeViewItemEditedEventHandler)EditableHeaderedItemsControl.AddPreviewEditorPrepareHandler(UIElement, EditorPrepareEventHandler)EditableHeaderedItemsControl.RemovePreviewEditorPrepareHandler(UIElement, EditorPrepareEventHandler)EditableHeaderedItemsControl.AddEditorPrepareHandler(UIElement, EditorPrepareEventHandler)EditableHeaderedItemsControl.RemoveEditorPrepareHandler(UIElement, EditorPrepareEventHandler)EditableHeaderedItemsControl.PrepareEditor(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnEditorPrepare(EditorPrepareEventArgs)EditableHeaderedItemsControl.GetEditValue()EditableHeaderedItemsControl.SetEditValue(object)EditableHeaderedItemsControl.OnPreviewEdited(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnEdited(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnEditCanceled(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnPreviewEditCanceled(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnEditStarted(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnPreviewEditStarted(RadTreeViewItemEditedEventArgs)EditableHeaderedItemsControl.OnHeaderEditTemplateChanged(DataTemplate, DataTemplate)EditableHeaderedItemsControl.OnHeaderEditTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)EditableHeaderedItemsControl.IsInEditModeEditableHeaderedItemsControl.HeaderEditTemplateEditableHeaderedItemsControl.HeaderEditTemplateSelectorEditableHeaderedItemsControl.IsEditableEditableHeaderedItemsControl.HeaderEditPresenterElementEditableHeaderedItemsControl.EditStartedEditableHeaderedItemsControl.PreviewEditedEditableHeaderedItemsControl.EditCanceledEditableHeaderedItemsControl.PreviewEditCanceledEditableHeaderedItemsControl.EditedEditableHeaderedItemsControl.PreviewEditStartedEditableHeaderedItemsControl.PreviewEditorPrepareEditableHeaderedItemsControl.EditorPrepare...

Constructors

Initializes a new instance of the RadPanelBarItem class.

C#
public RadPanelBarItem()

Fields

ChildItemsTemplateProperty

DependencyProperty

Identifies the ChildItemsTemplate dependency property.

C#
public static readonly DependencyProperty ChildItemsTemplateProperty

ExpandedLengthProperty

DependencyProperty

Identifies the ExpandedLength dependency property.

C#
public static readonly DependencyProperty ExpandedLengthProperty

ExpandedMaxLengthProperty

DependencyProperty

Identifies the ExpandedMaxLength dependency property.

C#
public static readonly DependencyProperty ExpandedMaxLengthProperty

ExpandedMinLengthProperty

DependencyProperty

Identifies the ExpandedMinLength dependency property.

C#
public static readonly DependencyProperty ExpandedMinLengthProperty

LevelProperty

DependencyProperty

Identifies the Level dependency property.

C#
public static readonly DependencyProperty LevelProperty

This property specifies the depth of nesting of the current instance within the parent RadPanelBar.

Properties

ChildItemsTemplate

ControlTemplate

Gets or sets the template of the child elements.

C#
public ControlTemplate ChildItemsTemplate { get; set; }

Gets or sets the ExpandedLength property. This property is used only when either of the IsResizingEnabled or IsScrollViewerInsideItemsEnabled properties are true.

C#
public double ExpandedLength { get; set; }

Gets or sets the ExpandedMaxLength property. This property is used only when the IsResizingEnabled property is true.

C#
public double ExpandedMaxLength { get; set; }

Gets or sets the ExpandedMinLength property. This property is used only when the IsResizingEnabled property is true.

C#
public double ExpandedMinLength { get; set; }

Gets the IsScrollViewerEnabled property. This property controls whether the ScrollBarVisibility of the ScrollViewer inside the ControlTemplate of the RadPanelBarItem.

C#
public bool IsScrollViewerEnabled { get; }

Gets or sets the Level property.

C#
public int Level { get; }
Property Value:

The level.

Gets the parent PanelBarItem of the current item.

C#
[Browsable(false)]
public RadPanelBarItem ParentItem { get; }

Methods

Updates the visual state of the control.

C#
protected override void ChangeVisualState(bool useTransitions)
Parameters:useTransitionsbool

Indicates whether transitions should be used.

Overrides: RadTreeViewItem.ChangeVisualState(bool)

Creates or identifies the element that is used to display the given item.

C#
protected override DependencyObject GetContainerForItemOverride()
Returns:

DependencyObject

Overrides: RadTreeViewItem.GetContainerForItemOverride()

Determines if the specified item is (or is eligible to be) its own container.

C#
protected override bool IsItemItsOwnContainerOverride(object item)
Parameters:itemobject

The item to check.

Returns:

bool

True if the item is (or is eligible to be) its own container; otherwise, false.

Overrides: RadTreeViewItem.IsItemItsOwnContainerOverride(object)

Measures the size of the control.

C#
protected override Size MeasureOverride(Size availableSize)
Parameters:availableSizeSizeReturns:

Size

Overrides: RadTreeViewItem.MeasureOverride(Size)

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate().

C#
public override void OnApplyTemplate()

Overrides: RadTreeViewItem.OnApplyTemplate()

Clears the template property.

C#
protected virtual void OnChildItemsTemplateChanged(RadPanelBarItem item)
Parameters:itemRadPanelBarItem

The item.

Returns class-specific AutomationPeer.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

Overrides: RadTreeViewItem.OnCreateAutomationPeer()

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Overrides: RadTreeViewItem.OnInitialized(EventArgs)

Called when IsExpanded changes.

C#
protected override void OnIsExpandedChanged(bool oldValue, bool newValue)
Parameters:oldValuebool

If set to true [old value].

newValuebool

If set to true [new value].

Overrides: RadTreeViewItem.OnIsExpandedChanged(bool, bool)

Invoked when the property changes.

C#
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
Parameters:eNotifyCollectionChangedEventArgs

Information about the change.

Overrides: RadTreeViewItem.OnItemsChanged(NotifyCollectionChangedEventArgs)

Prepares the specified element to display the specified item.

C#
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameters:elementDependencyObject

Element used to display the specified item.

itemobject

Specified item.

Overrides: RadTreeViewItem.PrepareContainerForItemOverride(DependencyObject, object)