New to Telerik UI for WPF? Start a free 30-day trial

RadRibbonWindow

Class

Represents a window that integrates a ribbon interface, providing advanced theming, styling, and customization options.

The RadRibbonWindow class extends the Window class to provide additional functionality for applications that use a ribbon-based user interface. It supports theming, custom title bar styles, and integration with the RadRibbonView control. This class is designed to work seamlessly with Telerik's UI components and provides features such as glass effects, custom chrome, and support for various operating system themes. It also includes dependency properties for customizing the appearance and behavior of the window. Key features include:

Customizable title bar styles via the TitleBarStyle property.

Support for glass effects and operating system themes.

Integration with RadRibbonView for ribbon-based UIs.

Dependency properties for controlling visibility, background, and other visual aspects.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:

public class RadRibbonWindow : Window

Inheritance: objectRadRibbonWindow

Constructors

RadRibbonWindow()

Initializes a new instance of the RadRibbonWindow class.

public RadRibbonWindow()

Fields

CaptionButtonsReservedWidthProperty

DependencyProperty

Identifies the CaptionButtonsReservedWidthProperty.

public static readonly DependencyProperty CaptionButtonsReservedWidthProperty

CornerRadiusProperty

DependencyProperty

Identifies the CornerRadius dependency property.

public static readonly DependencyProperty CornerRadiusProperty

IconVisibilityProperty

DependencyProperty

Identifies the IconVisibilityProperty.

public static readonly DependencyProperty IconVisibilityProperty

IsAutoHideTaskbarProperty

DependencyProperty

Identifies the AutoHideTaskbarProperty.

public static readonly DependencyProperty IsAutoHideTaskbarProperty

IsTitleVisibleProperty

DependencyProperty

Identifies the IsTitleVisibleProperty.

public static readonly DependencyProperty IsTitleVisibleProperty

IsUsingGlassProperty

DependencyProperty

Identifies the IsUsingGlassProperty.

public static readonly DependencyProperty IsUsingGlassProperty

TitleBarStyleProperty

DependencyProperty

Identifies the TitleStyle Dependency Property.

public static readonly DependencyProperty TitleBarStyleProperty

WindowBackgroundProperty

DependencyProperty

Identifies the WindowBackground Dependency Property.

public static readonly DependencyProperty WindowBackgroundProperty

Properties

CaptionButtonsReservedWidth

double

Gets or sets the width of the caption buttons reserved.

public double CaptionButtonsReservedWidth { get; }

Property Value:

The width of the caption buttons reserved.

CornerRadius

Gets or sets the CornerRadius property.

public CornerRadius CornerRadius { get; set; }

IconVisibility

Visibility

Gets or sets the icon visibility.

public Visibility IconVisibility { get; set; }

Property Value:

The icon visibility.

IsTitleVisible

bool

Gets or sets whether the title of the RadRibbonView to be displayed in the TitleBar of the Window.

public bool IsTitleVisible { get; set; }

IsUsingGlass

bool

Gets or sets a value indicating whether this instance is using glass.

public bool IsUsingGlass { get; }

Property Value:

True if this instance is using glass; otherwise, false.

IsWindowsThemeEnabled

bool

Gets or sets a value indicating whether the RadRibbonWindow's theme comes from the OS.

public static bool IsWindowsThemeEnabled { get; set; }

Property Value:

True if the theme is coming from the OS; otherwise, false.

TitleBarStyle

Style

Gets or sets the style used by the TitleBar area, including the ApplicationName.

public Style TitleBarStyle { get; set; }

WindowBackground

Brush

Gets or sets the background of the window.

public Brush WindowBackground { get; set; }

Methods

GetIsAutoHideTaskbar(DependencyObject)

Gets the IsAutoHideTaskbar of the operating system.

public static bool GetIsAutoHideTaskbar(DependencyObject obj)

Parameters:objDependencyObjectReturns:

bool

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes call .

public override void OnApplyTemplate()

OnCreateAutomationPeer()

Creates a peer associated with this object.

protected override AutomationPeer OnCreateAutomationPeer()

Returns:

AutomationPeer

An instance of the .

OnInitialized(EventArgs)

Raises the event and sets from the active theme.

protected override void OnInitialized(EventArgs e)

Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

OnTitleBarStyleChanged(Style, Style)

Called when the TitleBarStyle property is changed.

protected virtual void OnTitleBarStyleChanged(Style oldValue, Style newValue)

Parameters:oldValueStylenewValueStyle

ResetTheme()

Resets the theme.

public void ResetTheme()