ClassRadGroupBoxElement
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.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadGroupBoxElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadGroupBoxElement
Implements:
Inherited Members
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
InvalidateMeasureInMainLayoutProperty
Identifies the InvalidateMeasureInMainLayout dependency property used for layout invalidation control.
Declaration
[Browsable(false)]
public static RadProperty InvalidateMeasureInMainLayoutProperty
Field Value
Properties
Content
Gets the GroupBoxContent element that provides the main content area for child controls.
Declaration
public GroupBoxContent Content { get; }
Property Value
Footer
Gets the GroupBoxFooter element that provides the footer functionality and appearance.
FooterImage
Gets or sets the image displayed in the footer area of the group box.
FooterImageAlignment
Gets or sets the alignment of the footer image within the footer area.
Declaration
public ContentAlignment FooterImageAlignment { get; set; }
Property Value
FooterImageIndex
Gets or sets the index used to retrieve the footer image from an associated image list.
FooterImageKey
Gets or sets the key used to retrieve the footer image from an associated image list.
FooterText
Gets or sets the text content displayed in the footer area of the group box.
FooterTextAlignment
Gets or sets the alignment of the footer text within the footer area.
Declaration
public ContentAlignment FooterTextAlignment { get; set; }
Property Value
FooterTextImageRelation
Gets or sets the spatial relationship between the footer text and footer image.
Declaration
public TextImageRelation FooterTextImageRelation { get; set; }
Property Value
FooterVisibile
Gets or sets the visibility state of the footer element in the group box.
Declaration
public ElementVisibility FooterVisibile { get; set; }
Property Value
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
Header
Gets the GroupBoxHeader element that provides the header functionality and appearance.
HeaderAlignment
Gets or sets the alignment of the header within its designated position area.
Declaration
public HeaderAlignment HeaderAlignment { get; set; }
Property Value
HeaderImage
Gets or sets the image displayed in the header area of the group box.
HeaderImageAlignment
Gets or sets the alignment of the header image within the header area.
Declaration
public ContentAlignment HeaderImageAlignment { get; set; }
Property Value
HeaderImageIndex
Gets or sets the index used to retrieve the header image from an associated image list.
HeaderImageKey
Gets or sets the key used to retrieve the header image from an associated image list.
HeaderMargin
Gets or sets the margin around the header area that controls spacing from surrounding elements.
HeaderPosition
Gets or sets the position of the header relative to the group box content area.
Declaration
public HeaderPosition HeaderPosition { get; set; }
Property Value
HeaderText
Gets or sets the text content displayed in the header area of the group box.
HeaderTextAlignment
Gets or sets the alignment of the header text within the header area.
Declaration
public ContentAlignment HeaderTextAlignment { get; set; }
Property Value
HeaderTextImageRelation
Gets or sets the spatial relationship between the header text and header image.
Declaration
public TextImageRelation HeaderTextImageRelation { get; set; }
Property Value
InvalidateMeasureInMainLayout
Gets or sets a value used internally for layout invalidation control in the main layout process.
Declaration
[Browsable(false)]
public int InvalidateMeasureInMainLayout { get; set; }
Property Value
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.
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.