Class RadPanel

Used to group collections of controls.

Inheritance
System.Object
RadControl
RadPanel
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Containers")]
public class RadPanel : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider
Remarks

A RadPanel is a control that contains other controls. You can use a RadPanel to group collections of controls such as a group control of radio buttons. If the RadPanel control's Enabled property is set to false, the controls contained within the RadPanel will also be disabled.

You can use the AutoScroll property to enable scroll bars in the RadPanel control. When the AutoScroll property is set to true, any controls located within the RadPanel (but outside of its visible region), can be scrolled to with the scroll bars provided.

The RadPanel control is displayed by default with border and a text (using TextPrimitive). There is a FillPrimitive which is transparent by default. It allows gradients to be used for background of the RadPanel.

Constructors

RadPanel()

Initializes a new instance of the RadPanel class with default settings. Sets up container control styles and scroll event handling.

Declaration
public RadPanel()

Properties

AutoScrollToCurrentControl

Gets or sets a value indicating whether the panel will automatically scroll to show the currently focused control inside it when focus changes.

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

true if the panel automatically scrolls to focused controls; otherwise, false. The default is true

CausesValidation

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

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

true if the control causes validation to be performed on any controls requiring validation when it receives focus; otherwise, false. The default is true

DefaultSize

Gets the default size of the control used during initialization.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

The default System.Drawing.Size of the control (200, 100)

PanelElement

Gets the RadPanelElement that represents the visual element of this panel control. This element contains the visual styling and layout logic for the panel.

Declaration
public RadPanelElement PanelElement { get; }
Property Value
RadPanelElement

A RadPanelElement that represents the panel's visual element

Text

Gets or sets the text displayed on the panel. This property overrides the base implementation to provide panel-specific text handling.

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

The text to display on the panel
Overrides

TextAlignment

Gets or sets the alignment of the text within the panel's bounds. Determines how text is positioned when displayed on the panel.

Declaration
public ContentAlignment TextAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

One of the System.Drawing.ContentAlignment values. The default is MiddleLeft

Methods

CreateChildItems(RadElement)

Creates the main panel element and adds it to the specified parent element. This method is called during control initialization to set up the visual hierarchy.

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

The parent RadElement to which the panel element will be added
Overrides

Dispose(Boolean)

Releases the unmanaged resources used by the RadPanel and optionally releases the managed resources.

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

true to release both managed and unmanaged resources; false to release only unmanaged resources
Overrides

OnControlAdded(ControlEventArgs)

Handles the control added event and sets up auto-sizing behavior for the new control.

Declaration
protected override void OnControlAdded(ControlEventArgs e)
Parameters
System.Windows.Forms.ControlEventArgs e

The System.Windows.Forms.ControlEventArgs containing the added control

OnControlRemoved(ControlEventArgs)

Handles the control removed event and cleans up auto-sizing behavior for the removed control.

Declaration
protected override void OnControlRemoved(ControlEventArgs e)
Parameters
System.Windows.Forms.ControlEventArgs e

The System.Windows.Forms.ControlEventArgs containing the removed control

OnLoad(Size)

Handles the control load event and calculates size if auto-sizing is enabled.

Declaration
protected override void OnLoad(Size desiredSize)
Parameters
System.Drawing.Size desiredSize

The desired size for the control
Overrides

OnTextChanged(EventArgs)

Handles the text changed event and synchronizes the text with the panel element.

Declaration
protected override void OnTextChanged(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs containing event data

OnVisibleChanged(EventArgs)

Handles the visible changed event and recalculates size if auto-sizing is enabled.

Declaration
protected override void OnVisibleChanged(EventArgs e)
Parameters
System.EventArgs e

The System.EventArgs containing event data
Overrides

ProcessAutoSizeChanged(Boolean)

Processes changes to the AutoSize property and manages event subscriptions accordingly.

Declaration
protected override void ProcessAutoSizeChanged(bool value)
Parameters
System.Boolean value

The new AutoSize value
Overrides

ProcessMnemonic(Char)

Processes mnemonic characters for the panel control. If the specified character matches the panel's mnemonic, focuses the next control in the tab order.

Declaration
protected override bool ProcessMnemonic(char charCode)
Parameters
System.Char charCode

The character to process as a mnemonic key
Returns
System.Boolean

true if the character was processed as a mnemonic; otherwise, false
Overrides

ResetBackColorThemeOverrides()

Resets theme overrides for the BackColor property and reapplies the default theme values.

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetForeColorThemeOverrides()

Resets theme overrides for the ForeColor property and reapplies the default theme values.

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

ScrollToControl(Control)

Calculates the scroll position to bring the specified control into view. Respects the AutoScrollToCurrentControl setting.

Declaration
protected override Point ScrollToControl(Control activeControl)
Parameters
System.Windows.Forms.Control activeControl

The control to scroll into view
Returns
System.Drawing.Point

The scroll position needed to display the control

SetBackColorThemeOverrides()

Sets theme overrides for the BackColor property across all visual states of the panel element.

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Sets theme overrides for the ForeColor property across all visual states of the panel element.

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

Extension Methods