Class RadRibbonForm

Represents a specialized form that hosts a RadRibbonBar control and provides Office 2007-style form appearance with advanced theming capabilities and non-client area customization.

Inheritance
System.Object
RadFormControlBase
RadNonClientUIBaseForm<RadRibbonBar, RadRibbonFormBehavior>
RadRibbonForm
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadRibbonForm : RadNonClientUIBaseForm<RadRibbonBar, RadRibbonFormBehavior>, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider
Remarks

The RadRibbonForm extends the standard Windows Forms form by integrating a ribbon interface directly into the form's non-client area, creating a seamless Office-style user experience. This form automatically manages the relationship between the form's title bar and the ribbon control, providing proper visual integration and functionality.

Constructors

RadRibbonForm()

Declaration
public RadRibbonForm()

Properties

FormElement

Gets the RibbonFormElement instance that represents the visual element hierarchy responsible for rendering the ribbon form's appearance and managing its layout.

Declaration
public RibbonFormElement FormElement { get; }
Property Value
RibbonFormElement

The RibbonFormElement that builds and manages the visual structure of this ribbon form, including borders, title bar, and integration points with the ribbon control.

RibbonBar

Gets the RadRibbonBar control that is hosted within this ribbon form's non-client area. This ribbon bar provides the main user interface elements and command organization for the form.

Declaration
public RadRibbonBar RibbonBar { get; }
Property Value
RadRibbonBar

The RadRibbonBar instance that serves as the primary UI control for this form, or null if no ribbon bar has been configured.

ThemeClassName

Gets or sets the theme class name that determines the visual styling and appearance of this ribbon form. This property controls which theme definitions are applied to customize the form's look and feel.

Declaration
public override string ThemeClassName { get; set; }
Property Value
System.String

A string representing the fully qualified theme class name. The default value is "Telerik.WinControls.UI.RadRibbonForm". Setting this property allows customization of the form's appearance through the Telerik theming system.
Overrides

Methods

InitializeFormBehavior()

Creates and initializes the form behavior instance that manages the ribbon form's non-client area interaction, theming, and integration with the hosted RadRibbonBar control.

Declaration
protected override FormControlBehavior InitializeFormBehavior()
Returns
FormControlBehavior

A new instance of RadRibbonFormBehavior configured for this ribbon form.
Overrides
Telerik.WinControls.UI.RadNonClientUIBaseForm<Telerik.WinControls.UI.RadRibbonBar, Telerik.WinControls.UI.RadRibbonFormBehavior>.InitializeFormBehavior()

Extension Methods