Represents a contextual group in a RadRibbonView control, which is used to group related ribbon tabs and visually distinguish them with a unique color and header. Contextual groups are typically used to display tabs that are relevant only in specific contexts or workflows.
A RadRibbonContextualGroup is associated with one or more ribbon tabs, and its visibility can be toggled dynamically based on the application's state. The group is identified by its Header and can be styled using the Color property. When the group is active, its associated tabs are displayed in the ribbon. This control supports customization of the header's alignment (HeaderAlignment), header template (HeaderTemplate), and behavior when activated (e.g., selecting the first tab via SelectFirstTabOnActivation).
Definition
Namespace:Telerik.Windows.Controls
Assembly:Telerik.Windows.Controls.RibbonView.dll
Syntax:
[TelerikToolboxCategory("Navigation")]
public class RadRibbonContextualGroup : ControlInheritance: objectRadRibbonContextualGroup
Constructors
Initializes a new instance of the RadRibbonContextualGroup class.
public RadRibbonContextualGroup()Fields
ColorProperty
DependencyProperty
Identifies the Color property.
public static readonly DependencyProperty ColorPropertyGroupNameProperty
DependencyProperty
Identifies the GroupName attached property.
public static readonly DependencyProperty GroupNamePropertyHeaderAlignmentProperty
DependencyProperty
Identifies the Header property.
public static readonly DependencyProperty HeaderAlignmentPropertyHeaderProperty
DependencyProperty
Identifies the Header property.
public static readonly DependencyProperty HeaderPropertyHeaderTemplateProperty
DependencyProperty
Identifies the Header property.
public static readonly DependencyProperty HeaderTemplatePropertyIsActiveChangedEvent
RoutedEvent
Identifies the IsActive routed event.
public static readonly RoutedEvent IsActiveChangedEventIsActiveProperty
DependencyProperty
Identifies the IsActive property.
public static readonly DependencyProperty IsActivePropertySelectFirstTabOnActivationProperty
DependencyProperty
Identifies the SelectFirstTabOnActivation property.
public static readonly DependencyProperty SelectFirstTabOnActivationPropertyProperties
Color
Brush
Gets or sets the base color used for the tabs header and content background brush.
public Brush Color { get; set; }HeaderAlignment
HorizontalAlignment
Represents the header's alignment of the contextual group.
public HorizontalAlignment HeaderAlignment { get; set; }HeaderTemplate
DataTemplate
Represents the header's template of the contextual group.
public DataTemplate HeaderTemplate { get; set; }Gets or sets whether the group is active (visible) or not.
public bool IsActive { get; set; }Gets or sets whether the first contextual tab should be selected on activation of the group.
public bool SelectFirstTabOnActivation { get; set; }Methods
Called to arrange and size the content of a Control object.
protected override Size ArrangeOverride(Size finalSize)The computed size that is used to arrange the content.
Returns:Size
The size of the control.
Gets the value of the GroupName property.
public static string GetGroupName(DependencyObject obj)Called when the control is measured.
protected override Size MeasureOverride(Size availableSize)Size
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().
public override void OnApplyTemplate()Creates a ContextualGroupAutomationPeer.
protected override AutomationPeer OnCreateAutomationPeer()AutomationPeer
A new instance of the ContextualGroupAutomationPeer.
Raises the event. This method is invoked whenever is set to true internally.
protected override void OnInitialized(EventArgs e)The RoutedEventArgs that contains the event data.
Called when the ContextualGroup was clicked.
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)Sets a value for the GroupName property.
public static void SetGroupName(DependencyObject obj, string value)Events
Occurs when contextual group IsActive property has changed.
public event EventHandler<RadRoutedEventArgs> IsActiveChanged