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:
public class RootRadElement : RadItem, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNodeInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRootRadElement...
Derived Classes:
Implements:
Inherited Members
Constructors
public RootRadElement()Fields
public static RadProperty ApplyShapeToControlPropertyTunnels when the AutoSize property of RadControl changes in order to notify any children that should take special actions.
public static readonly RoutedEvent AutoSizeChangedEventpublic static RadProperty ControlBoundsPropertypublic static RadProperty ControlDefaultSizePropertypublic static readonly RoutedEvent OnRoutedImageListChangedTunnels when the layout has been resumed in order to notify any children that should take special actions in this case - like RadHostItem.
public static RoutedEvent RootLayoutResumedEventTunnels when the layout has been suspended in order to notify any children that should take special actions in this case - like RadHostItem.
public static RoutedEvent RootLayoutSuspendedEventTunnels when some of the stretch properties (horizontal or vertical) has changed in order to notify any children that should take special actions.
public static readonly RoutedEvent StretchChangedEventpublic static RadProperty UsePaintCachePropertyProperties
Gets or sets the alignment of the element within its container.
[Browsable(false)]
public override ContentAlignment Alignment { get; set; }Overrides:
Gets or sets the angle of rotation transformation applied to the element.
[Browsable(false)]
public override float AngleTransform { get; set; }Overrides:
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.
public bool ApplyShapeToControl { get; set; }Gets or sets the auto size mode for the root element.
public override RadAutoSizeMode AutoSizeMode { get; set; }Overrides:
Gets or sets a value corresponding to the bounding rectangle of the owning Control.
public virtual Rectangle ControlBounds { get; set; }Gets or sets the default size to replace the control's default size when set.
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.
[Browsable(false)]
public override bool FlipText { get; set; }Overrides:
Gets or sets the foreground color of the element.
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color ForeColor { get; set; }Overrides:
Gets a value indicating whether this element is visible, taking into account both element and control visibility.
public override bool IsElementVisible { get; }Overrides:
Gets or sets the key tip text for the element.
[Browsable(false)]
public override string KeyTip { get; set; }Overrides:
Gets or sets the margin spacing around the element.
[Browsable(false)]
public override Padding Margin { get; set; }Overrides:
Gets or sets the maximum size to apply on an element when layout is calculated.
public override Size MaxSize { get; set; }Overrides:
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.
public override Size MinSize { get; set; }Overrides:
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.
[Browsable(false)]
public override Padding Padding { get; set; }Overrides:
Gets or sets a value indicating whether the element's text and content is rendered right-to-left.
[Browsable(false)]
public override bool RightToLeft { get; set; }Overrides:
Gets or sets the text associated with this element.
public override string Text { get; set; }Overrides:
For the root element, this property is not serialized and is not localizable.
Gets or sets the orientation of text within the element.
[Browsable(false)]
public override Orientation TextOrientation { get; set; }Overrides:
Gets or sets the tool tip text displayed when the mouse pointer hovers over the element.
[Browsable(false)]
public override string ToolTipText { get; set; }Overrides:
Gets or sets a value indicating whether to use compatible text rendering engine (GDI+) or not (GDI).
[Browsable(false)]
public override bool UseCompatibleTextRendering { get; set; }Overrides:
Gets or sets a value indicating whether to use paint cache for optimized rendering performance.
public bool UsePaintCache { get; set; }Methods
Performs the core arrangement logic for the element within the specified final rectangle.
protected override void ArrangeCore(RectangleF finalRect)The final rectangular area allocated for this element.
Overrides:
Arranges child elements within the final layout size and returns the actual size used.
Coerces the value of the specified property, applying validation and default values where appropriate.
protected override object CoerceValue(RadPropertyValue propVal, object baseValue)The property value wrapper containing metadata and the property definition.
baseValueobjectThe base value before coercion.
Returns:The coerced value.
Overrides:
Releases managed resources used by this element.
protected override void DisposeManagedResources()Overrides:
Called when the DPI scaling changes, updating the scale factor for this element and all children.
public override void DpiScaleChanged(SizeF scaleFactor)The new DPI scale factor to apply.
Overrides:
Gets the arrange rectangle, valid for this element.
protected override RectangleF GetArrangeRect(RectangleF proposed)The proposed rectangle.
Returns:The arrange rectangle for this element.
Overrides:
Gets the inherited value for a property from the component tree handler.
protected override object GetInheritedValue(RadProperty property)The property to get the inherited value for.
Returns:The inherited property value.
Overrides:
Initializes the fields of this instance with their default values.
protected override void InitializeFields()Overrides:
Measures the size required for child elements and returns the cumulative size needed.
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)Overrides:
protected virtual void OnControlDefaultSizeChanged(RadPropertyChangedEventArgs e)protected override void OnDisplayPropertyChanged(RadPropertyChangedEventArgs e)Overrides:
Raises the DpiScaleFactorChanged event.
protected virtual void OnDpiScaleFactorChanged()Called when a layout property has changed.
protected override void OnLayoutPropertyChanged(RadPropertyChangedEventArgs e)The property changed event arguments.
Overrides:
Called when the element is loaded and ready for display operations.
protected override void OnLoaded()Overrides:
protected override void OnLocationChanged(RadPropertyChangedEventArgs e)Overrides:
Called when a property value has changed, handling root element specific property change logic.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The property changed event arguments.
Overrides:
Called before a property value is changed, allowing for validation or cancellation.
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)The property changing event arguments.
Overrides:
Paints the RootElement and its element tree. Intended for use by RadControl inheritors.
public void Paint(IGraphics graphics, Rectangle clipRectangle, bool useRelativeTransformation)Graphics object to be used to paint elements.
clipRectangleRectangleClipping rectangle to be painted. Only those elements from the tree which intersect with this rectangle will be painted.
useRelativeTransformationboolTrue to use relative transformation; otherwise, false.
Paints the RootElement and its element tree. Intended for use by RadControl inheritors.
Paints a shadow effect behind the control when the element shadow is enabled.
public void PaintControlShadow()protected void Parent_Paint(object sender, PaintEventArgs e)Indicates that no layout transformation is needed for the root element as it represents the control itself.
Determines whether the property defined by the provided property descriptor should be serialized.
public override bool? ShouldSerializeProperty(PropertyDescriptor property)bool?
Overrides:
Events
public event EventHandler DpiScaleFactorChanged