RadGroupBox
Represents a group box control that visually groups related controls and optionally defines radio button groups. Inherits from RadControl and provides customizable header and footer areas with theming support.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Containers")]
public class RadGroupBox : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadGroupBox...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadGroupBox class with default settings. Sets up container control styles and accessibility properties.
public RadGroupBox()Properties
Gets the default size of the group box control when no explicit size is specified.
protected override Size DefaultSize { get; }Overrides:
Gets or sets the image displayed in the footer area of the group box.
public Image FooterImage { get; set; }Gets or sets the alignment of the footer image within the footer area.
public ContentAlignment FooterImageAlignment { get; set; }Gets or sets the index used to retrieve the footer image from an associated image list.
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int FooterImageIndex { get; set; }Gets or sets the key used to retrieve the footer image from an associated image list.
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string FooterImageKey { get; set; }Gets or sets the text content displayed in the footer area of the group box.
public string FooterText { get; set; }Gets or sets the alignment of the footer text within the footer area.
public ContentAlignment FooterTextAlignment { get; set; }Gets or sets the spatial relationship between the footer text and footer image.
public TextImageRelation FooterTextImageRelation { get; set; }Gets or sets the visibility state of the footer area in the group box.
public ElementVisibility FooterVisibility { get; set; }Gets the RadGroupBoxElement that provides the visual representation and functionality of the group box.
[Browsable(false)]
public RadGroupBoxElement GroupBoxElement { get; }Gets or sets the visual style of the group box, determining its overall appearance theme.
public RadGroupBoxStyle GroupBoxStyle { get; set; }Gets or sets the alignment of the header within its designated position area.
public HeaderAlignment HeaderAlignment { get; set; }Gets or sets the image displayed in the header area of the group box.
public Image HeaderImage { get; set; }Gets or sets the alignment of the header image within the header area.
public ContentAlignment HeaderImageAlignment { get; set; }Gets or sets the index used to retrieve the header image from an associated image list.
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int HeaderImageIndex { get; set; }Gets or sets the key used to retrieve the header image from an associated image list.
[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.817.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string HeaderImageKey { get; set; }Gets or sets the margin around the header area that controls spacing from surrounding elements.
public Padding HeaderMargin { get; set; }Gets or sets the position of the header relative to the group box content area.
public HeaderPosition HeaderPosition { get; set; }Gets or sets the text content displayed in the header area of the group box.
public string HeaderText { get; set; }Gets or sets the alignment of the header text within the header area.
public ContentAlignment HeaderTextAlignment { get; set; }Gets or sets the spatial relationship between the header text and header image.
public TextImageRelation HeaderTextImageRelation { get; set; }Gets or sets the padding within the group box border that defines the spacing between the border and child controls.
public Padding Padding { get; set; }Gets or sets the header text displayed at the top of the group box. This property provides a convenient way to set the header content.
public override string Text { get; set; }Overrides:
Gets or sets a value indicating whether mnemonic characters are processed for keyboard navigation. When enabled, users can activate controls using Alt + the mnemonic character defined in the header text.
public bool UseMnemonic { get; set; }Methods
Creates the child items for the group box control and sets up the default layout.
protected override void CreateChildItems(RadElement parent)The parent RadElement to which child items will be added
Overrides:
Creates the main group box element that provides the visual representation and functionality.
protected virtual RadGroupBoxElement CreateGroupBoxElement()A new instance of RadGroupBoxElement
Releases the unmanaged resources used by the RadGroupBox and optionally releases the managed resources.
protected override void Dispose(bool disposing)true to release both managed and unmanaged resources; false to release only unmanaged resources
Overrides:
Handles the control added event and sets up auto-sizing behavior for the new control.
protected override void OnControlAdded(ControlEventArgs e)The ControlEventArgs containing the added control
Overrides:
Handles the control removed event and cleans up auto-sizing behavior for the removed control.
protected override void OnControlRemoved(ControlEventArgs e)The ControlEventArgs containing the removed control
Overrides:
Handles the mouse wheel event and invalidates the control to ensure proper visual updates.
protected override void OnMouseWheel(MouseEventArgs e)The MouseEventArgs containing mouse wheel event data
Overrides:
Handles the scroll event and invalidates the control to ensure proper visual updates.
protected override void OnScroll(ScrollEventArgs se)The ScrollEventArgs containing scroll event data
Overrides:
Processes changes to the AutoSize property and manages event subscriptions accordingly.
protected override void ProcessAutoSizeChanged(bool value)The new AutoSize value
Overrides:
Processes mnemonic characters for the group box control. If the specified character matches the header text mnemonic, focuses the next control in the tab order.
Resets theme overrides for the BackColor property and reapplies the default theme values.
protected override void ResetBackColorThemeOverrides()Overrides:
Resets theme overrides for the ForeColor property and reapplies the default theme values to header and footer elements.
protected override void ResetForeColorThemeOverrides()Overrides:
Sets theme overrides for the BackColor property across all visual states of the group box elements.
protected override void SetBackColorThemeOverrides()Overrides:
Sets theme overrides for the ForeColor property across the group box header and footer elements.
protected override void SetForeColorThemeOverrides()Overrides: