C1TabControl Class

Represents a control that contains multiple items that share the same space on the screen.

Inheritance

object

C1TabControl

Implements

INotifyPropertyChanged

IAutomationProperties

Namespace: C1.WPF.TabControl

Assembly: C1.WPF.TabControl.dll

Syntax

[StyleTypedProperty(Property = "ItemContainerStyle", StyleTargetType = typeof(C1TabItem))]
[StyleTypedProperty(Property = "TabStripDropDownIconStyle", StyleTargetType = typeof(ContentControl))]
[StyleTypedProperty(Property = "NextIconStyle", StyleTargetType = typeof(ContentControl))]
[StyleTypedProperty(Property = "PreviousIconStyle", StyleTargetType = typeof(ContentControl))]
[StyleTypedProperty(Property = "NextButtonStyle", StyleTargetType = typeof(C1RepeatButton))]
[StyleTypedProperty(Property = "PreviousButtonStyle", StyleTargetType = typeof(C1RepeatButton))]
[StyleTypedProperty(Property = "TabStripDropDownStyle", StyleTargetType = typeof(C1DropDownButton))]
[StyleTypedProperty(Property = "CloseIconStyle", StyleTargetType = typeof(ContentControl))]
[StyleTypedProperty(Property = "CloseButtonStyle", StyleTargetType = typeof(C1Button))]
[StyleTypedProperty(Property = "TabHeaderStyle", StyleTargetType = typeof(C1TabItemPresenter))]
[StyleTypedProperty(Property = "SelectedTabHeaderStyle", StyleTargetType = typeof(C1TabItemPresenter))]
[StyleTypedProperty(Property = "PopupStyle", StyleTargetType = typeof(C1PopupBorder))]
[TemplatePart(Name = "TabPanel", Type = typeof(C1TabPanel))]
[TemplatePart(Name = "CloseButton", Type = typeof(C1Button))]
[TemplatePart(Name = "SelectedItemContent", Type = typeof(ContentPresenter))]
[TemplatePart(Name = "PreviousButton", Type = typeof(C1RepeatButton))]
[TemplatePart(Name = "NextButton", Type = typeof(C1RepeatButton))]
[TemplatePart(Name = "Menu", Type = typeof(C1MenuList))]
[TemplatePart(Name = "TabStripDropDown", Type = typeof(C1DropDownButton))]
[TemplatePart(Name = "Indicator", Type = typeof(Rectangle))]
[TemplatePart(Name = "IndicatorScale", Type = typeof(ScaleTransform))]
[TemplatePart(Name = "IndicatorTrans", Type = typeof(TranslateTransform))]
[TemplateVisualState(Name = "Normal", GroupName = "CommonStates")]
[TemplateVisualState(Name = "MouseOver", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Focused", GroupName = "CommonStates")]
[TemplateVisualState(Name = "Disabled", GroupName = "CommonStates")]
[TemplateVisualState(Name = "LeftTabStripPlacement", GroupName = "TabStripPlacementStates")]
[TemplateVisualState(Name = "TopTabStripPlacement", GroupName = "TabStripPlacementStates")]
[TemplateVisualState(Name = "RightTabStripPlacement", GroupName = "TabStripPlacementStates")]
[TemplateVisualState(Name = "BottomTabStripPlacement", GroupName = "TabStripPlacementStates")]
[TemplateVisualState(Name = "Rectangle", GroupName = "ShapeStates")]
[TemplateVisualState(Name = "Rounded", GroupName = "ShapeStates")]
[TemplateVisualState(Name = "Sloped", GroupName = "ShapeStates")]
[TemplateVisualState(Name = "Ribbon", GroupName = "ShapeStates")]
public class C1TabControl : C1ItemsControl, INotifyPropertyChanged, IAutomationProperties

<StyleTypedProperty(Property:="ItemContainerStyle", StyleTargetType:=GetType(C1TabItem))>
<StyleTypedProperty(Property:="TabStripDropDownIconStyle", StyleTargetType:=GetType(ContentControl))>
<StyleTypedProperty(Property:="NextIconStyle", StyleTargetType:=GetType(ContentControl))>
<StyleTypedProperty(Property:="PreviousIconStyle", StyleTargetType:=GetType(ContentControl))>
<StyleTypedProperty(Property:="NextButtonStyle", StyleTargetType:=GetType(C1RepeatButton))>
<StyleTypedProperty(Property:="PreviousButtonStyle", StyleTargetType:=GetType(C1RepeatButton))>
<StyleTypedProperty(Property:="TabStripDropDownStyle", StyleTargetType:=GetType(C1DropDownButton))>
<StyleTypedProperty(Property:="CloseIconStyle", StyleTargetType:=GetType(ContentControl))>
<StyleTypedProperty(Property:="CloseButtonStyle", StyleTargetType:=GetType(C1Button))>
<StyleTypedProperty(Property:="TabHeaderStyle", StyleTargetType:=GetType(C1TabItemPresenter))>
<StyleTypedProperty(Property:="SelectedTabHeaderStyle", StyleTargetType:=GetType(C1TabItemPresenter))>
<StyleTypedProperty(Property:="PopupStyle", StyleTargetType:=GetType(C1PopupBorder))>
<TemplatePart(Name:="TabPanel", Type:=GetType(C1TabPanel))>
<TemplatePart(Name:="CloseButton", Type:=GetType(C1Button))>
<TemplatePart(Name:="SelectedItemContent", Type:=GetType(ContentPresenter))>
<TemplatePart(Name:="PreviousButton", Type:=GetType(C1RepeatButton))>
<TemplatePart(Name:="NextButton", Type:=GetType(C1RepeatButton))>
<TemplatePart(Name:="Menu", Type:=GetType(C1MenuList))>
<TemplatePart(Name:="TabStripDropDown", Type:=GetType(C1DropDownButton))>
<TemplatePart(Name:="Indicator", Type:=GetType(Rectangle))>
<TemplatePart(Name:="IndicatorScale", Type:=GetType(ScaleTransform))>
<TemplatePart(Name:="IndicatorTrans", Type:=GetType(TranslateTransform))>
<TemplateVisualState(Name:="Normal", GroupName:="CommonStates")>
<TemplateVisualState(Name:="MouseOver", GroupName:="CommonStates")>
<TemplateVisualState(Name:="Focused", GroupName:="CommonStates")>
<TemplateVisualState(Name:="Disabled", GroupName:="CommonStates")>
<TemplateVisualState(Name:="LeftTabStripPlacement", GroupName:="TabStripPlacementStates")>
<TemplateVisualState(Name:="TopTabStripPlacement", GroupName:="TabStripPlacementStates")>
<TemplateVisualState(Name:="RightTabStripPlacement", GroupName:="TabStripPlacementStates")>
<TemplateVisualState(Name:="BottomTabStripPlacement", GroupName:="TabStripPlacementStates")>
<TemplateVisualState(Name:="Rectangle", GroupName:="ShapeStates")>
<TemplateVisualState(Name:="Rounded", GroupName:="ShapeStates")>
<TemplateVisualState(Name:="Sloped", GroupName:="ShapeStates")>
<TemplateVisualState(Name:="Ribbon", GroupName:="ShapeStates")>
Public Class C1TabControl
    Inherits C1ItemsControl
    Implements INotifyPropertyChanged, IAutomationProperties

Constructors

Name	Description
C1TabControl()	Initializes a new instance of the C1TabControl class.

Fields

Name	Description
CanUserReorderProperty	Identifies the CanUserReorder dependency property.
CloseButtonStyleProperty	Identifies the CloseButtonStyle dependency property.
CloseIconStyleProperty	Identifies the CloseIconStyle dependency property.
CloseIconTemplateProperty	Identifies the CloseIconTemplate dependency property.
ContentTemplateProperty	Identifies the ContentTemplate dependency property.
ContentTemplateSelectorProperty	Identifies the ContentTemplateSelectorProperty dependency property.
IndicatorBrushProperty	Identifies the IndicatorBrush dependency property.
IndicatorPlacementProperty	Identifies the IndicatorPlacement dependency property.
IndicatorSizeProperty	Identifies the IndicatorSize dependency property.
IndicatorVisibilityProperty	Identifies the IndicatorVisibility dependency property.
MouseOverBrushProperty	Identifies the MouseOverBrush dependency property.
NextButtonStyleProperty	Identifies the NextButtonStyle dependency property.
NextIconStyleProperty	Identifies the NextIconStyle dependency property.
NextIconTemplateProperty	Identifies the NextIconTemplate dependency property.
PopupStyleProperty	Identifies the PopupStyle dependency property.
PressedBrushProperty	Identifies the PressedBrush dependency property.
PreviousButtonStyleProperty	Identifies the PreviousButtonStyle dependency property.
PreviousIconStyleProperty	Identifies the PreviousIconStyle dependency property.
PreviousIconTemplateProperty	Identifies the PreviousIconTemplate dependency property.
SelectedContentProperty	Identifies the SelectedContent dependency property.
SelectedIndexProperty	Identifies the SelectedIndex dependency property.
SelectedItemProperty	Identifies the System.Windows.Controls.TabControl.SelectedItem dependency property.
SelectedTabHeaderStyleProperty	Identifies the SelectedTabHeaderStyle dependency property.
ShowSingleTabProperty	Identifies the ShowSingleTab dependency property.
TabHeaderStyleProperty	Identifies the TabHeaderStyle dependency property.
TabItemCloseProperty	Identifies the TabItemClose dependency property.
TabItemRotationProperty	Identifies the TabItemRotation dependency property.
TabItemShapeProperty	Identifies the TabItemShape dependency property.
TabStripDropDownIconStyleProperty	Identifies the TabStripDropDownIconStyle dependency property.
TabStripDropDownIconTemplateProperty	Identifies the TabStripDropDownIconTemplate dependency property.
TabStripDropDownStyleProperty	Identifies the TabStripDropDownStyle dependency property.
TabStripHorizontalAlignmentProperty	Identifies the TabStripHorizontalAlignment dependency property.
TabStripMenuVisibilityProperty	Identifies the TabStripMenuVisibility dependency property.
TabStripOverlapDirectionProperty	Identifies the TabStripOverlapDirection dependency property.
TabStripOverlapProperty	Identifies the TabStripOverlap dependency property.
TabStripPlacementProperty	Identifies the TabStripPlacement dependency property.
TabStripVerticalAlignmentProperty	Identifies the TabStripVerticalAlignment dependency property.
UnselectedContentModeProperty	Identifies the UnselectedContentMode dependency property.
UpdateSourceCollectionProperty	Identifies the UpdateSourceCollection dependency property.

Properties

Name	Description
ActualSelectedTabHeaderStyle	Gets the actual style that will be applied to the row-header cells when they are selected.
AutomationEnabled
CanUserReorder	Whether the user is allowed to drag and drop and reorder C1TabItems from this C1TabControl.
CloseButtonStyle	Gets or sets the style of the close button.
CloseIconStyle	Gets or sets the style of the close icon.
CloseIconTemplate	Gets or sets the template of the close icon.
ContentTemplate	Gets or sets the DataTemplate to apply to any TabItem that does not have a ContentTemplate property defined.
ContentTemplateSelector	Gets or sets a custom logic for choosing the template used to display the content of the control
IndicatorBrush	Brush for Indicator
IndicatorPlacement	Gets or sets the location of the panel with the tabs relative to the indicator.
IndicatorSize	Gets or sets the indicator size.
IndicatorVisibility	Gets or sets the visibility of the indicator.
IsFocused	Gets whether the control is focused.
MouseOverBrush	Gets or sets the Brush used to highlight the control when it has the mouse over.
NextButtonStyle	Gets or sets the style of the next button.
NextIconStyle	Gets or sets icon style of the next button.
NextIconTemplate	Gets or sets icon template of the next button.
PopupStyle	Gets or sets the style of the popup.
PressedBrush	Gets or sets the Brush used to paint a button when it is pressed.
PreviousButtonStyle	Gets or sets the style of the previous button.
PreviousIconStyle	Gets or sets icon style of the previous button.
PreviousIconTemplate	Gets or sets icon template of the previous button.
SelectedContent	Gets the content of the currently selected TabItem.
SelectedIndex	Gets or sets the index of the currently selected TabItem.
SelectedItem	Gets or sets the selected item or returns null if the selection is empty.
SelectedTabHeaderStyle	Gets or sets the style of the selected tab header.
ShowSingleTab	Gets or sets a value that determines whether the tab strip is shown when the control has only one child.
TabHeaderStyle	Gets or sets the style of the tab header.
TabItemClose	Gets or sets the location of the Close button.
TabItemRotation	Gets or sets angle of rotation of tab item content.
TabItemShape	Gets or sets the geometric shape of the tabs.
TabPanel
TabStripDropDownIconStyle	Gets or sets icon style of the tab strip drop down.
TabStripDropDownIconTemplate	Gets or sets icon template of the tab strip drop down.
TabStripDropDownStyle	Gets or sets the style of the tab-strip drop-down which show the hidden tabs in a menu.
TabStripHorizontalAlignment	Gets or sets the horizontal alignment of the group of C1TabItems.
TabStripMenuVisibility	Gets or sets the visibility of the menu listing the items.
TabStripOverlap	Gets or sets the length of the overlap between C1TabItems.
TabStripOverlapDirection	Gets or sets the Z-Index arrangement of the C1TabItems.
TabStripPlacement	Gets or sets the location of the panel with the tabs relative to the whole control.
TabStripVerticalAlignment	Gets or sets the vertical alignment of the group of C1TabItems.
UnselectedContentMode	Gets or sets what is done with the content of unselected items.
UpdateSourceCollection	Gets or sets whether changes in the order of the items are written to Items or ItemsSource.
VisibleItems	A read-only collection that contains all visible items in the C1TabControl

Methods

Name	Description
BeginUpdate()	Maintains performance while items are added to the TabControl one at a time by preventing the control from updating until the EndUpdate() method is called.
ChangeVisualStateCommon(bool)	Updates the current visual state of the Common visual state group to match the object's properties.
ChangeVisualStateShape(bool)	Updates the current visual state of the Shape visual state group to match the object's properties.
ChangeVisualStateTabStripPlacement(bool)	Updates the current visual state of the TabStripPlacement visual state group to match the object's properties.
ClearContainerForItemOverride(DependencyObject, object)
Dispose(bool)
EndUpdate()	Resumes updating the TabControl after updates are suspended by the BeginUpdate() method.
GetContainerForItemOverride()
IsItemItsOwnContainerOverride(object)
OnApplyTemplate()
OnCreateAutomationPeer()
OnItemsChanged(NotifyCollectionChangedEventArgs)	Called when the value of the Items property changes.
OnPropertyChanged(string)	Called when a property changes.
PrepareContainerForItemOverride(DependencyObject, object)
ScrollIntoView(object)	Causes the object to scroll into view.

Events

Name	Description
ItemsChanged	Called when the value of the System.Windows.Controls.ItemsControl.Items property changes.
PropertyChanged	Called when a property changed.
SelectionChanged	Occurs when selection changed.
TabItemClosed	Occurs when a C1TabItem is closed.
TabItemClosing	Occurs before a C1TabItem is closed.
VisibleItemsChanged	Occurs when the visible items change.