Class

RadGroupBox

Initializes a new instance of the RadGroupBox class with default settings. Sets up container control styles and accessibility properties.

Declaration

public RadGroupBox()

Gets the default size of the group box control when no explicit size is specified.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

Gets or sets the image displayed in the footer area of the group box.

Declaration

public Image FooterImage { get; set; }

Property Value

Gets or sets the alignment of the footer image within the footer area.

Declaration

public ContentAlignment FooterImageAlignment { get; set; }

Property Value

Gets or sets the index used to retrieve the footer image from an associated image list.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int FooterImageIndex { get; set; }

Property Value

Gets or sets the key used to retrieve the footer image from an associated image list.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string FooterImageKey { get; set; }

Property Value

Gets or sets the text content displayed in the footer area of the group box.

Declaration

public string FooterText { get; set; }

Property Value

Gets or sets the alignment of the footer text within the footer area.

Declaration

public ContentAlignment FooterTextAlignment { get; set; }

Property Value

Gets or sets the spatial relationship between the footer text and footer image.

Declaration

public TextImageRelation FooterTextImageRelation { get; set; }

Property Value

Gets or sets the visibility state of the footer area in the group box.

Declaration

public ElementVisibility FooterVisibility { get; set; }

Property Value

Gets the RadGroupBoxElement that provides the visual representation and functionality of the group box.

Declaration

[Browsable(false)]
public RadGroupBoxElement GroupBoxElement { get; }

Property Value

Gets or sets the visual style of the group box, determining its overall appearance theme.

Declaration

public RadGroupBoxStyle GroupBoxStyle { get; set; }

Property Value

Gets or sets the alignment of the header within its designated position area.

Declaration

public HeaderAlignment HeaderAlignment { get; set; }

Property Value

Gets or sets the image displayed in the header area of the group box.

Declaration

public Image HeaderImage { get; set; }

Property Value

Gets or sets the alignment of the header image within the header area.

Declaration

public ContentAlignment HeaderImageAlignment { get; set; }

Property Value

Gets or sets the index used to retrieve the header image from an associated image list.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public int HeaderImageIndex { get; set; }

Property Value

Gets or sets the key used to retrieve the header image from an associated image list.

Declaration

[RelatedImageList("ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.1.217.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public string HeaderImageKey { get; set; }

Property Value

Gets or sets the margin around the header area that controls spacing from surrounding elements.

Declaration

public Padding HeaderMargin { get; set; }

Property Value

Gets or sets the position of the header relative to the group box content area.

Declaration

public HeaderPosition HeaderPosition { get; set; }

Property Value

Gets or sets the text content displayed in the header area of the group box.

Declaration

public string HeaderText { get; set; }

Property Value

Gets or sets the alignment of the header text within the header area.

Declaration

public ContentAlignment HeaderTextAlignment { get; set; }

Property Value

Gets or sets the spatial relationship between the header text and header image.

Declaration

public TextImageRelation HeaderTextImageRelation { get; set; }

Property Value

Gets or sets the padding within the group box border that defines the spacing between the border and child controls.

Declaration

public Padding Padding { get; set; }

Property Value

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.

Declaration

public override string Text { get; set; }

Property Value

Overrides RadControl.Text

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.

Declaration

public bool UseMnemonic { get; set; }

Property Value

Creates the child items for the group box control and sets up the default layout.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Creates the main group box element that provides the visual representation and functionality.

Declaration

protected virtual RadGroupBoxElement CreateGroupBoxElement()

Returns

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

Declaration

protected override void Dispose(bool disposing)

Parameters

Overrides RadControl.Dispose(bool)

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

Declaration

protected override void OnControlAdded(ControlEventArgs e)

Parameters

Overrides Control.OnControlAdded(ControlEventArgs)

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

Declaration

protected override void OnControlRemoved(ControlEventArgs e)

Parameters

Overrides Control.OnControlRemoved(ControlEventArgs)

Handles the mouse wheel event and invalidates the control to ensure proper visual updates.

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Overrides RadControl.OnMouseWheel(MouseEventArgs)

Handles the scroll event and invalidates the control to ensure proper visual updates.

Declaration

protected override void OnScroll(ScrollEventArgs se)

Parameters

Overrides ScrollableControl.OnScroll(ScrollEventArgs)

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

Declaration

protected override void ProcessAutoSizeChanged(bool value)

Parameters

Overrides RadControl.ProcessAutoSizeChanged(bool)

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.

Declaration

protected override bool ProcessMnemonic(char charCode)

Parameters

Returns

Overrides RadControl.ProcessMnemonic(char)

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

Declaration

protected override void ResetBackColorThemeOverrides()

Overrides RadControl.ResetBackColorThemeOverrides()

Resets theme overrides for the ForeColor property and reapplies the default theme values to header and footer elements.

Declaration

protected override void ResetForeColorThemeOverrides()

Overrides RadControl.ResetForeColorThemeOverrides()

Sets theme overrides for the BackColor property across all visual states of the group box elements.

Declaration

protected override void SetBackColorThemeOverrides()

Overrides RadControl.SetBackColorThemeOverrides()

Sets theme overrides for the ForeColor property across the group box header and footer elements.

Declaration

protected override void SetForeColorThemeOverrides()

Overrides RadControl.SetForeColorThemeOverrides()