Back to all docs
API Reference / Telerik.Windows.Controls / RadOutlookBarItem

Class
RadOutlookBarItem

Represents an item in a RadOutlookBar that can hold a header and associated content. This class allows customization of visual elements such as icons, titles, and content templates for both active and minimized states. It supports visual states, event handling for position changes, and styling through templates. The RadOutlookBarItem can be positioned in active, minimized, or overflow areas and displays different icons depending on its state. The class also provides various dependency properties to control its appearance and behavior.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Navigation.dll

Syntax:
cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadOutlookBarItem : RadTabItem, IRadTabItem

Inheritance: objectRadTabItemRadOutlookBarItem

Implements: IRadTabItem

Inherited Members RadTabItem.TabStripPlacementPropertyRadTabItem.TabOrientationPropertyRadTabItem.IsSelectedPropertyRadTabItem.IsBreakPropertyRadTabItem.IsPinnedPropertyRadTabItem.PinButtonVisibilityPropertyRadTabItem.CloseButtonVisibilityPropertyRadTabItem.LeftTemplatePropertyRadTabItem.RightTemplatePropertyRadTabItem.TopTemplatePropertyRadTabItem.BottomTemplatePropertyRadTabItem.DropDownContentPropertyRadTabItem.DropDownContentTemplatePropertyRadTabItem.DropDownContentTemplateSelectorPropertyRadTabItem.HeaderForegroundPropertyRadTabItem.IsDragDisabledPropertyRadTabItem.OnSelected(RadRoutedEventArgs)RadTabItem.OnUnselected(RadRoutedEventArgs)RadTabItem.UpdateTemplate()RadTabItem.ChangeVisualState(bool)RadTabItem.OnCreateAutomationPeer()RadTabItem.OnMouseEnter(MouseEventArgs)RadTabItem.OnMouseLeave(MouseEventArgs)RadTabItem.OnLoaded(object, RoutedEventArgs)RadTabItem.OnKeyDown(KeyEventArgs)RadTabItem.OnContentChanged(object, object)RadTabItem.MeasureOverride(Size)RadTabItem.OnHeaderMouseLeftButtonDown(object, MouseButtonEventArgs)RadTabItem.OnHeaderMouseLeftButtonUp(object, MouseButtonEventArgs)RadTabItem.OnHeaderMouseEnter(object, MouseEventArgs)RadTabItem.OnHeaderMouseLeave(object, MouseEventArgs)RadTabItem.OnGotFocus(RoutedEventArgs)RadTabItem.OnLostFocus(RoutedEventArgs)RadTabItem.FindTemplateFromPosition(Dock)RadTabItem.SetNavigationMode(KeyboardNavigationMode)RadTabItem.TabStripPlacementRadTabItem.TabOrientationRadTabItem.IsSelectedRadTabItem.IsDragDisabledRadTabItem.IsBreakRadTabItem.IsPinnedRadTabItem.PinButtonVisibilityRadTabItem.CloseButtonVisibilityRadTabItem.LeftTemplateRadTabItem.RightTemplateRadTabItem.TopTemplateRadTabItem.BottomTemplateRadTabItem.DropDownContentRadTabItem.DropDownContentTemplateRadTabItem.DropDownContentTemplateSelectorRadTabItem.HeaderForeground

Constructors

RadOutlookBarItem()

Initializes a new instance of the RadOutlookBarItem class.

Declaration

cs-api-definition
public RadOutlookBarItem()

Fields

IconMarginProperty

Identifies the IconMarginProperty dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IconMarginProperty

Field Value

DependencyProperty

IconProperty

Identifies the Icon dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IconProperty

Field Value

DependencyProperty

MinimizedContentProperty

Identifies the MinimizedContent dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinimizedContentProperty

Field Value

DependencyProperty

MinimizedContentTemplateProperty

Identifies the MinimizedContentTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinimizedContentTemplateProperty

Field Value

DependencyProperty

MinimizedContentTemplateSelectorProperty

Identifies the MinimizedContentTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinimizedContentTemplateSelectorProperty

Field Value

DependencyProperty

PositionChangedEvent

This event gets fired every time a RadOutlookBarItem changes its position.

Declaration

cs-api-definition
public static readonly RoutedEvent PositionChangedEvent

Field Value

RoutedEvent

SmallIconProperty

Identifies the SmallIcon dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SmallIconProperty

Field Value

DependencyProperty

TitleProperty

Identifies the Header property.

Declaration

cs-api-definition
public static readonly DependencyProperty TitleProperty

Field Value

DependencyProperty

TitleTemplateProperty

Identifies the TitleTemplate dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TitleTemplateProperty

Field Value

DependencyProperty

TitleTemplateSelectorProperty

Identifies the TitleTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TitleTemplateSelectorProperty

Field Value

DependencyProperty

Properties

Icon

Gets or sets the source of the icon of RadOutlookBarItem.

Declaration

cs-api-definition
public ImageSource Icon { get; set; }

Property Value

ImageSource

Remarks

The icon is visible when the RadOutlookBarItem is in the ActiveArea.

IconMargin

Gets or sets the margin of the icon of RadOutlookBarItem.

Declaration

cs-api-definition
public Thickness IconMargin { get; set; }

Property Value

Thickness

MinimizedContent

Gets or sets the content that will represent the RadOutlookBarItem while in MinimizedArea.

Declaration

cs-api-definition
public object MinimizedContent { get; set; }

Property Value

object

MinimizedContentTemplate

Gets or sets the content template that will represent the RadOutlookBarItem while in MinimizedArea.

Declaration

cs-api-definition
public DataTemplate MinimizedContentTemplate { get; set; }

Property Value

DataTemplate

MinimizedContentTemplateSelector

Gets or sets the content template selector that will select a template to represent the RadOutlookBarItem while in MinimizedArea.

Declaration

cs-api-definition
public DataTemplateSelector MinimizedContentTemplateSelector { get; set; }

Property Value

DataTemplateSelector

Position

Gets the position of the RadOutlookBarItem. This item can be positioned in: ActiveArea MinimizedArea OverflowArea.

Declaration

cs-api-definition
public OutlookBarItemPosition Position { get; }

Property Value

OutlookBarItemPosition

SmallIcon

Gets or sets the source of the small icon of RadOutlookBarItem.

Declaration

cs-api-definition
public ImageSource SmallIcon { get; set; }

Property Value

ImageSource

Remarks

The small icon is visible when the RadOutlookBarItem is in the MinimizedArea.

Title

Gets or sets the title of the parent RadOutlookBar control.

Declaration

cs-api-definition
public object Title { get; set; }

Property Value

object

TitleTemplate

Gets or sets the template for the title of the parent RadOutlookBar control.

Declaration

cs-api-definition
public DataTemplate TitleTemplate { get; set; }

Property Value

DataTemplate

TitleTemplateSelector

Gets or sets the template selector for the title template of the parent RadOutlookBar control.

Declaration

cs-api-definition
public DataTemplateSelector TitleTemplateSelector { get; set; }

Property Value

DataTemplateSelector

Methods

OnApplyTemplate()

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

Declaration

cs-api-definition
public override void OnApplyTemplate()

Overrides RadTabItem.OnApplyTemplate()

OnHeaderChanged(object, object)

Allows derived classes to act on header change.

Declaration

cs-api-definition
protected override void OnHeaderChanged(object oldHeader, object newHeader)

Parameters

oldHeader

object

The old header value.

newHeader

object

The new header value.

Overrides RadTabItem.OnHeaderChanged(object, object)

OnInitialized(EventArgs)

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

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

Overrides RadTabItem.OnInitialized(EventArgs)

OnIsSelectedChanged(bool, bool)

Called when item is selected.

Declaration

cs-api-definition
protected override void OnIsSelectedChanged(bool oldValue, bool newValue)

Parameters

oldValue

bool

newValue

bool

Overrides RadTabItem.OnIsSelectedChanged(bool, bool)

OnTitleChanged(object, object)

Allows derived classes to act on header change.

Declaration

cs-api-definition
protected virtual void OnTitleChanged(object oldHeader, object newHeader)

Parameters

oldHeader

object

The old header value.

newHeader

object

The new header value.

Events

PositionChanged

Occurs when a RadOutlookBarItem changes its position, for example, from ActiveArea to MinimizedArea.

Declaration

cs-api-definition
public event PositionChangedEventHandler PositionChanged

Event Value

PositionChangedEventHandler

In this article
DefinitionConstructorsRadOutlookBarItem()FieldsIconMarginPropertyIconPropertyMinimizedContentPropertyMinimizedContentTemplatePropertyMinimizedContentTemplateSelectorPropertyPositionChangedEventSmallIconPropertyTitlePropertyTitleTemplatePropertyTitleTemplateSelectorPropertyPropertiesIconIconMarginMinimizedContentMinimizedContentTemplateMinimizedContentTemplateSelectorPositionSmallIconTitleTitleTemplateTitleTemplateSelectorMethodsOnApplyTemplate()OnHeaderChanged(object, object)OnInitialized(EventArgs)OnIsSelectedChanged(bool, bool)OnTitleChanged(object, object)EventsPositionChanged
Not finding the help you need?
Contact Support