Class
RadRibbonContextualGroup

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:

cs-api-definition
[TelerikToolboxCategory("Navigation")]
public class RadRibbonContextualGroup : Control

Inheritance: objectRadRibbonContextualGroup

Constructors

RadRibbonContextualGroup()

Initializes a new instance of the RadRibbonContextualGroup class.

Declaration

cs-api-definition
public RadRibbonContextualGroup()

Fields

ColorProperty

Identifies the Color property.

Declaration

cs-api-definition
public static readonly DependencyProperty ColorProperty

Field Value

DependencyProperty

GroupNameProperty

Identifies the GroupName attached property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupNameProperty

Field Value

DependencyProperty

HeaderAlignmentProperty

Identifies the Header property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderAlignmentProperty

Field Value

DependencyProperty

HeaderProperty

Identifies the Header property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderProperty

Field Value

DependencyProperty

HeaderTemplateProperty

Identifies the Header property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderTemplateProperty

Field Value

DependencyProperty

IsActiveChangedEvent

Identifies the IsActive routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent IsActiveChangedEvent

Field Value

RoutedEvent

IsActiveProperty

Identifies the IsActive property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsActiveProperty

Field Value

DependencyProperty

SelectFirstTabOnActivationProperty

Identifies the SelectFirstTabOnActivation property.

Declaration

cs-api-definition
public static readonly DependencyProperty SelectFirstTabOnActivationProperty

Field Value

DependencyProperty

Properties

Color

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

Declaration

cs-api-definition
public Brush Color { get; set; }

Property Value

Brush

Header

Represents the header of the contextual group.

Declaration

cs-api-definition
public object Header { get; set; }

Property Value

object

HeaderAlignment

Represents the header's alignment of the contextual group.

Declaration

cs-api-definition
public HorizontalAlignment HeaderAlignment { get; set; }

Property Value

HorizontalAlignment

HeaderTemplate

Represents the header's template of the contextual group.

Declaration

cs-api-definition
public DataTemplate HeaderTemplate { get; set; }

Property Value

DataTemplate

IsActive

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

Declaration

cs-api-definition
public bool IsActive { get; set; }

Property Value

bool

SelectFirstTabOnActivation

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

Declaration

cs-api-definition
public bool SelectFirstTabOnActivation { get; set; }

Property Value

bool

Methods

ArrangeOverride(Size)

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

Declaration

cs-api-definition
protected override Size ArrangeOverride(Size finalSize)

Parameters

finalSize

Size

The computed size that is used to arrange the content.

Returns

Size

The size of the control.

GetGroupName(DependencyObject)

Gets the value of the GroupName property.

Declaration

cs-api-definition
public static string GetGroupName(DependencyObject obj)

Parameters

obj

DependencyObject

Returns

string

MeasureOverride(Size)

Called when the control is measured.

Declaration

cs-api-definition
protected override Size MeasureOverride(Size availableSize)

Parameters

availableSize

Size

Returns

Size

OnApplyTemplate()

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

Declaration

cs-api-definition
public override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates a ContextualGroupAutomationPeer.

Declaration

cs-api-definition
protected override AutomationPeer OnCreateAutomationPeer()

Returns

AutomationPeer

A new instance of the ContextualGroupAutomationPeer.

OnInitialized(EventArgs)

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

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

The RoutedEventArgs that contains the event data.

OnMouseLeftButtonUp(MouseButtonEventArgs)

Called when the ContextualGroup was clicked.

Declaration

cs-api-definition
protected override void OnMouseLeftButtonUp(MouseButtonEventArgs e)

Parameters

e

MouseButtonEventArgs

SetGroupName(DependencyObject, string)

Sets a value for the GroupName property.

Declaration

cs-api-definition
public static void SetGroupName(DependencyObject obj, string value)

Parameters

obj

DependencyObject

value

string

Events

IsActiveChanged

Occurs when contextual group IsActive property has changed.

Declaration

cs-api-definition
public event EventHandler<RadRoutedEventArgs> IsActiveChanged

Event Value

EventHandler<RadRoutedEventArgs>