ClassRibbonTab
Represents a ribbon tab. Ribbon tabs are used to manage between different groups of related operations, for example, in a text editor application between write and insert functionality.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RibbonTab : RadPageViewStripItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadPageViewElementBaseRadPageViewItemRadPageViewStripItemRibbonTab
Derived Classes:
Implements:
Inherited Members
Constructors
RibbonTab()
Initializes a new instance of the RadRibbonBarCommandTab class.
Declaration
public RibbonTab()
Fields
LeftShadowInnerColor1Property
Declaration
public static RadProperty LeftShadowInnerColor1Property
Field Value
LeftShadowInnerColor2Property
Declaration
public static RadProperty LeftShadowInnerColor2Property
Field Value
LeftShadowOuterColor1Property
Declaration
public static RadProperty LeftShadowOuterColor1Property
Field Value
LeftShadowOuterColor2Property
Declaration
public static RadProperty LeftShadowOuterColor2Property
Field Value
RightShadowInnerColor1Property
Declaration
public static RadProperty RightShadowInnerColor1Property
Field Value
RightShadowInnerColor2Property
Declaration
public static RadProperty RightShadowInnerColor2Property
Field Value
RightShadowOuterColor1Property
Declaration
public static RadProperty RightShadowOuterColor1Property
Field Value
RightShadowOuterColor2Property
Declaration
public static RadProperty RightShadowOuterColor2Property
Field Value
Properties
CanBeAddedToContextualGroup
Declaration
protected virtual bool CanBeAddedToContextualGroup { get; }
Property Value
ContentLayout
Gets an instance of the ExpandableStackLayoutclass that represents the content layout of the tab. In this layout all chunks visible to the end user are put.
Declaration
[Browsable(false)]
public ExpandableStackLayout ContentLayout { get; }
Property Value
ContentPanel
Declaration
public RadTabStripContentPanel ContentPanel { get; }
Property Value
ContextualTabGroup
Gets or sets the ContextualTabGroup of this CommandTab.
Declaration
[Browsable(false)]
public ContextualTabGroup ContextualTabGroup { get; set; }
Property Value
IsSelected
Gets a value indicating whether this item is currently selected (associated with the SelectedPage of the owning RadPageView). Selection affects visual appearance and content display.
Declaration
[Browsable(false)]
public override bool IsSelected { get; set; }
Property Value
Overrides
Items
Gets the nested items.
Declaration
[RadNewItem("Add New Group...", true, false, false)]
public virtual RadItemOwnerCollection Items { get; }
Property Value
LeftShadowInnerColor1
Gets or sets the first left inner color of the RibbonTab's shadow.
LeftShadowInnerColor2
Gets or sets the second left inner color of the RibbonTab's shadow.
LeftShadowOuterColor1
Gets or sets the first left outer color of the RibbonTab's shadow.
LeftShadowOuterColor2
Gets or sets the second left outer color of the RibbonTab's shadow.
RightShadowInnerColor1
Gets or sets the first right inner color of the RibbonTab's shadow.
Declaration
public Color RightShadowInnerColor1 { get; set; }
Property Value
RightShadowInnerColor2
Gets or sets the second right inner color of the RibbonTab's shadow.
Declaration
public Color RightShadowInnerColor2 { get; set; }
Property Value
RightShadowOuterColor1
Gets or sets the first right outer color of the RibbonTab's shadow.
Declaration
public Color RightShadowOuterColor1 { get; set; }
Property Value
RightShadowOuterColor2
Gets or sets the second right outer color of the RibbonTab's shadow.
Declaration
public Color RightShadowOuterColor2 { get; set; }
Property Value
Tab
The RibbonTab tab item
Declaration
public RadPageViewItem Tab { get; set; }
Property Value
Methods
DisposeManagedResources()
Disposes of managed resources by detaching from the associated page and clearing owner references to prevent memory leaks and ensure proper cleanup.
Declaration
protected override void DisposeManagedResources()
Overrides
InitializeFields()
Initializes default field values for the page view item, setting up drag support, sizing constraints, text and image alignment, and keyboard interaction properties.
Declaration
protected override void InitializeFields()
Overrides
OnPropertyChanged(RadPropertyChangedEventArgs)
Handles property change events by invalidating the fill cache and invoking the base class property change handler.
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
e
Event arguments containing information about the property that changed.
Overrides
OnPropertyChanging(RadPropertyChangingEventArgs)
Called before a property value is changed, allowing for validation or cancellation of text changes.
Declaration
protected override void OnPropertyChanging(RadPropertyChangingEventArgs e)
Parameters
e
Overrides
PaintElement(IGraphics, float, SizeF)
Paints the element by applying appropriate orientation transforms for fill, content, and border painting, ensuring each painting phase uses the correct coordinate system for proper visual rendering.
Declaration
protected override void PaintElement(IGraphics graphics, float angle, SizeF scale)
Parameters
graphics
The graphics context for painting operations.
angle
The rotation angle for painting transformations.
scale
The scale factor for painting operations.
Overrides