Class RadGroupBoxElement

Represents the main visual element of a group box control that provides header, content area, and optional footer sections. Inherits from LightVisualElement and manages the layout and appearance of group box components.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
UIItemBase
LightVisualElement
RadGroupBoxElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadGroupBoxElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Constructors

RadGroupBoxElement()

Declaration
public RadGroupBoxElement()

Fields

HeaderAlignmentProperty

Identifies the HeaderAlignment dependency property that determines how the header is aligned within its container.

Declaration
public static RadProperty HeaderAlignmentProperty
Field Value
RadProperty

InvalidateMeasureInMainLayoutProperty

Identifies the InvalidateMeasureInMainLayout dependency property used for layout invalidation control.

Declaration
public static RadProperty InvalidateMeasureInMainLayoutProperty
Field Value
RadProperty

Properties

Content

Gets the GroupBoxContent element that provides the main content area for child controls.

Declaration
public GroupBoxContent Content { get; }
Property Value
GroupBoxContent

FooterImage

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

Declaration
public Image FooterImage { get; set; }
Property Value
System.Drawing.Image

FooterImageAlignment

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

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

FooterImageIndex

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

Declaration
public int FooterImageIndex { get; set; }
Property Value
System.Int32

FooterImageKey

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

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

FooterText

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

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

FooterTextAlignment

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

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

FooterTextImageRelation

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

Declaration
public TextImageRelation FooterTextImageRelation { get; set; }
Property Value
System.Windows.Forms.TextImageRelation

FooterVisibile

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

Declaration
public ElementVisibility FooterVisibile { get; set; }
Property Value
ElementVisibility

GroupBoxStyle

Gets or sets the visual style of the group box that determines its overall appearance theme.

Declaration
public RadGroupBoxStyle GroupBoxStyle { get; set; }
Property Value
RadGroupBoxStyle

Header

Gets the GroupBoxHeader element that provides the header functionality and appearance.

Declaration
public GroupBoxHeader Header { get; }
Property Value
GroupBoxHeader

HeaderAlignment

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

Declaration
public HeaderAlignment HeaderAlignment { get; set; }
Property Value
HeaderAlignment

HeaderImage

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

Declaration
public Image HeaderImage { get; set; }
Property Value
System.Drawing.Image

HeaderImageAlignment

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

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

HeaderImageIndex

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

Declaration
public int HeaderImageIndex { get; set; }
Property Value
System.Int32

HeaderImageKey

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

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

HeaderMargin

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

Declaration
public Padding HeaderMargin { get; set; }
Property Value
System.Windows.Forms.Padding

HeaderPosition

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

Declaration
public HeaderPosition HeaderPosition { get; set; }
Property Value
HeaderPosition

HeaderText

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

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

HeaderTextAlignment

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

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

HeaderTextImageRelation

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

Declaration
public TextImageRelation HeaderTextImageRelation { get; set; }
Property Value
System.Windows.Forms.TextImageRelation

InvalidateMeasureInMainLayout

Gets or sets a value used internally for layout invalidation control in the main layout process.

Declaration
public int InvalidateMeasureInMainLayout { get; set; }
Property Value
System.Int32

Methods

ArrangeOverride(SizeF)

Arranges the child elements (header, content, and footer) according to the layout style and available space. Handles positioning based on header position, alignment, and group box style.

Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
System.Drawing.SizeF finalSize

The final size available for the element
Returns
System.Drawing.SizeF

The actual size used by the element after arrangement
Overrides

CreateChildElements()

Creates the child elements including header, content, and footer components for the group box.

Declaration
protected override void CreateChildElements()
Overrides

InitializeFields()

Initializes the fields and sets default values for the RadGroupBoxElement.

Declaration
protected override void InitializeFields()
Overrides

MeasureOverride(SizeF)

Measures the size required by the element and its children based on available space. Calculates the combined size needed for header, content, and footer elements.

Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
System.Drawing.SizeF availableSize

The available size for the element
Returns
System.Drawing.SizeF

The desired size of the element including all child elements
Overrides

Extension Methods