Class
RootRadElement

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.

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

cs-api-definition
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

RootRadElement()

Declaration

cs-api-definition
public RootRadElement()

Fields

ApplyShapeToControlProperty

Declaration

cs-api-definition
public static RadProperty ApplyShapeToControlProperty

Field Value

RadProperty

AutoSizeChangedEvent

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

Declaration

cs-api-definition
public static readonly RoutedEvent AutoSizeChangedEvent

Field Value

RoutedEvent

ControlBoundsProperty

Declaration

cs-api-definition
public static RadProperty ControlBoundsProperty

Field Value

RadProperty

ControlDefaultSizeProperty

Declaration

cs-api-definition
public static RadProperty ControlDefaultSizeProperty

Field Value

RadProperty

OnRoutedImageListChanged

Declaration

cs-api-definition
public static readonly RoutedEvent OnRoutedImageListChanged

Field Value

RoutedEvent

RootLayoutResumedEvent

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

Declaration

cs-api-definition
public static RoutedEvent RootLayoutResumedEvent

Field Value

RoutedEvent

RootLayoutSuspendedEvent

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

Declaration

cs-api-definition
public static RoutedEvent RootLayoutSuspendedEvent

Field Value

RoutedEvent

StretchChangedEvent

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

Declaration

cs-api-definition
public static readonly RoutedEvent StretchChangedEvent

Field Value

RoutedEvent

UsePaintCacheProperty

Declaration

cs-api-definition
public static RadProperty UsePaintCacheProperty

Field Value

RadProperty

Properties

Alignment

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

Declaration

cs-api-definition
[Browsable(false)]
public override ContentAlignment Alignment { get; set; }

Property Value

ContentAlignment

Overrides RadElement.Alignment

AngleTransform

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

Declaration

cs-api-definition
[Browsable(false)]
public override float AngleTransform { get; set; }

Property Value

float

Overrides RadElement.AngleTransform

ApplyShapeToControl

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.

Declaration

cs-api-definition
public bool ApplyShapeToControl { get; set; }

Property Value

bool

AutoSizeMode

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

Declaration

cs-api-definition
public override RadAutoSizeMode AutoSizeMode { get; set; }

Property Value

RadAutoSizeMode

Overrides RadElement.AutoSizeMode

ControlBounds

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

Declaration

cs-api-definition
public virtual Rectangle ControlBounds { get; set; }

Property Value

Rectangle

ControlDefaultSize

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

Declaration

cs-api-definition
public Size ControlDefaultSize { get; set; }

Property Value

Size

Remarks

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

FlipText

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

Declaration

cs-api-definition
[Browsable(false)]
public override bool FlipText { get; set; }

Property Value

bool

Overrides RadItem.FlipText

ForeColor

Gets or sets the foreground color of the element.

Declaration

cs-api-definition
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color ForeColor { get; set; }

Property Value

Color

Overrides VisualElement.ForeColor

IsElementVisible

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

Declaration

cs-api-definition
public override bool IsElementVisible { get; }

Property Value

bool

Overrides RadElement.IsElementVisible

KeyTip

Gets or sets the key tip text for the element.

Declaration

cs-api-definition
[Browsable(false)]
public override string KeyTip { get; set; }

Property Value

string

Overrides RadItem.KeyTip

Margin

Gets or sets the margin spacing around the element.

Declaration

cs-api-definition
[Browsable(false)]
public override Padding Margin { get; set; }

Property Value

Padding

Overrides RadElement.Margin

MaxSize

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

Declaration

cs-api-definition
public override Size MaxSize { get; set; }

Property Value

Size

Overrides RadElement.MaxSize

Remarks

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

MinSize

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

Declaration

cs-api-definition
public override Size MinSize { get; set; }

Property Value

Size

Overrides RadElement.MinSize

Remarks

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

Padding

This property is not relevant for this class.

Declaration

cs-api-definition
[Browsable(false)]
public override Padding Padding { get; set; }

Property Value

Padding

Overrides RadElement.Padding

RightToLeft

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

Declaration

cs-api-definition
[Browsable(false)]
public override bool RightToLeft { get; set; }

Property Value

bool

Overrides RadElement.RightToLeft

Text

Gets or sets the text associated with this element.

Declaration

cs-api-definition
public override string Text { get; set; }

Property Value

string

Overrides RadItem.Text

Remarks

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

TextOrientation

Gets or sets the orientation of text within the element.

Declaration

cs-api-definition
[Browsable(false)]
public override Orientation TextOrientation { get; set; }

Property Value

Orientation

Overrides RadItem.TextOrientation

ToolTipText

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

Declaration

cs-api-definition
[Browsable(false)]
public override string ToolTipText { get; set; }

Property Value

string

Overrides RadItem.ToolTipText

UseCompatibleTextRendering

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

Declaration

cs-api-definition
[Browsable(false)]
public override bool UseCompatibleTextRendering { get; set; }

Property Value

bool

Overrides RadElement.UseCompatibleTextRendering

UsePaintCache

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

Declaration

cs-api-definition
public bool UsePaintCache { get; set; }

Property Value

bool

Methods

ArrangeCore(RectangleF)

Performs the core arrangement logic for the element within the specified final rectangle.

Declaration

cs-api-definition
protected override void ArrangeCore(RectangleF finalRect)

Parameters

finalRect

RectangleF

The final rectangular area allocated for this element.

Overrides RadElement.ArrangeCore(RectangleF)

ArrangeOverride(SizeF)

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

Declaration

cs-api-definition
protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

finalSize

SizeF

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)

CoerceValue(RadPropertyValue, object)

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

Declaration

cs-api-definition
protected override object CoerceValue(RadPropertyValue propVal, object baseValue)

Parameters

propVal

RadPropertyValue

The property value wrapper containing metadata and the property definition.

baseValue

object

The base value before coercion.

Returns

object

The coerced value.

Overrides RadObject.CoerceValue(RadPropertyValue, object)

DisposeManagedResources()

Releases managed resources used by this element.

Declaration

cs-api-definition
protected override void DisposeManagedResources()

Overrides RadItem.DisposeManagedResources()

DpiScaleChanged(SizeF)

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

Declaration

cs-api-definition
public override void DpiScaleChanged(SizeF scaleFactor)

Parameters

scaleFactor

SizeF

The new DPI scale factor to apply.

Overrides RadElement.DpiScaleChanged(SizeF)

GetArrangeRect(RectangleF)

Gets the arrange rectangle, valid for this element.

Declaration

cs-api-definition
protected override RectangleF GetArrangeRect(RectangleF proposed)

Parameters

proposed

RectangleF

The proposed rectangle.

Returns

RectangleF

The arrange rectangle for this element.

Overrides RadElement.GetArrangeRect(RectangleF)

GetInheritedValue(RadProperty)

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

Declaration

cs-api-definition
protected override object GetInheritedValue(RadProperty property)

Parameters

property

RadProperty

The property to get the inherited value for.

Returns

object

The inherited property value.

Overrides RadObject.GetInheritedValue(RadProperty)

InitializeFields()

Initializes the fields of this instance with their default values.

Declaration

cs-api-definition
protected override void InitializeFields()

Overrides RadItem.InitializeFields()

MeasureCore(SizeF)

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

Declaration

cs-api-definition
protected override SizeF MeasureCore(SizeF availableSize)

Parameters

availableSize

SizeF

The available size for measuring.

Returns

SizeF

The measured size for the root element.

Overrides RadElement.MeasureCore(SizeF)

MeasureOverride(SizeF)

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

Declaration

cs-api-definition
protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

availableSize

SizeF

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)

OnBoundsChanged(RadPropertyChangedEventArgs)

Declaration

cs-api-definition
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

Overrides RadElement.OnBoundsChanged(RadPropertyChangedEventArgs)

OnControlDefaultSizeChanged(RadPropertyChangedEventArgs)

Declaration

cs-api-definition
protected virtual void OnControlDefaultSizeChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

OnDisplayPropertyChanged(RadPropertyChangedEventArgs)

Declaration

cs-api-definition
protected override void OnDisplayPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

Overrides RadElement.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)

OnDpiScaleFactorChanged()

Raises the DpiScaleFactorChanged event.

Declaration

cs-api-definition
protected virtual void OnDpiScaleFactorChanged()

OnLayoutPropertyChanged(RadPropertyChangedEventArgs)

Called when a layout property has changed.

Declaration

cs-api-definition
protected override void OnLayoutPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

The property changed event arguments.

Overrides RadElement.OnLayoutPropertyChanged(RadPropertyChangedEventArgs)

OnLoaded()

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

Declaration

cs-api-definition
protected override void OnLoaded()

Overrides RadElement.OnLoaded()

OnLocationChanged(RadPropertyChangedEventArgs)

Declaration

cs-api-definition
protected override void OnLocationChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

Overrides RadElement.OnLocationChanged(RadPropertyChangedEventArgs)

OnPropertyChanged(RadPropertyChangedEventArgs)

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

Declaration

cs-api-definition
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

The property changed event arguments.

Overrides RadItem.OnPropertyChanged(RadPropertyChangedEventArgs)

OnPropertyChanging(RadPropertyChangingEventArgs)

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

Declaration

cs-api-definition
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)

Parameters

args

RadPropertyChangingEventArgs

The property changing event arguments.

Overrides RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)

Paint(IGraphics, Rectangle)

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

Declaration

cs-api-definition
public void Paint(IGraphics graphics, Rectangle clipRectangle)

Parameters

graphics

IGraphics

Graphics object to be used to paint elements.

clipRectangle

Rectangle

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

Paint(IGraphics, Rectangle, bool)

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

Declaration

cs-api-definition
public void Paint(IGraphics graphics, Rectangle clipRectangle, bool useRelativeTransformation)

Parameters

graphics

IGraphics

Graphics object to be used to paint elements.

clipRectangle

Rectangle

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

useRelativeTransformation

bool

True to use relative transformation; otherwise, false.

PaintControlShadow()

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

Declaration

cs-api-definition
public void PaintControlShadow()

Parent_Paint(object, PaintEventArgs)

Declaration

cs-api-definition
protected void Parent_Paint(object sender, PaintEventArgs e)

Parameters

sender

object

e

PaintEventArgs

PerformLayoutTransformation(ref RadMatrix)

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

Declaration

cs-api-definition
protected override bool PerformLayoutTransformation(ref RadMatrix matrix)

Parameters

matrix

RadMatrix

The transformation matrix (not used for root element).

Returns

bool

False, indicating no layout transformation is applied.

Overrides RadElement.PerformLayoutTransformation(ref RadMatrix)

ShouldSerializeProperty(PropertyDescriptor)

Determines whether the property defined by the provided property descriptor should be serialized.

Declaration

cs-api-definition
public override bool? ShouldSerializeProperty(PropertyDescriptor property)

Parameters

property

PropertyDescriptor

Returns

bool?

Overrides RadItem.ShouldSerializeProperty(PropertyDescriptor)

Events

DpiScaleFactorChanged

Declaration

cs-api-definition
public event EventHandler DpiScaleFactorChanged

Event Value

EventHandler