New to Telerik UI for WinForms? Start a free 30-day trial

Represents the top-level element in a RadControl's element hierarchy, serving as the root container and coordination point for all child elements within the Telerik Presentation Framework.

RootRadElement serves as the foundational entry point into the TPF element tree, acting as the bridge between the Windows Forms RadControl host and the element-based architecture. Every RadControl has exactly one RootRadElement accessible through the RootElement property.

The root element manages layout coordination with suspension/resumption, property inheritance as the source for cascading properties (fonts, colors, themes), and event routing coordination for both tunneling and bubbling events. It maintains the connection between Windows Forms and TPF systems.

Critical routed events include AutoSizeChangedEvent, StretchChangedEvent, and layout events (RootLayoutSuspendedEvent, RootLayoutResumedEvent) that coordinate behavior across the control hierarchy and enable optimized batch operations.

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

C#
public class RootRadElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRootRadElement...

Derived Classes: FormRootElementPanelRootElementRadBindingNavigator.RadBindingNavigatorRootElementRadCommandBar.RadCommandBarRootElementRadDropDownListRootElementRadLabelRootElementRadMenu.RadMenuRootElementRadScrollbarRootRadElementWebCamRootRadElement...

Implements: IBindableComponentIComponentICustomTypeDescriptorIDisposableINotifyPropertyChangedIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkin...

Inherited Members RadItem.KeyDownEventRadItem.KeyPressEventRadItem.KeyUpEventRadItem.FocusCommandRadItem.ActionCommandRadItem.UseDefaultDisabledPaintPropertyRadItem.TextPropertyRadItem.TextOrientationPropertyRadItem.FlipTextPropertyRadItem.IsAddNewItemPropertyRadItem.ToolTipTextPropertyRadItem.EnableElementShadowPropertyRadItem.ShadowDepthPropertyRadItem.ShadowColorPropertyRadItem.IsPaintingRippleRadItem.EnableRippleAnimationPropertyRadItem.RippleAnimationColorPropertyRadItem.EnableFocusBorderPropertyRadItem.FocusBorderColorPropertyRadItem.FocusBorderWidthPropertyRadItem.EnableFocusBorderAnimationPropertyRadItem.EnableHighlightPropertyRadItem.HighlightColorPropertyRadItem.EnableBorderHighlightPropertyRadItem.BorderHighlightColorPropertyRadItem.BorderHighlightThicknessPropertyRadItem.VisualStatePropertyRadItem.SetOwnerCollection(RadItemOwnerCollection)RadItem.Select()RadItem.OnSelect()RadItem.Deselect()RadItem.OnDeselect()RadItem.DoKeyDown(KeyEventArgs)RadItem.DoKeyPress(KeyPressEventArgs)RadItem.DoKeyUp(KeyEventArgs)RadItem.OnKeyDown(KeyEventArgs)RadItem.OnKeyPress(KeyPressEventArgs)RadItem.OnKeyUp(KeyEventArgs)RadItem.RaiseBubbleEvent(RadElement, RoutedEventArgs)RadItem.OnEnabledChanged(RadPropertyChangedEventArgs)RadItem.OnTextChanging(TextChangingEventArgs)RadItem.OnTextChanged(EventArgs)RadItem.OnTextOrientationChanged(EventArgs)RadItem.OnFlipTextChanged(EventArgs)RadItem.PaintOverride(IGraphics, Rectangle, float, SizeF, bool)RadItem.OnMouseDown(MouseEventArgs)RadItem.OnMouseUp(MouseEventArgs)RadItem.OnMouseMove(MouseEventArgs)RadItem.OnMouseLeave(EventArgs)RadItem.StartRippleAnimation(MouseEventArgs)RadItem.UpdateFocusBorder(bool)RadItem.ContainsText()RadItem.ProcessDialogKey(Keys)RadItem.ProcessCmdKey(ref Message, Keys)RadItem.RaiseKeyDown(KeyEventArgs)RadItem.RaiseKeyPress(KeyPressEventArgs)RadItem.RaiseKeyUp(KeyEventArgs)RadItem.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadItem.CallOnGesture(GestureEventArgs)RadItem.OnGesture(GestureEventArgs)RadItem.OnTwoFingerTapGesture(GestureEventArgs)RadItem.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadItem.OnPanGesture(PanGestureEventArgs)RadItem.OnRotateGesture(RotateGestureEventArgs)RadItem.OnZoomGesture(ZoomGestureEventArgs)RadItem.CanDragCore(Point)RadItem.GetDragContextCore()RadItem.GetDragHintCore()RadItem.ProcessDragDrop(Point, ISupportDrag)RadItem.ProcessDragOver(Point, ISupportDrag)RadItem.ProcessDragEnter(Point, ISupportDrag)RadItem.ProcessDragLeave(Point, ISupportDrag)RadItem.UpdateOnShortcutsChanged()RadItem.CanHandleShortcut(ShortcutEventArgs)RadItem.IsOnActiveForm(Control, bool)RadItem.SetThemeValueOverride(RadProperty, object, string)RadItem.SetThemeValueOverride(RadProperty, object, string, string)RadItem.SetThemeValueOverride(RadProperty, object, string, Type)RadItem.ResetThemeValueOverride(RadProperty)RadItem.ResetThemeValueOverride(RadProperty, string)RadItem.ResetThemeValueOverrides()RadItem.GetAvailableVisualStates()RadItem.ShouldFallbackToDefaultTheme()RadItem.UseDefaultDisabledPaintRadItem.CanHaveOwnStyleRadItem.SelectableRadItem.DefaultAutoToolTipRadItem.ShouldHandleMouseInputRadItem.ParentItemRadItem.ShortcutsHandlerRadItem.EnableElementShadowRadItem.ShadowDepthRadItem.ShadowColorRadItem.EnableRippleAnimationRadItem.RippleAnimationColorRadItem.EnableFocusBorderRadItem.FocusBorderColorRadItem.FocusBorderWidthRadItem.EnableFocusBorderAnimationRadItem.EnableHighlightRadItem.HighlightColorRadItem.EnableBorderHighlightRadItem.BorderHighlightColorRadItem.BorderHighlightThicknessRadItem.MnemonicTextRadItem.ThemeRoleRadItem.VisualStateRadItem.StateManagerRadItem.AllowDragRadItem.AllowDropRadItem.ShortcutsRadItem.AccessibleDescriptionRadItem.AccessibleNameRadItem.AccessibleRoleRadItem.TextChangingRadItem.TextChangedRadItem.TextOrientationChangedRadItem.FlipTextChangedRadItem.QueryAccessibilityHelpRadItem.KeyDownRadItem.KeyPressRadItem.KeyUpRadItem.ZoomGestureRadItem.RotateGestureRadItem.PanGestureRadItem.TwoFingerTapGestureRadItem.PressAndTapGestureRadComponentElement.ToString()RadComponentElement.GetService(Type)RadComponentElement.CanRaiseEventsRadComponentElement.ContainerRadComponentElement.DesignModeRadComponentElement.SiteRadComponentElement.DataBindingsVisualElement.DefaultSizePropertyVisualElement.ForeColorPropertyVisualElement.BackColorPropertyVisualElement.FontPropertyVisualElement.SmoothingModePropertyVisualElement.OpacityPropertyVisualElement.CustomFontPropertyVisualElement.CustomFontSizePropertyVisualElement.CustomFontStylePropertyVisualElement.OnFontChanged(EventArgs)VisualElement.PaintElement(IGraphics, float, SizeF)VisualElement.PaintChildren(IGraphics, Rectangle, float, SizeF, bool)VisualElement.PrePaintElement(IGraphics)VisualElement.PostPaintElement(IGraphics)VisualElement.GetScaledFont(float)VisualElement.GetScaledFont(float, Font)VisualElement.DefaultSizeVisualElement.BackColorVisualElement.FontVisualElement.CustomFontVisualElement.CustomFontSizeVisualElement.CustomFontStyleVisualElement.SmoothingModeVisualElement.OpacityVisualElement.FontChangedRadElement.BoundsPropertyRadElement.BorderThicknessPropertyRadElement.PaddingPropertyRadElement.MarginPropertyRadElement.AlignmentPropertyRadElement.AutoSizeModePropertyRadElement.FitToSizeModePropertyRadElement.MinSizePropertyRadElement.EnabledPropertyRadElement.CanFocusPropertyRadElement.IsItemFocusedPropertyRadElement.IsFocusedPropertyRadElement.IsMouseOverPropertyRadElement.IsMouseOverElementPropertyRadElement.IsMouseDownPropertyRadElement.ShouldPaintPropertyRadElement.VisibilityPropertyRadElement.NamePropertyRadElement.ClassPropertyRadElement.ClipDrawingPropertyRadElement.ShapePropertyRadElement.MouseClickedEventRadElement.MouseDoubleClickedEventRadElement.MouseDownEventRadElement.MouseUpEventRadElement.MouseWheelEventRadElement.ChildElementAddedEventRadElement.ParentChangedEventRadElement.BoundsChangedEventRadElement.VisibilityChangingEventRadElement.EnabledChangedEventRadElement.ControlChangedEventRadElement.BackgroundShapePropertyRadElement.BackgroundShapePaintModePropertyRadElement.ContainsFocusPropertyRadElement.ContainsMousePropertyRadElement.MaxSizePropertyRadElement.RightToLeftPropertyRadElement.AutoSizePropertyRadElement.ZIndexPropertyRadElement.AngleTransformPropertyRadElement.ScaleTransformPropertyRadElement.PositionOffsetPropertyRadElement.TagPropertyRadElement.StretchHorizontallyPropertyRadElement.StretchVerticallyPropertyRadElement.UseCompatibleTextRenderingPropertyRadElement.ClickModePropertyRadElement.styleVersionRadElement.paintSystemSkinRadElement.SetPropertyValueCommandRadElement.GetPropertyValueCommandRadElement.StylePropertyRadElement.CallCreateChildElements()RadElement.SuspendReferenceUpdate()RadElement.ResumeReferenceUpdate()RadElement.CreateChildElements()RadElement.OnLoad(bool)RadElement.LoadCore()RadElement.OnUnload(ComponentThemableElementTree, bool)RadElement.UnloadCore(ComponentThemableElementTree)RadElement.OnUnloaded(ComponentThemableElementTree)RadElement.OnElementTreeChanged(ComponentThemableElementTree)RadElement.OnBeginDispose()RadElement.SetParent(RadElement)RadElement.OnParentChanged(RadElement)RadElement.UpdateReferences(ComponentThemableElementTree, bool, bool)RadElement.ResetLayout(bool)RadElement.HasInvisibleAncestor()RadElement.ResetLayoutCore()RadElement.InvalidateArrange()RadElement.InvalidateArrange(bool)RadElement.InvalidateMeasure()RadElement.InvalidateMeasure(bool)RadElement.UpdateLayout()RadElement.SuspendLayout()RadElement.SuspendLayout(bool)RadElement.ResumeLayout(bool)RadElement.ResumeLayout(bool, bool)RadElement.Arrange(RectangleF)RadElement.Measure(SizeF)RadElement.SetBounds(Rectangle)RadElement.SetBounds(int, int, int, int)RadElement.GetBoundingRectangle(Size)RadElement.GetBoundingRectangle(Rectangle)RadElement.GetDesiredSize(bool)RadElement.PointToScreen(Point)RadElement.PointFromScreen(Point)RadElement.PointToControl(Point)RadElement.PointFromControl(Point)RadElement.LocationToControl()RadElement.RectangleToScreen(Rectangle)RadElement.HitTest(Point)RadElement.OnRenderSizeChanged(SizeChangedInfo)RadElement.OnChildDesiredSizeChanged(RadElement)RadElement.ShouldArrangeChild(RadElement)RadElement.ShouldMeasureChild(RadElement)RadElement.MeasureChildren(SizeF)RadElement.CanExecuteLayoutOperation()RadElement.CalcLayoutOffset(PointF)RadElement.LockBounds()RadElement.UnlockBounds()RadElement.SetBoundsCore(Rectangle)RadElement.IsInValidState(bool)RadElement.Invalidate()RadElement.Invalidate(bool)RadElement.GetInvalidateBounds()RadElement.NotifyInvalidate(RadElement)RadElement.OnTransformationInvalidated()RadElement.PerformPaintTransformation(ref RadMatrix)RadElement.IsInGetAsBitmap()RadElement.PaintElementSkin(IGraphics)RadElement.PaintBackgroundShape(IGraphics)RadElement.PostPaintChildren(IGraphics, Rectangle, float, SizeF)RadElement.PaintChild(RadElement, IGraphics, Rectangle, float, SizeF, bool)RadElement.PaintShadow(RadElement, IGraphics)RadElement.PaintShadowCore(Graphics, Rectangle, RadItem)RadElement.GetShadowRect(ref Rectangle, int)RadElement.PaintFocusCues(IGraphics, Rectangle)RadElement.GetAsBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Rectangle, Brush, float, SizeF)RadElement.GetAsBitmapEx(Color, float, SizeF)RadElement.GetAsBitmapEx(Brush, float, SizeF)RadElement.GetAsBitmap(Brush, float, SizeF)RadElement.IsInVisibleClipBounds(Rectangle)RadElement.SetClipping(Graphics)RadElement.GetClipRect()RadElement.ShouldPaintChild(RadElement)RadElement.GetFocusRect()RadElement.GetCurrentShape()RadElement.GetPaintRectangle(float, float, SizeF)RadElement.GetPatchedRect(RectangleF, float, SizeF)RadElement.GetXPVisualStyle()RadElement.GetVistaVisualStyle()RadElement.InitializeSystemSkinPaint()RadElement.UnitializeSystemSkinPaint()RadElement.GetSystemSkinPaintBounds()RadElement.OnUseSystemSkinChanged(EventArgs)RadElement.ShouldPaintSystemSkin()RadElement.ComposeShouldPaintSystemSkin()RadElement.GetStylablePropertiesFilter()RadElement.ResetStyleSettings(bool)RadElement.ResetStyleSettings(bool, RadProperty)RadElement.ProcessBehaviors(RadPropertyChangedEventArgs)RadElement.AddBehavior(PropertyChangeBehavior)RadElement.GetBehaviors()RadElement.RemoveBehavior(PropertyChangeBehavior)RadElement.ClearBehaviors()RadElement.AddRangeBehavior(PropertyChangeBehaviorCollection)RadElement.SetThemeApplied(bool)RadElement.OnStyleChanged(RadPropertyChangedEventArgs)RadElement.UnapplyStyle()RadElement.RemoveRangeBehaviors(PropertyChangeBehaviorCollection)RadElement.RemoveBehaviors(PropertyChangeBehavior)RadElement.RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)RadElement.GetThemeEffectiveType()RadElement.GetChildrenByType(Type)RadElement.GetChildrenByBaseType(Type)RadElement.FindAncestorByThemeEffectiveType(Type)RadElement.FindAncestor<T>()RadElement.IsAncestorOf(RadElement)RadElement.FindDescendant<T>()RadElement.FindDescendant(Predicate<RadElement>)RadElement.FindDescendant(Type)RadElement.EnumDescendants(TreeTraversalMode)RadElement.EnumDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.EnumDescendants(Filter, TreeTraversalMode)RadElement.GetDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.GetDescendants(Filter, TreeTraversalMode)RadElement.GetAncestors(Filter)RadElement.GetAncestors(Predicate<RadElement>)RadElement.RaiseRoutedEvent(RadElement, RoutedEventArgs)RadElement.RaiseTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)RadElement.IsEventInProcess(RaisedRoutedEvent)RadElement.RegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, string)RadElement.GetRegisterRoutedEvent(string)RadElement.OnChildrenChanged(RadElement, ItemsChangeOperation)RadElement.GetChildren(ChildrenListOptions)RadElement.SendToBack()RadElement.BringToFront()RadElement.IsChildOf(RadElement)RadElement.Focus()RadElement.Focus(bool)RadElement.SetFocusPropertySafe(bool)RadElement.KillFocus()RadElement.OnCLREventsRise(RoutedEventArgs)RadElement.OnMouseHover(EventArgs)RadElement.OnParentEnabledChanged(RadPropertyChangedEventArgs)RadElement.OnLostMouseCapture(MouseEventArgs)RadElement.OnClick(EventArgs)RadElement.OnDoubleClick(EventArgs)RadElement.OnMouseEnter(EventArgs)RadElement.PerformClick()RadElement.OnMouseWheel(MouseEventArgs)RadElement.DoMouseWheel(MouseEventArgs)RadElement.DoClick(EventArgs)RadElement.DoDoubleClick(EventArgs)RadElement.IsInputKey(InputKeyEventArgs)RadElement.MouseEventArgsFromControl(MouseEventArgs)RadElement.DoMouseDown(MouseEventArgs)RadElement.DoMouseUp(MouseEventArgs)RadElement.DoMouseMove(MouseEventArgs)RadElement.ShowScreenTip(ScreenTipNeededEventArgs)RadElement.HideScreenTip()RadElement.DoMouseHover(EventArgs)RadElement.OnShowScreenTip(ComponentInputBehavior)RadElement.RaiseClick(EventArgs)RadElement.RaiseDoubleClick(EventArgs)RadElement.RaiseMouseWheel(MouseEventArgs)RadElement.UpdateContainsFocus(bool)RadElement.DoMouseEnter(EventArgs)RadElement.DoMouseLeave(EventArgs)RadElement.GetValue(RadProperty)RadElement.AddStylePropertySetting(IPropertySetting)RadElement.SetValueCore(RadPropertyValue, object, object, ValueSource)RadElement.NotifyChildren(RadPropertyChangedEventArgs)RadElement.CanRaisePropertyChangeNotifications(RadPropertyValue)RadElement.IsPropertyCancelable(RadPropertyMetadata)RadElement.OnParentPropertyChanged(RadPropertyChangedEventArgs)RadElement.PerformDispose(bool)RadElement.DisposeChildren()RadElement.GetStylableChildrenHierarchy()RadElement.GetStylableChildren()RadElement.GetClientRectangle(SizeF)RadElement.GetBorderThickness(BorderPrimitive)RadElement.ElementStateRadElement.DesiredSizeRadElement.IsLayoutSuspendedRadElement.BoundingRectangleRadElement.ControlBoundingRectangleRadElement.BypassLayoutPoliciesRadElement.IsArrangeValidRadElement.IsMeasureValidRadElement.TreeLevelRadElement.TransformRadElement.TotalTransformRadElement.ShouldPaintUsingParentShapeRadElement.UseSystemSkinRadElement.PropagateStyleToChildrenRadElement.ThemeEffectiveTypeRadElement.ElementTreeRadElement.ChildrenRadElement.ChildrenHierarchyRadElement.ParentRadElement.RoutedEventBehaviorsRadElement.LayoutableChildrenCountRadElement.ContainsFocusRadElement.NotifyParentOnMouseInputRadElement.IsAbleToRespondToMouseEventsRadElement.AutoSizeRadElement.BoundsRadElement.LocationRadElement.SizeRadElement.BorderThicknessRadElement.FitToSizeModeRadElement.EnabledRadElement.CanFocusRadElement.IsFocusedRadElement.IsMouseOverRadElement.IsMouseOverElementRadElement.IsMouseDownRadElement.InvalidateChildrenOnChildChangedRadElement.ShouldPaintRadElement.VisibilityRadElement.NameRadElement.ClassRadElement.ClipDrawingRadElement.ShapeRadElement.ZIndexRadElement.BackgroundShapeRadElement.BackgroundShapePaintModeRadElement.ContainsMouseRadElement.CaptureRadElement.ScaleTransformRadElement.PositionOffsetRadElement.SerializePropertiesRadElement.SerializeElementRadElement.SerializeChildrenRadElement.RenderingMaxFramerateRadElement.IsThemeAppliedRadElement.ShouldApplyThemeRadElement.UseCenteredAngleTransformRadElement.TagRadElement.StretchHorizontallyRadElement.StretchVerticallyRadElement.ClickModeRadElement.DoubleClickEnabledRadElement.CaptureOnMouseDownRadElement.IsItemHoveredRadElement.StyleRadElement.AutoToolTipRadElement.ScreenTipRadElement.AutoNumberKeyTipRadElement.DpiScaleFactorRadElement.LayoutUpdatedRadElement.MouseHoverRadElement.MouseMoveRadElement.MouseDownRadElement.MouseUpRadElement.ClickRadElement.DoubleClickRadElement.MouseEnterRadElement.MouseWheelRadElement.EnabledChangedRadElement.MouseLeaveRadElement.ChildrenChangedRadElement.LostMouseCaptureRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

C#
public RootRadElement()

Fields

Identifies the property that applies the root element's shape as the owning control's window region.

C#
public static RadProperty ApplyShapeToControlProperty

Tunnels when the AutoSize property of RadControl changes in order to notify any children that should take special actions.

C#
public static readonly RoutedEvent AutoSizeChangedEvent

Identifies the property that synchronizes the root element's bounds with its owning control.

C#
public static RadProperty ControlBoundsProperty

Identifies the property that replaces the owning control's default size.

C#
public static RadProperty ControlDefaultSizeProperty

Tunnels a notification that the owning control's image list changed so image primitives can refresh their content.

C#
public static readonly RoutedEvent OnRoutedImageListChanged

Tunnels when the layout has been resumed in order to notify any children that should take special actions in this case - like RadHostItem.

C#
public static RoutedEvent RootLayoutResumedEvent

Tunnels when the layout has been suspended in order to notify any children that should take special actions in this case - like RadHostItem.

C#
public static RoutedEvent RootLayoutSuspendedEvent

Tunnels when some of the stretch properties (horizontal or vertical) has changed in order to notify any children that should take special actions.

C#
public static readonly RoutedEvent StretchChangedEvent

Identifies the root element's paint-cache option exposed by UsePaintCache.

C#
public static RadProperty UsePaintCacheProperty

Properties

Gets or sets the alignment of the element within its container.

C#
[Browsable(false)]
public override ContentAlignment Alignment { get; set; }

Overrides: RadElement.Alignment

Gets or sets the angle of rotation transformation applied to the element.

C#
[Browsable(false)]
public override float AngleTransform { get; set; }

Overrides: RadElement.AngleTransform

Gets or sets value indicating whether the shape set to the root element would be applied as a region to the RadControl that contains the element.

C#
public bool ApplyShapeToControl { get; set; }

Gets or sets the auto size mode for the root element.

C#
public override RadAutoSizeMode AutoSizeMode { get; set; }

Overrides: RadElement.AutoSizeMode

Gets or sets a value corresponding to the bounding rectangle of the owning Control.

C#
public virtual Rectangle ControlBounds { get; set; }

Gets or sets the default size to replace the control's default size when set.

C#
public Size ControlDefaultSize { get; set; }

When set, replaces the default control size. The returned value is scaled according to the current DPI scaling factor.

Gets or sets a value indicating whether text should be flipped.

C#
[Browsable(false)]
public override bool FlipText { get; set; }

Overrides: RadItem.FlipText

Gets or sets the foreground color of the element.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color ForeColor { get; set; }

Overrides: VisualElement.ForeColor

Gets a value indicating whether this element is visible, taking into account both element and control visibility.

C#
public override bool IsElementVisible { get; }

Overrides: RadElement.IsElementVisible

Gets or sets the key tip text for the element.

C#
[Browsable(false)]
public override string KeyTip { get; set; }

Overrides: RadItem.KeyTip

Gets or sets the margin spacing around the element.

C#
[Browsable(false)]
public override Padding Margin { get; set; }

Overrides: RadElement.Margin

Gets or sets the maximum size to apply on an element when layout is calculated.

C#
public override Size MaxSize { get; set; }

Overrides: RadElement.MaxSize

For the root element, this property returns the unscaled maximum size since the control's MaximumSize property handles DPI scaling internally.

Gets or sets the minimum size to apply on an element when layout is calculated.

C#
public override Size MinSize { get; set; }

Overrides: RadElement.MinSize

For the root element, this property returns the unscaled minimum size since the control's MinimumSize property handles DPI scaling internally.

This property is not relevant for this class.

C#
[Browsable(false)]
public override Padding Padding { get; set; }

Overrides: RadElement.Padding

Gets or sets a value indicating whether the element's text and content is rendered right-to-left.

C#
[Browsable(false)]
public override bool RightToLeft { get; set; }

Overrides: RadElement.RightToLeft

Gets or sets the text associated with this element.

C#
public override string Text { get; set; }

Overrides: RadItem.Text

For the root element, this property is not serialized and is not localizable.

Gets or sets the orientation of text within the element.

C#
[Browsable(false)]
public override Orientation TextOrientation { get; set; }

Overrides: RadItem.TextOrientation

Gets or sets the tool tip text displayed when the mouse pointer hovers over the element.

C#
[Browsable(false)]
public override string ToolTipText { get; set; }

Overrides: RadItem.ToolTipText

Gets or sets a value indicating whether to use compatible text rendering engine (GDI+) or not (GDI).

C#
[Browsable(false)]
public override bool UseCompatibleTextRendering { get; set; }

Overrides: RadElement.UseCompatibleTextRendering

Gets or sets a value indicating whether to use paint cache for optimized rendering performance.

C#
public bool UsePaintCache { get; set; }

Methods

Applies the root's sizing constraints to the rectangle allocated by the layout manager.

C#
protected override void ArrangeCore(RectangleF finalRect)
Parameters:finalRectRectangleF

The rectangle allocated to the root by the layout manager.

Overrides: RadElement.ArrangeCore(RectangleF)

Stretch settings and min/max constraints determine the root's final size. When the owning control is auto-sized, its size is updated to match the arranged root unless control-size synchronization is disabled.

Arranges child elements within the final layout size and returns the actual size used.

C#
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters:finalSizeSizeF

The final area within which the root element should arrange its child elements.

Returns:

SizeF

The actual size used during the arrange pass.

Overrides: RadElement.ArrangeOverride(SizeF)

Coerces the value of the specified property, applying validation and default values where appropriate.

C#
protected override object CoerceValue(RadPropertyValue propVal, object baseValue)
Parameters:propValRadPropertyValue

The property value wrapper containing metadata and the property definition.

baseValueobject

The base value before coercion.

Returns:

object

The coerced value.

Overrides: RadObject.CoerceValue(RadPropertyValue, object)

Releases parent-control paint tracking before disposing the root element's base resources.

C#
protected override void DisposeManagedResources()

Overrides: RadItem.DisposeManagedResources()

Called when the DPI scaling changes, updating the scale factor for this element and all children.

C#
public override void DpiScaleChanged(SizeF scaleFactor)
Parameters:scaleFactorSizeF

The new DPI scale factor to apply.

Overrides: RadElement.DpiScaleChanged(SizeF)

Resolves the root's arrange rectangle when the proposed size is not positive in both dimensions.

C#
protected override RectangleF GetArrangeRect(RectangleF proposed)
Parameters:proposedRectangleF

The rectangle proposed by the layout manager.

Returns:

RectangleF

The proposed rectangle when both dimensions are positive; otherwise, the control bounds with any positive-infinite dimensions replaced by the root's desired size.

Overrides: RadElement.GetArrangeRect(RectangleF)

Gets the inherited value for a property from the component tree handler.

C#
protected override object GetInheritedValue(RadProperty property)
Parameters:propertyRadProperty

The property to get the inherited value for.

Returns:

object

The inherited property value.

Overrides: RadObject.GetInheritedValue(RadProperty)

Sets the root to fit the available layout size and disables direct mouse-input handling after base initialization.

C#
protected override void InitializeFields()

Overrides: RadItem.InitializeFields()

Measures the core size of the root element, applying size constraints and stretch behavior.

C#
protected override SizeF MeasureCore(SizeF availableSize)
Parameters:availableSizeSizeF

The available size for measuring.

Returns:

SizeF

The measured size for the root element.

Overrides: RadElement.MeasureCore(SizeF)

Measures the size required for child elements and returns the cumulative size needed.

C#
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters:availableSizeSizeF

The available size that the root element can allocate to child elements.

Returns:

SizeF

The desired size needed by the root element based on its children.

Overrides: RadElement.MeasureOverride(SizeF)

Synchronizes the hosted control's size with the root element when automatic sizing is enabled.

C#
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The root-element bounds change.

Overrides: RadElement.OnBoundsChanged(RadPropertyChangedEventArgs)

Synchronization is skipped while the layout manager is updating.

Applies a new default size to the hosted control when its current size still follows the default.

C#
protected virtual void OnControlDefaultSizeChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The default-size property change.

If the control has a custom size, this method increases its height only when it is below the new default; it does not adjust the width in that case.

Forwards display-affecting property changes to the component-tree handler.

C#
protected override void OnDisplayPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The display-affecting property change.

Overrides: RadElement.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)

The change is forwarded only when the root element is in a valid state.

Raises the DpiScaleFactorChanged event.

C#
protected virtual void OnDpiScaleFactorChanged()

Performs layout immediately for stretch-direction changes when the component tree can handle the request.

C#
protected override void OnLayoutPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The layout-affecting property change.

Overrides: RadElement.OnLayoutPropertyChanged(RadPropertyChangedEventArgs)

Other changes, or stretch changes without a component-tree handler, use the base layout invalidation.

Called when the element is loaded and ready for display operations.

C#
protected override void OnLoaded()

Overrides: RadElement.OnLoaded()

Synchronizes the hosted control's location with the new root-element bounds.

C#
protected override void OnLocationChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The root-element bounds change containing the new location.

Overrides: RadElement.OnLocationChanged(RadPropertyChangedEventArgs)

Synchronization is skipped while the layout manager is updating.

Called when a property value has changed, handling root element specific property change logic.

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The property changed event arguments.

Overrides: RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

Called before a property value is changed, allowing for validation or cancellation.

C#
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)
Parameters:argsRadPropertyChangingEventArgs

The property changing event arguments.

Overrides: RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)

Paints the RootElement and its element tree. Intended for use by RadControl inheritors.

C#
public void Paint(IGraphics graphics, Rectangle clipRectangle, bool useRelativeTransformation)
Parameters:graphicsIGraphics

Graphics object to be used to paint elements.

clipRectangleRectangle

Clipping rectangle to be painted. Only those elements from the tree which intersect with this rectangle will be painted.

useRelativeTransformationbool

True to use relative transformation; otherwise, false.

Paints the RootElement and its element tree. Intended for use by RadControl inheritors.

C#
public void Paint(IGraphics graphics, Rectangle clipRectangle)
Parameters:graphicsIGraphics

Graphics object to be used to paint elements.

clipRectangleRectangle

Clipping rectangle to be painted. Only those elements from the tree which intersect with this rectangle will be painted.

Paints a shadow effect behind the control when the element shadow is enabled.

C#
public void PaintControlShadow()

Paints the root element's shadow onto its parent control while the owning control is visible.

C#
protected void Parent_Paint(object sender, PaintEventArgs e)
Parameters:senderobject

The parent control that raised the paint event.

ePaintEventArgs

The paint context whose graphics surface receives the shadow.

Indicates that no layout transformation is needed for the root element as it represents the control itself.

C#
protected override bool PerformLayoutTransformation(ref RadMatrix matrix)
Parameters:matrixRadMatrix

The transformation matrix (not used for root element).

Returns:

bool

False, indicating no layout transformation is applied.

Overrides: RadElement.PerformLayoutTransformation(ref RadMatrix)

Applies root-specific rules when deciding whether a property should be included in designer serialization.

C#
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters:propertyPropertyDescriptorReturns:

bool?

Overrides: RadItem.ShouldSerializeProperty(PropertyDescriptor)

Stretch settings are serialized only when they differ from the root's recorded defaults. ToolTipText is included only when non-empty; Alignment, AngleTransform, FlipText, Margin, and TextOrientation are included only when they differ from their metadata defaults. Root-managed properties are suppressed, while other properties return null so the designer's default handling can apply.

Events

Occurs after DPI scaling has been applied to the root element and its descendants.

C#
public event EventHandler DpiScaleFactorChanged

This event is not raised when EnableDpiScaling is disabled.