The RadOfficeNavigationBar class represents a navigation bar that facilitates seamless navigation between various views within an application. It allows users to access a streamlined subset of a view in a popup window, dynamically manages the visibility of items through an , and provides extensive customization options via the OfficeNavigationBarDialog. The class supports features such as drag-and-drop reordering of items, compact mode for displaying minimal content, and peek popups for contextual information. The navigation bar enhances the user experience by providing intuitive keyboard navigation, responsive item selection, and automated handling of item visibility based on the available space. Overall, it serves as an effective tool for organizing and presenting content in a user-friendly manner.
Definition
Namespace:Telerik.Windows.Controls
Assembly:Telerik.Windows.Controls.Navigation.dll
Syntax:
[TelerikToolboxCategory("Navigation")]
public class RadOfficeNavigationBar : SelectorInheritance: objectRadOfficeNavigationBar
Constructors
Initializes a new instance of the RadOfficeNavigationBar class.
public RadOfficeNavigationBar()Fields
IsDragReorderEnabledProperty
DependencyProperty
Identifies the IsDragReorderEnabled dependency property.
public static readonly DependencyProperty IsDragReorderEnabledPropertyIsInCompactModeProperty
DependencyProperty
Identifies the IsInCompactMode dependency property.
public static readonly DependencyProperty IsInCompactModePropertyIsPeekPopupEnabledProperty
DependencyProperty
Identifies the IsPeekPopupEnabled dependency property.
public static readonly DependencyProperty IsPeekPopupEnabledPropertyItemOrientationProperty
DependencyProperty
Identifies the ItemOrientation dependency property.
public static readonly DependencyProperty ItemOrientationPropertyItemRotationAngleProperty
DependencyProperty
Identifies the ItemRotationAngle dependency property.
public static readonly DependencyProperty ItemRotationAnglePropertyItemsMaxCountProperty
DependencyProperty
Identifies the ItemsMaxCount dependency property.
public static readonly DependencyProperty ItemsMaxCountPropertyOrientationProperty
DependencyProperty
Identifies the Orientation dependency property.
public static readonly DependencyProperty OrientationPropertyPeekPopupCloseDelayProperty
DependencyProperty
Identifies the PeekPopupCloseDelay dependency property.
public static readonly DependencyProperty PeekPopupCloseDelayPropertyPeekPopupOpeningEvent
RoutedEvent
Registers the PeekPopupOpening routed event.
public static readonly RoutedEvent PeekPopupOpeningEventPeekPopupShowDelayProperty
DependencyProperty
Identifies the PeekPopupShowDelay dependency property.
public static readonly DependencyProperty PeekPopupShowDelayPropertyProperties
Gets or sets a boolean value indicating whether drag and drop reordering of items is enabled.
public bool IsDragReorderEnabled { get; set; }Gets or sets a boolean value indicating whether the control is in Compact mode. In that mode only the compact content of the items will be visible.
public bool IsInCompactMode { get; set; }Gets or sets a boolean value indicating whether a peek popup will be shown upon hovering an item.
public bool IsPeekPopupEnabled { get; set; }ItemOrientation
Orientation
Gets or sets the orientation in which each individual RadOfficeNavigationBarItem will be displayed.
public Orientation ItemOrientation { get; set; }Gets the angle the items are rotated by.
public double ItemRotationAngle { get; }Gets or sets an integer value identifying the maximum number of items that will be displayed at a time.
public int ItemsMaxCount { get; set; }Gets the view model for the OfficeNavigationBarDialog control.
public OfficeNavigationBarDialogViewModel OfficeNavigationBarDialogViewModel { get; }Orientation
Orientation
Gets or sets the orientation in which all the RadOfficeNavigationBarItems will be displayed.
public Orientation Orientation { get; set; }Gets or sets an double value indicating the delay time in milliseconds between when the mouse leaves the item and when the peek popup is closed.
public double PeekPopupCloseDelay { get; set; }Gets or sets an double value indicating the delay time in milliseconds between when an item is hovered and when the peek popup is shown.
public double PeekPopupShowDelay { get; set; }Methods
Clears the specified element displaying the specified item container.
protected override void ClearContainerForItemOverride(DependencyObject element, object item)Element used to display the specified item.
itemobjectSpecified item.
GetContainerForItemOverride()
DependencyObject
Creates or identifies the element that is used to display the given item.
protected override DependencyObject GetContainerForItemOverride()DependencyObject
Called when the template for the RadOfficeNavigationBar is applied. This method is used to perform any necessary setup after the control's template is applied.
public override void OnApplyTemplate()OnCreateAutomationPeer()
AutomationPeer
Returns class-specific AutomationPeer.
protected override AutomationPeer OnCreateAutomationPeer()AutomationPeer
The type-specific AutomationPeer implementation.
Raises the event. This method is invoked whenever is set to true internally.
protected override void OnInitialized(EventArgs e)The RoutedEventArgs that contains the event data.
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)protected override void OnKeyDown(KeyEventArgs e)protected override void OnSelectionChanged(SelectionChangedEventArgs e)Prepares the specified element to display the specified item container.
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)Element used to display the specified item.
itemobjectSpecified item.
Resets the theme.
public void ResetTheme()Events
Occurs when a peek popup is about to be shown.
public event EventHandler<PeekPopupOpeningEventArgs> PeekPopupOpening