ClassRadFormElement
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.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadFormElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadFormElement
Implements:
Inherited Members
Constructors
RadFormElement()
Declaration
public RadFormElement()
Fields
FormWindowStateProperty
Identifies the FormWindowState dependency property that controls the window state appearance of the form element.
Declaration
public static RadProperty FormWindowStateProperty
Field Value
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
Properties
Border
Gets the FormBorderPrimitive that provides the line-based border rendering for the form element.
Declaration
public FormBorderPrimitive Border { get; }
Property Value
BorderWidth
Gets the combined border width as a Padding structure, calculated from both line and image border components when visible.
HorizontalScrollbar
Gets the RadScrollBarElement configured for horizontal scrolling within the form's client area.
Declaration
public RadScrollBarElement HorizontalScrollbar { get; }
Property Value
ImageBorder
Gets the FormImageBorderPrimitive that provides image-based border rendering for the form element.
Declaration
public FormImageBorderPrimitive ImageBorder { get; }
Property Value
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
[Browsable(false)]
public bool IsFormActive { get; set; }
Property Value
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
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
TitleBar
Gets the RadFormTitleBarElement that contains the form's title, icon, and window control buttons.
Declaration
public RadFormTitleBarElement TitleBar { get; }
Property Value
VerticalScrollbar
Gets the RadScrollBarElement configured for vertical scrolling within the form's client area.
Declaration
public RadScrollBarElement VerticalScrollbar { get; }
Property Value
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.
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
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.