RibbonTabItem Class
Represents a tab control within a ActiproSoftware.Windows.Controls.Bars.RibbonTabItem.Ribbon.
[TemplatePart(Name = "PART_OverflowButton", Type = typeof(RibbonTabItemOverflowButton))]
[TemplatePart(Name = "PART_OverflowPresenter", Type = typeof(OverflowPresenter))]
public class RibbonTabItem : ItemsControl, IOrientedElement
- Inheritance:
- object Visual UIElement FrameworkElement Control ItemsControl object
- Implements:
- IOrientedElement
Constructors
RibbonTabItem()
Initializes a new instance of the RibbonTabItem class.
public RibbonTabItem()
Properties
ContextualTabGroup
Gets the RibbonContextualTabGroup that owns this tab, if this is a contextual tab.
public RibbonContextualTabGroup ContextualTabGroup { get; }
Property Value
- RibbonContextualTabGroup:
The RibbonContextualTabGroup that owns this tab, if this is a contextual tab
See Also
ContextualTabGroupKey
Gets or sets the string key of the related contextual tab group, if this should be a contextual tab.
[Localizability(LocalizationCategory.NeverLocalize)]
public string ContextualTabGroupKey { get; set; }
Property Value
- string:
The string key of the related contextual tab group, if this should be a contextual tab.
ControlVariants
Gets or sets the collection of variant size transitions to apply to all controls within the tab when the ribbon is in Simplified layout mode.
public VariantCollection ControlVariants { get; set; }
Property Value
- VariantCollection:
The collection of variant size transitions to apply to all controls within the tab when the ribbon is in Simplified layout mode.
GroupLabelMode
Gets the RibbonGroupLabelMode that specifies when a RibbonGroup is labeled.
public RibbonGroupLabelMode GroupLabelMode { get; }
Property Value
- RibbonGroupLabelMode:
The RibbonGroupLabelMode that specifies when a RibbonGroup is labeled. The default value is Default.
GroupVariants
Gets or sets the collection of variant size transitions to apply to all groups within the tab when the ribbon is in Classic layout mode.
public VariantCollection GroupVariants { get; set; }
Property Value
- VariantCollection:
The collection of variant size transitions to apply to all groups within the tab when the ribbon is in Classic layout mode.
HeaderToolTip
Gets the tooltip for the tab header.
IsFirstTabInContextualTabGroup
Gets whether this is the first tab in a ContextualTabGroup.
public bool IsFirstTabInContextualTabGroup { get; }
Property Value
- bool:
true
if this is the first tab in a ContextualTabGroup; otherwise,false
.
IsLastTabInContextualTabGroup
Gets whether this is the last tab in a ContextualTabGroup.
public bool IsLastTabInContextualTabGroup { get; }
Property Value
- bool:
true
if this is the last tab in a ContextualTabGroup; otherwise,false
.
IsOverflowButtonVisible
Gets whether the overflow button is visible.
public bool IsOverflowButtonVisible { get; }
Property Value
- bool:
true
if the overflow button is visible; otherwise,false
.
IsSelected
Gets or sets whether the tab is currently selected.
public bool IsSelected { get; set; }
Property Value
- bool:
true
if the tab is currently selected; otherwise,false
. The default value isfalse
.
Key
Gets or sets a string that uniquely identifies the control.
[Localizability(LocalizationCategory.NeverLocalize)]
public string Key { get; set; }
Property Value
- string:
A string that uniquely identifies the control.
KeyTipText
Gets or sets the key tip text used to access the control.
[Localizability(LocalizationCategory.Label)]
public string KeyTipText { get; set; }
Property Value
- string:
The key tip text used to access the control.
Label
Gets or sets the text label to display.
[Localizability(LocalizationCategory.Label)]
public string Label { get; set; }
Property Value
- string:
The text label to display.
LayoutMode
Gets or sets a RibbonLayoutMode indicating the layout mode in use.
public RibbonLayoutMode LayoutMode { get; set; }
Property Value
- RibbonLayoutMode:
A RibbonLayoutMode indicating the layout mode in use.
OverflowButtonToolTip
Gets or sets the tooltip for the overflow button.
public object OverflowButtonToolTip { get; set; }
Property Value
- object:
The tooltip for the overflow button.
Title
Gets or sets the string title, which can override the Label when displayed in screen tips and customization UI.
[Localizability(LocalizationCategory.Title)]
public string Title { get; set; }
Property Value
- string:
The string title.
UserInterfaceDensity
Gets or sets a UserInterfaceDensity that indicates how compact or spacious the UI should appear.
public UserInterfaceDensity UserInterfaceDensity { get; set; }
Property Value
- UserInterfaceDensity:
A UserInterfaceDensity that indicates how compact or spacious the UI should appear. The default value is Compact.
Methods
ClearContainerForItemOverride(DependencyObject, object)
When overridden in a derived class, undoes the effects of the PrepareContainerForItemOverride(DependencyObject, object) method.
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
Parameter | Type | Description |
---|---|---|
element | DependencyObject | The container element. |
item | object | The item. |
GetContainerForItemOverride()
Creates or identifies the element that is used to display the given item.
protected override DependencyObject GetContainerForItemOverride()
Returns
- DependencyObject:
The element that is used to display the given item.
IsItemItsOwnContainerOverride(object)
Determines if the specified item is (or is eligible to be) its own container.
protected override bool IsItemItsOwnContainerOverride(object item)
Parameter | Type | Description |
---|---|---|
item | object | The item to check. |
Returns
- bool:
true
if the item is (or is eligible to be) its own container; otherwise,false
.
OnApplyTemplate()
When overridden in a derived class, is invoked whenever application code or internal processes call ApplyTemplate().
public override void OnApplyTemplate()
OnCreateAutomationPeer()
Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.
protected override AutomationPeer OnCreateAutomationPeer()
Returns
- AutomationPeer:
The type-specific AutomationPeer implementation.
PrepareContainerForItemOverride(DependencyObject, object)
Prepares the specified element to display the specified item.
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameter | Type | Description |
---|---|---|
element | DependencyObject | Element used to display the specified item. |
item | object | Specified item. |
ToString()
Returns the string representation of this object.
Fields
ContextualTabGroupKeyProperty
Identifies the ContextualTabGroupKey dependency property. This field is read-only.
public static readonly DependencyProperty ContextualTabGroupKeyProperty
ContextualTabGroupProperty
Identifies the ContextualTabGroup dependency property. This field is read-only.
public static readonly DependencyProperty ContextualTabGroupProperty
ControlVariantsProperty
Identifies the ControlVariants dependency property. This field is read-only.
public static readonly DependencyProperty ControlVariantsProperty
GroupLabelModeProperty
Identifies the GroupLabelMode dependency property. This field is read-only.
public static readonly DependencyProperty GroupLabelModeProperty
GroupVariantsProperty
Identifies the GroupVariants dependency property. This field is read-only.
public static readonly DependencyProperty GroupVariantsProperty
HeaderToolTipProperty
Identifies the HeaderToolTip dependency property. This field is read-only.
public static readonly DependencyProperty HeaderToolTipProperty
IsFirstTabInContextualTabGroupProperty
Identifies the IsFirstTabInContextualTabGroup dependency property. This field is read-only.
public static readonly DependencyProperty IsFirstTabInContextualTabGroupProperty
IsLastTabInContextualTabGroupProperty
Identifies the IsLastTabInContextualTabGroup dependency property. This field is read-only.
public static readonly DependencyProperty IsLastTabInContextualTabGroupProperty
IsOverflowButtonVisibleProperty
Identifies the IsOverflowButtonVisible dependency property. This field is read-only.
public static readonly DependencyProperty IsOverflowButtonVisibleProperty
IsSelectedProperty
Identifies the IsSelected dependency property. This field is read-only.
public static readonly DependencyProperty IsSelectedProperty
KeyProperty
Identifies the Key dependency property. This field is read-only.
public static readonly DependencyProperty KeyProperty
KeyTipTextProperty
Identifies the KeyTipText dependency property. This field is read-only.
public static readonly DependencyProperty KeyTipTextProperty
LabelProperty
Identifies the Label dependency property. This field is read-only.
public static readonly DependencyProperty LabelProperty
LayoutModeProperty
Identifies the LayoutMode dependency property. This field is read-only.
public static readonly DependencyProperty LayoutModeProperty
OverflowButtonToolTipProperty
Identifies the OverflowButtonToolTip dependency property. This field is read-only.
public static readonly DependencyProperty OverflowButtonToolTipProperty
RibbonProperty
Identifies the ActiproSoftware.Windows.Controls.Bars.RibbonTabItem.Ribbon dependency property. This field is read-only.
public static readonly DependencyProperty RibbonProperty
TitleProperty
Identifies the Title dependency property. This field is read-only.
public static readonly DependencyProperty TitleProperty
UserInterfaceDensityProperty
Identifies the UserInterfaceDensity dependency property. This field is read-only.
public static readonly DependencyProperty UserInterfaceDensityProperty