Class RadFormElement

Represents the root element hierarchy that defines the visual structure and layout of a RadForm's non-client area, including title bar, borders, scrollbars, and MDI control strip components.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadFormElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadFormElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode

Constructors

RadFormElement()

Declaration
public RadFormElement()

Fields

FormWindowStateProperty

Identifies the System.Windows.Forms.FormWindowState dependency property that controls the window state appearance of the form element.

Declaration
public static RadProperty FormWindowStateProperty
Field Value
RadProperty

IsFormActiveProperty

Identifies the IsFormActive dependency property that determines whether the form appears in active or inactive visual state.

Declaration
public static RadProperty IsFormActiveProperty
Field Value
RadProperty

Properties

Border

Gets the FormBorderPrimitive that provides the line-based border rendering for the form element.

Declaration
public FormBorderPrimitive Border { get; }
Property Value
FormBorderPrimitive

BorderWidth

Gets the combined border width as a System.Windows.Forms.Padding structure, calculated from both line and image border components when visible.

Declaration
public Padding BorderWidth { get; }
Property Value
System.Windows.Forms.Padding

HorizontalScrollbar

Gets the RadScrollBarElement configured for horizontal scrolling within the form's client area.

Declaration
public RadScrollBarElement HorizontalScrollbar { get; }
Property Value
RadScrollBarElement

ImageBorder

Gets the FormImageBorderPrimitive that provides image-based border rendering for the form element.

Declaration
public FormImageBorderPrimitive ImageBorder { get; }
Property Value
FormImageBorderPrimitive

IsFormActive

Gets or sets a value indicating whether the form should appear in active or inactive visual state, allowing override of default theme styles that define different appearance based on form activation status.

Declaration
public bool IsFormActive { get; set; }
Property Value
System.Boolean

MdiControlStrip

Gets the RadFormMdiControlStripItem that appears below the title bar when an MDI child window is maximized within the form.

Declaration
public RadFormMdiControlStripItem MdiControlStrip { get; }
Property Value
RadFormMdiControlStripItem

ScrollBarsFormSizingGrip

Gets the sizing grip element that appears at the intersection of horizontal and vertical scrollbars, allowing users to resize the form.

Declaration
public RadItem ScrollBarsFormSizingGrip { get; }
Property Value
RadItem

TitleBar

Gets the RadFormTitleBarElement that contains the form's title, icon, and window control buttons.

Declaration
public RadFormTitleBarElement TitleBar { get; }
Property Value
RadFormTitleBarElement

VerticalScrollbar

Gets the RadScrollBarElement configured for vertical scrolling within the form's client area.

Declaration
public RadScrollBarElement VerticalScrollbar { get; }
Property Value
RadScrollBarElement

Methods

ArrangeOverride(SizeF)

Arranges the form element's child components including image border and scrollbars layout, positioning them within the specified final size while accounting for title bar height and border dimensions.

Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
System.Drawing.SizeF finalSize

The final System.Drawing.SizeF that the form element should use to arrange its child elements.
Returns
System.Drawing.SizeF

The actual System.Drawing.SizeF used by the form element after arranging its children.
Overrides

CreateChildElements()

Creates and initializes all child elements including title bar, borders, scrollbars, MDI control strip, and sizing grip components that comprise the form's visual structure.

Declaration
protected override void CreateChildElements()
Overrides

CreateTitleBarElement()

Creates and returns a new RadFormTitleBarElement instance. Override this method to provide custom title bar implementations.

Declaration
protected virtual RadFormTitleBarElement CreateTitleBarElement()
Returns
RadFormTitleBarElement

A new RadFormTitleBarElement instance to serve as the form's title bar.

MeasureOverride(SizeF)

Measures the desired size of the form element, accounting for border width and thickness when calculating available space for child elements.

Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
System.Drawing.SizeF availableSize

The available System.Drawing.SizeF for the form element to occupy.
Returns
System.Drawing.SizeF

The desired System.Drawing.SizeF that this form element needs to properly display its content.
Overrides

Extension Methods