Class TaskBar

Represents a TaskBar control.

Inheritance
System.Object
TaskBar
Namespace: Syncfusion.Windows.Tools.Controls
Assembly: Syncfusion.Tools.Wpf.dll
Syntax
[SkinType(SkinVisualStyle = Skin.Office2007Blue, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2007BlueStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2007Silver, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2007SilverStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2010Blue, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2010BlueStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2010Black, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2010BlackStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2010Silver, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2010SilverStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2003, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2003Style.xaml")]
[SkinType(SkinVisualStyle = Skin.Blend, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/BlendStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.SyncOrange, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/SyncOrangeStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.ShinyRed, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/ShinyRedStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.ShinyBlue, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/ShinyBlueStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Default, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/generic.xaml")]
[SkinType(SkinVisualStyle = Skin.VS2010, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/VS2010Style.xaml")]
[SkinType(SkinVisualStyle = Skin.Metro, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/MetroStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Transparent, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/TransparentStyle.xaml")]
[SkinType(SkinVisualStyle = Skin.Office2007Black, Type = typeof(TaskBar), XamlResource = "/Syncfusion.Tools.Wpf;component/Controls/TaskBar/Themes/Office2007BlackStyle.xaml")]
public class TaskBar : ItemsControl
Remarks

UI framework element based on System.Windows.Controls.ItemsControl class. Control is used for grouping content objects into special items called TaskBarItem.

Examples

This example shows how to create a TaskBar in XAML. 

<Window x:Class="TaskBar.Window1" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="clr-namespace:Syncfusion.Windows.Tools.Controls;assembly=Syncfusion.Tools.WPF"
Title="TaskBar" Height="300" Width="300">
<StackPanel HorizontalAlignment="Center">
    <local:TaskBar Name="taskBar" />
</StackPanel>
</Window>

This example shows how to create a TaskBar in C#. 

using System.Windows;
using System.Windows.Controls;
namespace Sample1
{
    public partial class Window1 : Window
    {
       public Window1()
       {
            InitializeComponent();
            TaskBar TaskBar = new TaskBar();
            stackPanel.Children.Add( TaskBar );
        }
    }
}

Constructors

TaskBar()

Declaration
public TaskBar()

Fields

ButtonSizeProperty

Identifies GroupPaddingProperty attached dependency property.

Declaration
public static readonly DependencyProperty ButtonSizeProperty
Field Value
Type Description
System.Windows.DependencyProperty

GroupMarginProperty

Identifies GroupMargin dependency property.

Declaration
public static readonly DependencyProperty GroupMarginProperty
Field Value
Type Description
System.Windows.DependencyProperty

GroupOrientationProperty

Identifies GroupOrientation dependency property.

Declaration
public static readonly DependencyProperty GroupOrientationProperty
Field Value
Type Description
System.Windows.DependencyProperty

GroupPaddingProperty

Identifies GroupPaddingProperty attached dependency property.

Declaration
public static readonly DependencyProperty GroupPaddingProperty
Field Value
Type Description
System.Windows.DependencyProperty

GroupWidthProperty

Identifies GroupWidth dependency property.

Declaration
public static readonly DependencyProperty GroupWidthProperty
Field Value
Type Description
System.Windows.DependencyProperty

HeaderStyleProperty

Identifies HeaderStyleProperty attached dependency property.

Declaration
public static readonly DependencyProperty HeaderStyleProperty
Field Value
Type Description
System.Windows.DependencyProperty

IsOpenedProperty

Identifies IsOpenedProperty attached dependency property.

Declaration
public static readonly DependencyProperty IsOpenedProperty
Field Value
Type Description
System.Windows.DependencyProperty

LastChildFillProperty

Identifies LastChildFill dependency property.

Declaration
public static readonly DependencyProperty LastChildFillProperty
Field Value
Type Description
System.Windows.DependencyProperty

SelectedItemChangedEvent

Identifies SelectedItemChangedEvent routed event for TaskBar.

Declaration
public static readonly RoutedEvent SelectedItemChangedEvent
Field Value
Type Description
System.Windows.RoutedEvent

SelectedItemProperty

Identifies SelectedItem dependency property.

Declaration
public static readonly DependencyProperty SelectedItemProperty
Field Value
Type Description
System.Windows.DependencyProperty

SpeedProperty

Identifies SpeedProperty attached dependency property.

Declaration
public static readonly DependencyProperty SpeedProperty
Field Value
Type Description
System.Windows.DependencyProperty

Properties

GroupMargin

Gets or sets the value that represents margins for all items.

Declaration
public Thickness GroupMargin { get; set; }
Property Value
Type Description
System.Windows.Thickness

Type: System.Windows.Thickness

A System.Windows.Thickness value that represents margins for all items.

GroupOrientation

Gets or sets the value that represents orientation of items arrangement.

Declaration
public Orientation GroupOrientation { get; set; }
Property Value
Type Description
System.Windows.Controls.Orientation

Type: System.Windows.Controls.Orientation

Value that represents orientation of items arrangement. Default value is System.Windows.Controls.Orientation.Vertical.

GroupWidth

Gets or sets value that limits width of TaskBarItem item, for all present TaskBarItem items in TaskBar.

Declaration
public double GroupWidth { get; set; }
Property Value
Type Description
System.Double

Type: System.Double

A System.Double value that limits width of TaskBarItem item, for all present TaskBarItem items in TaskBar. Default value is System.Double.NaN.

LastChildFill

Gets or sets a value indicating whether [last child fill].

Declaration
public bool LastChildFill { get; set; }
Property Value
Type Description
System.Boolean

true if [last child fill]; otherwise, false.

SelectedItem

Gets or sets the value that represents selected item of the TaskBar.

Declaration
public TaskBarItem SelectedItem { get; set; }
Property Value
Type Description
TaskBarItem

Type: TaskBarItem

A TaskBarItem object that represents selected item of the TaskBar. Default value is null.

Methods

ClearContainerForItemOverride(DependencyObject, Object)

Undoes the effects of the PrepareContainerForItemOverride(DependencyObject, Object) method.

Declaration
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
Parameters
Type Name Description
System.Windows.DependencyObject element

The container element.
System.Object item

The item clear container.

GetButtonSize(DependencyObject)

Method gets the value of ButtonSizeProperty attached property from given object.

Declaration
public static double GetButtonSize(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
Returns
Type Description
System.Double

Value of ButtonSizeProperty attached property from given object.

GetContainerForItemOverride()

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

Declaration
protected override DependencyObject GetContainerForItemOverride()
Returns
Type Description
System.Windows.DependencyObject

The element that is used to display the given item.

GetGroupPadding(DependencyObject)

Method gets the value of GroupPaddingProperty attached property from given object.

Declaration
public static Thickness GetGroupPadding(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
Returns
Type Description
System.Windows.Thickness

Value of GroupPaddingProperty attached property from given object.

GetHeaderStyle(DependencyObject)

Method gets the value of HeaderStyleProperty attached property from given object.

Declaration
public static Style GetHeaderStyle(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
Returns
Type Description
System.Windows.Style

Value of HeaderStyleProperty attached property from given object.

GetIsOpened(DependencyObject)

Method gets the value of IsOpenedProperty attached property from given object.

Declaration
public static bool GetIsOpened(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
Returns
Type Description
System.Boolean

System.Boolean value of IsOpenedProperty attached property from given object.

GetSpeed(DependencyObject)

Method gets the value of SpeedProperty attached property from given object.

Declaration
public static double GetSpeed(DependencyObject obj)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
Returns
Type Description
System.Double

Value of SpeedProperty attached property from given object.

IsItemItsOwnContainerOverride(Object)

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

Declaration
protected override bool IsItemItsOwnContainerOverride(object item)
Parameters
Type Name Description
System.Object item

The item to check.
Returns
Type Description
System.Boolean

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

OnApplyTemplate()

Declaration
public override void OnApplyTemplate()

OnButtonSizeChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises ButtonSizeChanged event.

Declaration
protected virtual void OnButtonSizeChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

OnGroupMarginChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises GroupMarginChanged event.

Declaration
protected virtual void OnGroupMarginChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

OnGroupOrientationChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises GroupOrientationChanged event.

Declaration
protected virtual void OnGroupOrientationChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value

OnGroupPaddingChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises GroupPaddingChanged event.

Declaration
protected virtual void OnGroupPaddingChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property change details, such as old value and new value.

OnGroupWidthChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises GroupWidthChanged event.

Declaration
protected virtual void OnGroupWidthChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property change details, such as old value and new value.

OnHeaderStyleChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises HeaderStyleChanged event.

Declaration
protected virtual void OnHeaderStyleChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.Initialized is set to true internally.

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

The System.Windows.RoutedEventArgs that contains the event data.

OnIsOpenedChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises IsOpenedChanged event.

Declaration
protected virtual void OnIsOpenedChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

OnItemsChanged(NotifyCollectionChangedEventArgs)

Invoked when items colllection changed

Declaration
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
Parameters
Type Name Description
System.Collections.Specialized.NotifyCollectionChangedEventArgs e

OnPropertyChanged(DependencyPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

OnSpeedChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises SpeedChanged event.

Declaration
protected virtual void OnSpeedChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

OnVisualStyleChanged(DependencyPropertyChangedEventArgs)

Updates property value cache and raises VisualStyleChanged event.

Declaration
protected virtual void OnVisualStyleChanged(DependencyPropertyChangedEventArgs e)
Parameters
Type Name Description
System.Windows.DependencyPropertyChangedEventArgs e

Property changes details, such as old value and new value.

PrepareContainerForItemOverride(DependencyObject, Object)

Prepares the specified element to display the specified item.

Declaration
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameters
Type Name Description
System.Windows.DependencyObject element

Element used to display the specified item.
System.Object item

Specified item.

SetButtonSize(DependencyObject, Double)

Method sets the value of ButtonSizeProperty property to given object.

Declaration
public static void SetButtonSize(DependencyObject obj, double value)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
System.Double value

New value.

SetGroupPadding(DependencyObject, Thickness)

Method sets the value of GroupPaddingProperty property to given object.

Declaration
public static void SetGroupPadding(DependencyObject obj, Thickness value)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
System.Windows.Thickness value

New value.

SetHeaderStyle(DependencyObject, Style)

Method sets the value of HeaderStyleProperty property to given object.

Declaration
public static void SetHeaderStyle(DependencyObject obj, Style value)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
System.Windows.Style value

New value.

SetIsOpened(DependencyObject, Boolean)

Method sets the value of IsOpenedProperty property to given object.

Declaration
public static void SetIsOpened(DependencyObject obj, bool value)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
System.Boolean value

New value.

SetSpeed(DependencyObject, Double)

Method sets the value of SpeedProperty property to given object.

Declaration
public static void SetSpeed(DependencyObject obj, double value)
Parameters
Type Name Description
System.Windows.DependencyObject obj

Given object.
System.Double value

New value.

Events

ButtonSizeChanged

Event that is raised when ButtonSizeProperty property is changed.

Declaration
public event PropertyChangedCallback ButtonSizeChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

GroupMarginChanged

Event that is raised when GroupMargin property is changed.

Declaration
public event PropertyChangedCallback GroupMarginChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

GroupOrientationChanged

Event that is raised when GroupOrientation property is changed.

Declaration
public event PropertyChangedCallback GroupOrientationChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

GroupPaddingChanged

Event that is raised when GroupPaddingProperty property is changed.

Declaration
public event PropertyChangedCallback GroupPaddingChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

GroupWidthChanged

Event that is raised when GroupWidth property is changed.

Declaration
public event PropertyChangedCallback GroupWidthChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

HeaderStyleChanged

Event that is raised when HeaderStyleProperty property is changed.

Declaration
public event PropertyChangedCallback HeaderStyleChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

IsOpenedChanged

Event that is raised when IsOpenedProperty property is changed.

Declaration
public event PropertyChangedCallback IsOpenedChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

SelectedItemChanged

Occurs when [selected item changed].

Declaration
public event RoutedEventHandler SelectedItemChanged
Event Type
Type Description
System.Windows.RoutedEventHandler

SpeedChanged

Event that is raised when SpeedProperty property is changed.

Declaration
public event PropertyChangedCallback SpeedChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

VisualStyleChanged

Event that is raised when VisualStyle property is changed.

Declaration
public event PropertyChangedCallback VisualStyleChanged
Event Type
Type Description
System.Windows.PropertyChangedCallback

Extension Methods