New to Telerik UI for WPFStart a free 30-day trial

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.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:

C#
[TelerikToolboxCategory("Navigation")]
public class RadRibbonContextualGroup : Control

Inheritance: objectRadRibbonContextualGroup

Constructors

Initializes a new instance of the RadRibbonContextualGroup class.

C#
public RadRibbonContextualGroup()

Fields

ColorProperty

DependencyProperty

Identifies the Color property.

C#
public static readonly DependencyProperty ColorProperty

GroupNameProperty

DependencyProperty

Identifies the GroupName attached property.

C#
public static readonly DependencyProperty GroupNameProperty

HeaderAlignmentProperty

DependencyProperty

Identifies the Header property.

C#
public static readonly DependencyProperty HeaderAlignmentProperty

HeaderProperty

DependencyProperty

Identifies the Header property.

C#
public static readonly DependencyProperty HeaderProperty

HeaderTemplateProperty

DependencyProperty

Identifies the Header property.

C#
public static readonly DependencyProperty HeaderTemplateProperty

Identifies the IsActive routed event.

C#
public static readonly RoutedEvent IsActiveChangedEvent

IsActiveProperty

DependencyProperty

Identifies the IsActive property.

C#
public static readonly DependencyProperty IsActiveProperty

Identifies the SelectFirstTabOnActivation property.

C#
public static readonly DependencyProperty SelectFirstTabOnActivationProperty

Properties

Color

Brush

Gets or sets the base color used for the tabs header and content background brush.

C#
public Brush Color { get; set; }

Represents the header of the contextual group.

C#
public object Header { get; set; }

HeaderAlignment

HorizontalAlignment

Represents the header's alignment of the contextual group.

C#
public HorizontalAlignment HeaderAlignment { get; set; }

HeaderTemplate

DataTemplate

Represents the header's template of the contextual group.

C#
public DataTemplate HeaderTemplate { get; set; }

Gets or sets whether the group is active (visible) or not.

C#
public bool IsActive { get; set; }

Gets or sets whether the first contextual tab should be selected on activation of the group.

C#
public bool SelectFirstTabOnActivation { get; set; }

Methods

Called to arrange and size the content of a Control object.

C#
protected override Size ArrangeOverride(Size finalSize)
Parameters:finalSizeSize

The computed size that is used to arrange the content.

Returns:

Size

The size of the control.

Gets the value of the GroupName property.

C#
public static string GetGroupName(DependencyObject obj)
Parameters:objDependencyObjectReturns:

string

Called when the control is measured.

C#
protected override Size MeasureOverride(Size availableSize)
Parameters:availableSizeSizeReturns:

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().

C#
public override void OnApplyTemplate()

Creates a ContextualGroupAutomationPeer.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

A new instance of the ContextualGroupAutomationPeer.

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Called when the ContextualGroup was clicked.

C#
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)
Parameters:eMouseButtonEventArgs

Sets a value for the GroupName property.

C#
public static void SetGroupName(DependencyObject obj, string value)
Parameters:objDependencyObjectvaluestring

Events

Occurs when contextual group IsActive property has changed.

C#
public event EventHandler<RadRoutedEventArgs> IsActiveChanged