Class RadForm
Represents a Telerik themed form control that provides enhanced visual styling and customization capabilities. This class serves as the base for creating custom forms with Telerik theming support and advanced UI features.
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll
Syntax
public class RadForm : RadFormControlBase, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider
Constructors
RadForm()
Properties
AllowTheming
Gets or sets a value indicating whether the form customizes its non-client area when running under Vista with Desktop Window Manager composition enabled.
Declaration
public override bool AllowTheming { get; set; }
Property Value
|
System.Boolean
|
Overrides
FormElement
Gets the RadFormElement instance that represents the element hierarchy which builds the form's visual appearance and behavior.
Declaration
public RadFormElement FormElement { get; }
Property Value
|
RadFormElement
|
IconScaling
Gets or sets the scaling mode of the form's icon displayed in the title bar.
Declaration
public ImageScaling IconScaling { get; set; }
Property Value
|
ImageScaling
|
ShowIcon
Gets or sets a value indicating whether an icon is displayed in the caption bar of the form.
Declaration
public bool ShowIcon { get; set; }
Property Value
|
System.Boolean
|
Text
Gets or sets the text associated with this form, typically displayed in the title bar.
Declaration
public override string Text { get; set; }
Property Value
|
System.String
The text associated with this control. |
ThemeClassName
Gets or sets the class name of the theme to be used for styling this form. Returns different class names based on whether the form is using ribbon behavior.
Declaration
public override string ThemeClassName { get; set; }
Property Value
|
System.String
|
Overrides
Methods
Dispose(Boolean)
Clean up any resources being used.
Declaration
protected override void Dispose(bool disposing)
Parameters
|
System.Boolean
disposing
true if managed resources should be disposed; otherwise, false. |
Overrides
EndInit()
Signals the object that initialization is complete and applies any pending theming settings.
Declaration
public override void EndInit()
Overrides
InitializeFormBehavior()
Initializes the form behavior instance that handles the form's non-client area and visual appearance.
Declaration
protected override FormControlBehavior InitializeFormBehavior()
Returns
|
FormControlBehavior
A new RadFormBehavior instance configured for this form. |
Overrides
OnLoad(EventArgs)
Raises the System.Windows.Forms.Form.Load event and applies any pending theming settings.
Declaration
protected override void OnLoad(EventArgs e)
Parameters
|
System.EventArgs
e
An System.EventArgs that contains the event data. |
Overrides
ProcessCaptureChangeRequested(RadElement, Boolean)
Prevents the form from getting mouse capture when the capture is requested by one of the system buttons.
Declaration
protected override bool ProcessCaptureChangeRequested(RadElement element, bool capture)
Parameters
|
RadElement
element
The element requesting capture. |
|
System.Boolean
capture
True to capture the mouse; false to release it. |
Returns
|
System.Boolean
True if the capture change is allowed; otherwise, false. |
Overrides
ScrollToControl(Control)
Scrolls the form to make the specified control visible and synchronizes scrollbar values.
Declaration
protected override Point ScrollToControl(Control activeControl)
Parameters
|
System.Windows.Forms.Control
activeControl
The control to scroll to and make visible. |
Returns
|
System.Drawing.Point
The point where the control was scrolled to in client coordinates. |
SetIconPrimitiveVisibility(Boolean)
Sets the visibility of the icon primitive in the form's title bar.
Declaration
protected override void SetIconPrimitiveVisibility(bool visible)
Parameters
|
System.Boolean
visible
True to show the icon; false to hide it. |