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

Represents the fundamental building block of the Telerik Presentation Framework (TPF), serving as the base class for all visual and logical elements that compose Telerik controls.

RadElement is the cornerstone of the TPF architecture, providing the foundation for all user interface elements in Telerik WinControls. Every Telerik control is built as a hierarchical tree of RadElement objects, with the RootElement at the top and various child elements forming the visual and logical structure.

Elements participate in a comprehensive property system with inheritance, event routing through the tree, layout participation with measure/arrange phases, and integration with themes and styling. The framework supports primitive elements for rendering (text, borders, fills) and layout panels for arranging children.

All RadElement property changes trigger the OnPropertyChanged(RadPropertyChangedEventArgs) method, enabling reactive behavior and coordinated updates throughout the element hierarchy. This forms the foundation for VisualElement (visual properties), RadItem (interaction), and primitive elements.

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

C#
public class RadElement : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode

Inheritance: objectDisposableObjectRadObjectRadElement

Derived Classes: LayoutPanelMentionBoxPickerAlertWindowCaptionElementPivotRowElementRadApplicationMenuContentElementRadApplicationMenuDropDownElementRadCanvasViewportTransparentColorBoxElementRadDropDownMenuElementRadGripElementRadPageViewContentElementStepItemsContainerTextBoxControlCaretBaseVirtualKeyboardLayoutVisualElement...

Implements: ICustomTypeDescriptorIDisposableINotifyPropertyChangedIStylableNodeISupportSystemSkin

Inherited Members RadObject.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.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)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

Creates an element, initializes its state, and invokes the child-element creation hooks.

C#
public RadElement()

The virtual initialization and child-creation hooks run during construction, before the element is attached to an element tree.

Fields

Identifies the property that selects the element's preferred placement within its parent.

C#
public static RadProperty AlignmentProperty

Identifies the AngleTransform property; changes affect measurement and arrangement as well as painting.

C#
public static RadProperty AngleTransformProperty

Identifies the sizing mode used when AutoSize is enabled.

C#
public static RadProperty AutoSizeModeProperty

Identifies whether the element's size is calculated from its content and AutoSizeMode.

C#
public static RadProperty AutoSizeProperty

Identifies whether the background shape is painted before or after the element's other content.

C#
public static RadProperty BackgroundShapePaintModeProperty

Identifies the optional image-backed shape painted in the element's pre-paint or post-paint phase.

C#
public static RadProperty BackgroundShapeProperty

Identifies the border thickness property, which contributes to the element's bounding rectangle and layout.

C#
public static RadProperty BorderThicknessProperty

Tunnels when bounds changed in order to notify any children that should take special actions in this case - like RadHostItem.

C#
public static RoutedEvent BoundsChangedEvent

Identifies the property backing Bounds; changes invalidate layout and measurement.

C#
public static RadProperty BoundsProperty

Identifies whether the element is eligible to receive input focus.

C#
public static RadProperty CanFocusProperty

Routed event key for ChildElementAdded event. Bubbles when element is added

C#
public static RoutedEvent ChildElementAddedEvent

Identifies the visual-class property matched by class-based stylesheet selectors.

C#
public static RadProperty ClassProperty

Identifies when the element raises its click event; the default is Release.

C#
public static RadProperty ClickModeProperty

Identifies whether painting after the element's own paint stage is clipped to its rectangular bounds.

C#
public static RadProperty ClipDrawingProperty

Identifies whether this element or one of its descendants currently has focus.

C#
public static RadProperty ContainsFocusProperty

Identifies whether the pointer is over this element or one of its descendants.

C#
public static RadProperty ContainsMouseProperty

Tunnels when the winforms control has been changed.

C#
public static RoutedEvent ControlChangedEvent

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

C#
public static RoutedEvent EnabledChangedEvent

Identifies the inherited state that determines whether the element responds to user interaction.

C#
public static RadProperty EnabledProperty

Identifies how the element is fitted into the size offered by its parent.

C#
public static RadProperty FitToSizeModeProperty

GetPropertyValueCommand

GetPropertyValueCommand

Reads an object's named property through reflection.

C#
public static readonly GetPropertyValueCommand GetPropertyValueCommand

Identifies the read-only state indicating that the element currently has input focus.

C#
public static RadProperty IsFocusedProperty

Identifies the focus-state property that elements can bind to an owning item's focus state.

C#
public static RadProperty IsItemFocusedProperty

Identifies whether a mouse button is pressed within the element's bounds.

C#
public static RadProperty IsMouseDownProperty

Identifies whether the pointer is within this element's own bounds.

C#
public static RadProperty IsMouseOverElementProperty

Identifies the hover state that can propagate across sibling elements in the same parent item.

C#
public static RadProperty IsMouseOverProperty

Identifies the external spacing property; changes also affect the parent's measurement.

C#
public static RadProperty MarginProperty

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

C#
public static RadProperty MaxSizeProperty

Identifies the lower bound applied to the element's measured size.

C#
public static RadProperty MinSizeProperty

Tunnels and bubbles on MouseClick on current element

C#
public static RoutedEvent MouseClickedEvent

Tunnels and bubbles on MouseDoubleClick on current element

C#
public static RoutedEvent MouseDoubleClickedEvent

Tunnels and bubbles on MouseDown on current element

C#
public static RoutedEvent MouseDownEvent

Tunnels and bubbles on MouseUp on current element

C#
public static RoutedEvent MouseUpEvent

Tunnels and bubbles on MouseWheel on current element

C#
public static RoutedEvent MouseWheelEvent

Identifies the property storing the element name used by theme-builder registrations.

C#
public static RadProperty NameProperty

Identifies the interior padding property; changes invalidate layout and measurement.

C#
public static RadProperty PaddingProperty

Caches the result of ShouldPaintSystemSkin(); null means it has not been evaluated.

C#
protected bool? paintSystemSkin

Routed event key for ParentChanged event. Tunnels when element parent changes

C#
public static RoutedEvent ParentChangedEvent

Identifies the translation applied while painting the element and its children.

C#
public static RadProperty PositionOffsetProperty

Identifies the inheritable flow-direction property, which also affects layout.

C#
public static RadProperty RightToLeftProperty

Identifies the ScaleTransform property, whose neutral scale is SizeF (1, 1). Changes affect measurement and arrangement as well as painting.

C#
public static RadProperty ScaleTransformProperty

SetPropertyValueCommand

SetPropertyValueCommand

Sets an object's named property through reflection without prevalidating type compatibility.

C#
public static readonly SetPropertyValueCommand SetPropertyValueCommand

Identifies the custom geometry used for border painting and hit testing; the root control uses it as its region only when ApplyShapeToControl is enabled.

C#
public static RadProperty ShapeProperty

Identifies whether this element's own visual is painted; child painting is handled separately.

C#
public static readonly RadProperty ShouldPaintProperty

Identifies whether layout may expand the element to use available horizontal space.

C#
public static readonly RadProperty StretchHorizontallyProperty

Identifies whether layout may expand the element to use available vertical space.

C#
public static readonly RadProperty StretchVerticallyProperty

Identifies the stylesheet assigned directly to the element; its settings may also affect children.

C#
public static RadProperty StyleProperty

Stores the theme version whose styles have been applied to this element.

C#
protected int styleVersion

Identifies the property used to store application-defined data on an element.

C#
public static readonly RadProperty TagProperty

Identifies the inheritable nullable text-rendering override; null uses the RadControl default.

C#
public static RadProperty UseCompatibleTextRenderingProperty

Tunnels and bubbles when changes the current element

C#
public static RoutedEvent VisibilityChangingEvent

Identifies the visibility setting that controls whether this element participates in painting and layout.

C#
public static RadProperty VisibilityProperty

Property key of the ZIndex Property.

C#
public static RadProperty ZIndexProperty

Properties

Gets or sets the preferred location of the element if its size is less than its parent size.

C#
public virtual ContentAlignment Alignment { get; set; }

Gets or sets the rotation transform angle used when painting the element and its children.

C#
public virtual float AngleTransform { get; set; }

Gets or sets the numeric key tip assigned when the item has no explicit KeyTip.

C#
protected virtual int AutoNumberKeyTip { get; set; }

Gets or sets a value indicating whether the element size will be calculated automatically by the layout system. Value of false indicates that the element's size will not be changed when calculating the layout.

C#
public virtual bool AutoSize { get; set; }

Gets or sets the way the element should calculate its Size, when the AutoSize property is set to true.

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

Enables the RadItem text fallback when its explicit ToolTipText is empty.

C#
public virtual bool AutoToolTip { get; set; }

Gets or sets the RadImageShape that describes the background of the element.

C#
[Browsable(false)]
[VsbBrowsable(true)]
public RadImageShape BackgroundShape { get; set; }

Gets or sets a value indiicating when to paint the BackgroundShape.

C#
[Browsable(false)]
[VsbBrowsable(true)]
public BackgroundShapePaintMode BackgroundShapePaintMode { get; set; }

Gets or sets the border thickness of the element. This thickness is included into the element's bounding rectangle.

C#
public virtual Padding BorderThickness { get; set; }

Represents the rectangle which surrounds the element bounds after the rotation caused by setting the AngleTransform property to some degree. The rectangle is in parent element's coordinates.

C#
public virtual Rectangle BoundingRectangle { get; }

Gets or sets a value corresponding to the bounding rectangle of the element. Location and/or Size portions of the bounds may be calculated automatically based on the current AutoSize and AutoSizeMode settings.

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

Controls whether the built-in auto-size policies are applied during measurement and arrangement.

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

For auto-sized elements, the measure and arrange overrides receive the available or final size without the usual margin, stretch, min/max, alignment, and layout-transform adjustments. For non-auto-sized elements, measurement still passes the current size to its override but reports an empty desired size, while arrangement uses the current size. Child measurement also omits this element's padding and border adjustments for fit-to-parent modes.

Gets or sets a value indicating whether the element can receive input focus.

C#
public virtual bool CanFocus { get; set; }

Gets a value indicating whether the element can have its own style with style conditions.

C#
[Browsable(false)]
public virtual bool CanHaveOwnStyle { get; }

Gets or sets whether this element is the item captured for mouse input in its element tree.

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

The getter is true only while the control has mouse capture and this element is the captured item. Setting the property requests or releases capture through the component tree.

Determines whether mouse will be captured upon MouseDown event.

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

Gets the collection of elements that are child elements in the element tree.

C#
[Browsable(false)]
public virtual RadElementCollection Children { get; }

Enumerates entire subtree of elements (using depth-first approach), starting from this one as a root.

C#
[Browsable(false)]
public IEnumerable<RadElement> ChildrenHierarchy { get; }

Gets or sets a string value indicating the element visual class name. It's used when a stylesheet has been applied to this element.

C#
[StyleBuilderReadOnly]
public string Class { get; set; }

Style sheets contain groups of property settings categorized by element type and/or class, thus element "class" is used to determine whether certain style rule would be applied over an element. Generally this property is assigned by the control developer but it can be changed design time or runtime if certain element is decided to have different style class.

Specifies when the Click event should fire.

C#
[Bindable(true)]
[SettingsBindable(true)]
public ClickMode ClickMode { get; set; }

Indicates whether the painting of the element and its children should be restricted to its bounds.

C#
public bool ClipDrawing { get; set; }

Determines whether the element or one of its descendants currently contains the keyboard focus.

C#
[Browsable(false)]
public bool ContainsFocus { get; }

Determines whether the element or one of its descendants currently contains the mouse.

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

Represents the rectangle which surrounds the element bounds after the rotation caused by setting the AngleTransform property to some degree. The rectangle is in control coordinates.

C#
public virtual Rectangle ControlBoundingRectangle { get; }

Gets the element desired size.

C#
public SizeF DesiredSize { get; }

Gets or sets a value indicating whether the DoubleClick event will fire for this item.

C#
[Browsable(false)]
public virtual bool DoubleClickEnabled { get; set; }

Gets or sets the DPI scale factor for the element.

C#
public SizeF DpiScaleFactor { get; protected set; }

Gets the current state of the element.

C#
[Browsable(false)]
public ElementState ElementState { get; }

Gets a reference to the tree object, that contains information about the scene where the element is currently visualized.

C#
[Browsable(false)]
public virtual ComponentThemableElementTree ElementTree { get; }

Gets or sets a value indicating whether the element can respond to user interaction.

C#
public virtual bool Enabled { get; set; }

By default, if element is currently selected when Enabled set to false, next element would be selected. Values inherits from Parent.Enabled. When a scrollable control is disabled, the scroll bars are also disabled. For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

Gets or sets a value indicating the way element will fill its available size when parent element is calculating element size and location.

C#
public virtual RadFitToSizeMode FitToSizeMode { get; set; }

Provide for use within TelerikLayoutEngine.

C#
[Browsable(false)]
public virtual bool InvalidateChildrenOnChildChanged { get; set; }

Gets a value indicating whether the element can respond to mouse input and has input focus.

C#
protected bool IsAbleToRespondToMouseEvents { get; }

Indicates whether this element's arrange state has been invalidated since its last arrange pass.

C#
[Browsable(false)]
public bool IsArrangeValid { get; }

The initial-arrange state is tracked separately from this invalidation flag.

Gets a value indicating if the element is visible.

C#
[Browsable(false)]
public virtual bool IsElementVisible { get; }

Gets a value indicating whether the element has input focus.

C#
[Browsable(false)]
public bool IsFocused { get; }

Gets the hover state used by item input handling.

C#
protected virtual bool IsItemHovered { get; }

The base implementation returns IsMouseOver; RadItem uses this state while processing routed input.

Gets a value indicating whether the layout is suspended or not.

C#
public bool IsLayoutSuspended { get; }

Indicates whether this element's measure state has been invalidated since its last measure pass.

C#
[Browsable(false)]
public bool IsMeasureValid { get; }

The initial-measure state is tracked separately from this invalidation flag.

Gets or sets a value indicating whether the mouse button has been pressed when inside the bounds of the element.

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

Gets or sets a value indicating whether the mouse has entered the bounds of the element or any of its sibling elements in the parent RadItem.

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

Gets or sets a value indicating whether the mouse has entered the bounds of the element.

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

Gets a value indicating if theme finished applying

C#
[Browsable(false)]
public bool IsThemeApplied { get; }

Gets the count of all elements, which visibility is not Collapsed.

C#
[Browsable(false)]
public int LayoutableChildrenCount { get; }

Gets or sets the location of the element based on the element parent rectangle. Corresponds to Bounds.Location

C#
[Browsable(true)]
public virtual Point Location { get; set; }

Gets or sets a value corresponding to the margins of the element. Margins are not included into the element's bounding rectangle.

C#
public virtual Padding Margin { get; set; }

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

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

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

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

Represents the element unique name.

C#
[Browsable(false)]
[StyleBuilderReadOnly]
public virtual string Name { get; set; }

Gets or sets a value indicating whether the element should pass the handled mouse event to the first parent element which has the ShouldHandleMouseInput property set to true.

C#
[Browsable(false)]
public virtual bool NotifyParentOnMouseInput { get; set; }

Gets or sets the padding sizes of the element. The paddings are included into the element's bounding rectangle.

C#
public virtual Padding Padding { get; set; }

Gets a reference to the parent element in the visual element tree.

C#
[Browsable(false)]
public RadElement Parent { get; }

Gets or sets the offset of the origin of the coordinate system used when painting the element and its children.

C#
public virtual SizeF PositionOffset { get; set; }

TrnslateTransform of the graphics is used prior to painting the element and after painting element children, to reset the transformation

Defines whether stylesheet rules should be applied for this element and its children, or only for this element

C#
[Browsable(false)]
public virtual bool PropagateStyleToChildren { get; }

Gets or sets a value indicating maximum rendered frames per second.

C#
public static int RenderingMaxFramerate { get; set; }

Gets or sets the direction of flow of the elements and whether elements are aligned to support locales using right-to-left fonts.

C#
public virtual bool RightToLeft { get; set; }

Gets the routed event behaviors collection for this element.

C#
[Browsable(false)]
public RoutedEventBehaviorCollection RoutedEventBehaviors { get; }

Gets or sets a value indicating the scale transform factors, when painting the element and its children.

C#
public virtual SizeF ScaleTransform { get; set; }

Gets or sets the screen-tip content displayed for this element during hover.

C#
[TypeConverter(typeof(RadFilteredPropertiesConverter))]
public virtual RadScreenTipElement ScreenTip { get; set; }

Replacing the screen-tip instance resets the automatically assigned key-tip number.

Gets or sets whether the children of this element should be serialized

C#
[Browsable(true)]
public virtual bool SerializeChildren { get; set; }

Gets or sets whether the element should be serialized in designer

C#
[Browsable(false)]
public virtual bool SerializeElement { get; set; }

Gets or sets whether the properties of this element should be serialized

C#
[Browsable(true)]
public virtual bool SerializeProperties { get; set; }

Gets or sets the custom shape used to paint the element's border and perform hit testing.

C#
[TypeConverter(typeof(ElementShapeConverter))]
public virtual ElementShape Shape { get; set; }

A null value leaves the element rectangular. The shape defines the geometry used by the border and hit-testing paths. The root element applies the shape to the hosted control's region only when ApplyShapeToControl is enabled. Use a predefined shape such as RoundRectShape or EllipseShape, or define a custom path with CustomShape.

Gets a value indicating if a theme should be applied

C#
[Browsable(false)]
public virtual bool ShouldApplyTheme { get; set; }

Specifies whether the Item should handle MouseOver, MouseMove and related mouse events.

C#
[Browsable(false)]
public virtual bool ShouldHandleMouseInput { get; set; }

By default only elements that inherit RadItem can process mouse input.

Gets or sets a value indicating whether the element should be painted.

C#
public virtual bool ShouldPaint { get; set; }

Children visibility is not be affected.

Gets whether GetCurrentShape() should use the parent's shape when this element has none.

C#
protected virtual bool ShouldPaintUsingParentShape { get; }

Gets or sets the size of the element which is the height and width of the visual rectangle that would contain the graphics of the element. Size corresponds to element's Bounds.Size. When the AutoSize property is set to true setting the Size property to some value has no effect.

C#
[Browsable(true)]
public virtual Size Size { get; set; }

Gets or sets whether layout can expand the element to use available horizontal space.

C#
public virtual bool StretchHorizontally { get; set; }

Gets or sets whether layout can expand the element to use available vertical space.

C#
public virtual bool StretchVertically { get; set; }

Gets or sets the stylesheet associated with the element.

C#
[Browsable(false)]
[TypeConverter(typeof(ComponentConverter))]
public StyleSheet Style { get; set; }

Implements: IStylableNode.Style

Stylesheets provide dynamic property settings for elements' RadProperties organized into groups, each regarding a certain state of the element. State means a property has certain value. Style of an element can affect also element children. Generally element style is set through control theme, which is a holder for various styles for many controls.

Gets or sets application-defined data associated with the element.

C#
[Bindable(true)]
[TypeConverter(typeof(StringConverter))]
public object Tag { get; set; }

Gets the type used for theme lookup; by default, this is the element's runtime type.

C#
protected virtual Type ThemeEffectiveType { get; }

Override this property when the element should use another type's theme registrations.

Gets or sets the explicitly assigned tooltip text for this element.

C#
public virtual string ToolTipText { get; set; }

When AutoToolTip is enabled and this value is empty, the base getter returns an empty string. RadItem overrides the getter to use its Text as a fallback.

Gets the cached matrix formed from this element's transform and those of its ancestors.

C#
[Browsable(false)]
[TypeConverter(typeof(ExpandableObjectConverter))]
public RadMatrix TotalTransform { get; }

Gets the cached matrix formed from this element's paint and layout transformations.

C#
[Browsable(false)]
[TypeConverter(typeof(ExpandableObjectConverter))]
public RadMatrix Transform { get; }

Gets the level of this element in the ElementTree it currently resides.

C#
[Browsable(false)]
public byte TreeLevel { get; }

Gets a value indicating whether the AngleTransform should use the center of the object as origin for the transformation.

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

Determines whether to use compatible text rendering engine (GDI+) or not (GDI).

C#
public virtual bool UseCompatibleTextRendering { get; set; }

Gets or sets the mode that describes the usage of system skinning (if available).

C#
public virtual UseSystemSkinMode UseSystemSkin { get; set; }

Implements: ISupportSystemSkin.UseSystemSkin

Gets or sets a value indicating element visibility.

C#
public virtual ElementVisibility Visibility { get; set; }

Setting this property affects also the children of the element. Collapsed means the element and its children would not be painted and would not be calculated in the layout. This property has no effect in design-time on objects.

Gets of sets the order of painting an element compared to its sibling elements. Greater ZIndex means an element would be painted on top of other elements amongst its siblings. ZIndex changes the order of the elements in the list returned by GetChildren(ChildrenListOptions).

C#
public virtual int ZIndex { get; set; }

Methods

Adds a property change behavior to the list of behaviors of the element.

C#
public void AddBehavior(PropertyChangeBehavior behavior)
Parameters:behaviorPropertyChangeBehavior

behavior instance - should not be null (or Nothing in VB.NET)

Behaviors can be used to specify how an element should respond when a certain element property changes. Behaviors are used internally by stylesheets when applying to an hierarchy of elements.

Adds the behaviors in the supplied collection to this element.

C#
public void AddRangeBehavior(PropertyChangeBehaviorCollection behaviors)
Parameters:behaviorsPropertyChangeBehaviorCollection

The behaviors to add.

Unlike AddBehavior(PropertyChangeBehavior), this method does not filter existing entries, so duplicates can be added.

Applies a style setting without an animation end value and associates it with the current style version.

C#
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)
Parameters:settingIPropertySetting

The style setting to apply.

Returns:

ValueUpdateResult

The result of applying the setting, or NotUpdated when it has an end value.

Overrides: RadObject.AddStylePropertySetting(IPropertySetting)

Positions and sizes the element within the specified rectangular area.

C#
public void Arrange(RectangleF finalRect)
Parameters:finalRectRectangleF

The final rectangular area allocated for this element by its parent.

Exceptions: InvalidOperationException

Thrown when finalRect contains infinity or NaN values.

Arrange is a core method in the two-pass layout system (Measure/Arrange). It is called by parent elements to position and size child elements after the Measure pass has determined the desired sizes.

This method handles layout suspension, visibility checks, arranges children through their layout panels, and ensures that layout operations are properly coordinated through the layout manager. It automatically triggers Measure if the element hasn't been measured or if measure data is invalid.

The method validates the finalRect for infinity and NaN values and respects element visibility settings. Collapsed elements skip arrangement but still record their final rectangle for reference.

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

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

The final rectangular area allocated for this element.

Arranges the RadElement to its final location. The element must call the Arrange method of each of its children.

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

The size that is available for element.

Returns:

SizeF

The rectangle occupied by the element. Usually finalSize. Should you return different size, the Layout system will restart measuring and rearranging the items. That could lead to infinite recursion.

In this method call to the Arrange method of each child must be made.

Sends this element at the end of its parent's z-ordered collection.

C#
public void BringToFront()

Calculates the layout offset for the element based on the start point.

C#
protected virtual PointF CalcLayoutOffset(PointF startPoint)
Parameters:startPointPointF

The starting point for the layout calculation.

Returns:

PointF

The calculated layout offset.

Creates the child elements and sets their locally applied values as Default

C#
protected virtual void CallCreateChildElements()

Determines whether the element can perform layout operation.

C#
protected virtual bool CanExecuteLayoutOperation()
Returns:

bool

True if layout operations can be performed, false otherwise.

Determines whether property-change notifications are allowed in the element's current lifecycle state.

C#
protected override bool CanRaisePropertyChangeNotifications(RadPropertyValue propVal)
Parameters:propValRadPropertyValue

The property value being updated.

Returns:

bool

true only when the base object permits notifications and the element is constructed, loaded, or unloaded.

Overrides: RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)

Removes all property-change behaviors registered on this element.

C#
public void ClearBehaviors()

This clears the registrations without invoking BehaviorRemoving(RadElement).

Determines whether the element should use system-skin rendering.

C#
protected virtual bool ComposeShouldPaintSystemSkin()
Returns:

bool

The base implementation always returns false; its former tree traversal is inactive.

Called by the element when constructed. Allows inheritors to build the element tree.

C#
protected virtual void CreateChildElements()

Disposes this element's children in reverse order.

C#
public void DisposeChildren()

A snapshot is used because disposing a child removes it from the live child collection.

Releases element resources and disconnects the element from its parent and element tree.

C#
protected override void DisposeManagedResources()

Overrides: RadObject.DisposeManagedResources()

Clears tracked focus when this is the current focused element and its element tree is present and not already disposing. It also clears behavior and layout registrations and disposes a locally assigned shape before delegating property-store cleanup to the base implementation.

Raises the click event and invalidates the owning control when this element is loaded.

C#
protected virtual void DoClick(EventArgs e)
Parameters:eEventArgs

The click event data.

Forwards the double-click event to OnDoubleClick(EventArgs).

C#
protected virtual void DoDoubleClick(EventArgs e)
Parameters:eEventArgs

The double-click event data.

Called when the mouse button is pressed down over this element.

C#
protected virtual void DoMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event arguments.

Called when the mouse enters this element.

C#
protected virtual void DoMouseEnter(EventArgs e)
Parameters:eEventArgs

The event arguments.

Called when the mouse hovers over this element.

C#
protected virtual void DoMouseHover(EventArgs e)
Parameters:eEventArgs

The event arguments.

Called when the mouse leaves this element.

C#
protected virtual void DoMouseLeave(EventArgs e)
Parameters:eEventArgs

The event arguments.

Called when the mouse is moved over this element.

C#
protected virtual void DoMouseMove(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event arguments.

Called when the mouse button is released over this element.

C#
protected virtual void DoMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event arguments.

Dispatches the routed mouse-wheel event to the element's mouse-wheel handler.

C#
protected virtual void DoMouseWheel(MouseEventArgs e)
Parameters:eMouseEventArgs

The original mouse-wheel event data.

Called when the DPI scale factor changes. Updates the scale factor and notifies child elements.

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

The new DPI scale factor.

Provides flexible routine for traversing all descendants of this instance that match the provided filter.

C#
public IEnumerable<RadElement> EnumDescendants(Filter filter, TreeTraversalMode traverseMode)
Parameters:filterFilter

The filter that defines the match criteria.

traverseModeTreeTraversalMode

The mode used to traverse the subtree.

Returns:

IEnumerable<RadElement>

An enumerable collection of descendant elements matching the filter.

Provides flexible routine for traversing all descendants of this instance that match the provided predicate.

C#
public IEnumerable<RadElement> EnumDescendants(Predicate<RadElement> predicate, TreeTraversalMode traverseMode)
Parameters:predicatePredicate<RadElement>

The filter that defines the match criteria.

traverseModeTreeTraversalMode

The mode used to traverse the subtree.

Returns:

IEnumerable<RadElement>

An enumerable collection of descendant elements matching the predicate.

Provides flexible routine for traversing all descendants of this instance that match the provided predicate.

C#
public IEnumerable<RadElement> EnumDescendants(TreeTraversalMode traverseMode)
Parameters:traverseModeTreeTraversalMode

The mode used to traverse the subtree.

Returns:

IEnumerable<RadElement>

An enumerable collection of descendant elements.

Searches up the parent chain and returns the first parent of type T.

C#
public T FindAncestor<T>() where T : RadElement
Returns:

T

The first parent element of the specified type; otherwise, null.

Searches up the parent chain and returns the first parent with the provided ThemeEffectiveType.

C#
public RadElement FindAncestorByThemeEffectiveType(Type themeEffectiveType)
Parameters:themeEffectiveTypeType

The theme effective type to search for.

Returns:

RadElement

The first parent element with the specified theme effective type; otherwise, null.

Searches down the subtree of elements, using breadth-first approach, and returns the first descendant that matches the provided predicate.

C#
public RadElement FindDescendant(Predicate<RadElement> criteria)
Parameters:criteriaPredicate<RadElement>

The predicate used to filter elements.

Returns:

RadElement

The first descendant element matching the criteria; otherwise, null.

Searches down the subtree of elements, using breadth-first approach, and returns the first descendant of the specified Type.

C#
public RadElement FindDescendant(Type descendantType)
Parameters:descendantTypeType

The type of descendant element to search for.

Returns:

RadElement

The first descendant element of the specified type; otherwise, null.

Searches down the subtree of elements, using breadth-first approach, and returns the first descendant of type T.

C#
public T FindDescendant<T>() where T : RadElement
Returns:

T

The first descendant element of the specified type; otherwise, null.

Attempts to set the keyboard focus to the element.

C#
public virtual bool Focus()
Returns:

bool

True if the keyboard focus is successfully set to the element; otherwise, false.

Attempts to set the keyboard focus to the element, optionally setting parent control focus.

C#
protected bool Focus(bool setParentControlFocus)
Parameters:setParentControlFocusbool

True to also set focus to the parent control; otherwise, false.

Returns:

bool

True if the keyboard focus is successfully set to the element; otherwise, false.

Provides a routine which enumerates all ancestors up in the parent chain of this element, which match the provided Filter.

C#
public IEnumerable<RadElement> GetAncestors(Filter filter)
Parameters:filterFilter

The filter used to match ancestor elements.

Returns:

IEnumerable<RadElement>

An enumerable collection of ancestor elements matching the filter.

Provides a routine which enumerates all ancestors up in the parent chain of this element, which match the provided predicate.

C#
public IEnumerable<RadElement> GetAncestors(Predicate<RadElement> predicate)
Parameters:predicatePredicate<RadElement>

The predicate used to filter parents.

Returns:

IEnumerable<RadElement>

An enumerable collection of ancestor elements matching the predicate.

Gets the arrange rectangle, valid for this element.

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

The proposed rectangle.

Returns:

RectangleF

The arrange rectangle for this element.

Renders this loaded element and its children into an element-sized bitmap with the supplied brush as its background.

C#
public Bitmap GetAsBitmap(Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:backgroundBrushBrush

The brush used to fill the bitmap before painting.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

The rendered bitmap, or null if the element is not loaded or has a nonpositive dimension.

Captures this loaded element using the supplied graphics context and its current element-sized bitmap dimensions.

C#
public Bitmap GetAsBitmap(IGraphics screenRadGraphics, Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:screenRadGraphicsIGraphics

The graphics context used to paint the element tree and supply the pixels copied into the result.

backgroundBrushBrush

Not used by this overload; the supplied graphics context is not filled with this brush.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

A bitmap with the element's dimensions, or null if the element is not loaded or has a nonpositive dimension.

Captures the element using the color-based overload; this overload does not use the supplied brush.

C#
public Bitmap GetAsBitmapEx(Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:backgroundBrushBrush

Ignored; the color-based overload is called with Empty.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

The rendered bitmap, or null if the element is not loaded or has a nonpositive dimension.

Renders this loaded element and its children into an element-sized bitmap with a solid background color.

C#
public virtual Bitmap GetAsBitmapEx(Color backColor, float totalAngle, SizeF totalScale)
Parameters:backColorColor

The color used to clear the bitmap before painting.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

The rendered bitmap, or null if the element is not loaded or has a nonpositive dimension.

Captures this element using the full owning-control rectangle as the clipping area.

C#
public Bitmap GetAsTransformedBitmap(Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:backgroundBrushBrush

The brush used to fill the bitmap background.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

A bitmap containing the clipped element, or null if the element is not loaded or does not intersect the control rectangle.

This overload requires an attached element tree with an owning control, because it reads the control size before checking the element's load state.

Captures this loaded element in the owning control's coordinate system and full control-sized bitmap.

C#
public Bitmap GetAsTransformedBitmap(IGraphics screenRadGraphics, Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:screenRadGraphicsIGraphics

The graphics context used to paint the element tree and supply the pixels copied into the result.

backgroundBrushBrush

Not used by this overload; the supplied graphics context is not filled with this brush.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

A bitmap sized to the owning control, or null if the element is not loaded or the control has a nonpositive dimension.

Captures this element within the intersection of its control bounds and the specified clipping rectangle.

C#
public Bitmap GetAsTransformedBitmap(Rectangle clippingRectangle, Brush backgroundBrush, float totalAngle, SizeF totalScale)
Parameters:clippingRectangleRectangle

The control-coordinate rectangle that limits the captured element area.

backgroundBrushBrush

The brush used to fill the bitmap background.

totalAnglefloat

The rotation passed to the element-tree paint operation.

totalScaleSizeF

The scale passed to the element-tree paint operation.

Returns:

Bitmap

A bitmap for the intersecting area, or null if the element is not loaded or the intersection has a nonpositive dimension.

Gets the property change behaviors collection for this element.

C#
public PropertyChangeBehaviorCollection GetBehaviors()
Returns:

PropertyChangeBehaviorCollection

The collection of property change behaviors.

Converts a border primitive's configured widths into rounded edge thicknesses for layout.

C#
protected Padding GetBorderThickness(BorderPrimitive element)
Parameters:elementBorderPrimitive

The border primitive whose box style and widths determine the result.

Returns:

Padding

The thickness for each edge; an outer-inner border that rounds to one pixel is treated as two pixels.

Gets the rectangle which surrounds the rotated element (if having AngleTransform property set).

C#
public Rectangle GetBoundingRectangle(Rectangle bounds)
Parameters:boundsRectangle

The bounds of the element.

Returns:

Rectangle

A rectangle that bounds the transformed element.

Gets the rectangle which surrounds the rotated element (if having AngleTransform property set).

C#
public Rectangle GetBoundingRectangle(Size size)
Parameters:sizeSize

The size of the element which is accepted as a parameter (for example when returned from GetPreferredSize).

Returns:

Rectangle

A rectangle that bounds the transformed element.

Allows enumerating of this element's children, using the specified options.

C#
public IEnumerable<RadElement> GetChildren(ChildrenListOptions options)
Parameters:optionsChildrenListOptions

The enumeration options to use.

Returns:

IEnumerable<RadElement>

An enumerable collection of child elements based on the specified options.

Gets a list of child elements using the base type to filter the results.

C#
public List<RadElement> GetChildrenByBaseType(Type type)
Parameters:typeType

The base type to filter child elements by.

Returns:

List<RadElement>

A list of child elements derived from the specified base type.

Gets a list of child elements using the type to filter the results.

C#
public List<RadElement> GetChildrenByType(Type type)
Parameters:typeType

The type to filter child elements by.

Returns:

List<RadElement>

A list of child elements of the specified type.

Calculates the content area after subtracting this element's padding and its first border child when it is not collapsed.

C#
protected virtual RectangleF GetClientRectangle(SizeF finalSize)
Parameters:finalSizeSizeF

The arranged size used to calculate the content area.

Returns:

RectangleF

The remaining client area, with nonnegative width and height.

Gets the local rectangle used to clip this element's drawing.

C#
protected virtual RectangleF GetClipRect()
Returns:

RectangleF

The element's bounds.

Gets this element's shape, falling back to its parent's shape when configured to inherit it.

C#
protected ElementShape GetCurrentShape()
Returns:

ElementShape

The element's own shape, its parent's shape when inherited, or null.

Gets a list with all the descendants that match the provided filter.

C#
public List<RadElement> GetDescendants(Filter filter, TreeTraversalMode traverseMode)
Parameters:filterFilter

The filter used to match descendant elements.

traverseModeTreeTraversalMode

The mode used to traverse the subtree.

Returns:

List<RadElement>

A list of descendant elements matching the filter.

Gets a list with all the descendants that match the provided predicate.

C#
public List<RadElement> GetDescendants(Predicate<RadElement> predicate, TreeTraversalMode traverseMode)
Parameters:predicatePredicate<RadElement>

The predicate used to filter descendant elements.

traverseModeTreeTraversalMode

The mode used to traverse the subtree.

Returns:

List<RadElement>

A list of descendant elements matching the predicate.

Gets the desired size of the element, optionally checking if the element is collapsed.

C#
public SizeF GetDesiredSize(bool checkCollapsed)
Parameters:checkCollapsedbool

True to return empty size if the element is collapsed.

Returns:

SizeF

The desired size of the element.

Gets the default focus-cue rectangle inset two pixels from the element's bounding size.

C#
protected virtual Rectangle GetFocusRect()
Returns:

Rectangle

Empty if either dimension is less than four pixels; otherwise, the inset rectangle.

Returns the bounds of the area that should be invalidated when the element is invalidated.

C#
public virtual Rectangle GetInvalidateBounds()
Returns:

Rectangle

The bounds to invalidate.

Creates the element's border-inset paint rectangle and adjusts it for the supplied rotation and scale.

C#
protected RectangleF GetPaintRectangle(float borderWidth, float angle, SizeF scale)
Parameters:borderWidthfloat

The border thickness to exclude from the element's size.

anglefloat

The accumulated rotation angle in degrees.

scaleSizeF

The accumulated paint scale.

Returns:

RectangleF

The border-inset rectangle after the angle- and scale-dependent alignment correction.

Applies the angle- and scale-dependent pixel-alignment correction used by shape primitives.

C#
protected RectangleF GetPatchedRect(RectangleF rect, float angle, SizeF scale)
Parameters:rectRectangleF

The paint rectangle to adjust.

anglefloat

The accumulated rotation angle in degrees.

scaleSizeF

The accumulated paint scale.

Returns:

RectangleF

The adjusted rectangle.

At scales below 2 in both dimensions, non-quarter-turn angles reduce the rectangle by one pixel in each dimension; quarter-turn ranges may shift its origin by one pixel.

Gets a registered routed event by name and class name.

C#
public static RoutedEvent GetRegisterRoutedEvent(string eventName, string className)
Parameters:eventNamestring

The name of the routed event.

classNamestring

The name of the class that owns the routed event.

Returns:

RoutedEvent

The registered routed event if found; otherwise, null.

Gets a registered routed event by name and owner type.

C#
public static RoutedEvent GetRegisterRoutedEvent(string eventName, Type ownerType)
Parameters:eventNamestring

The name of the routed event.

ownerTypeType

The type that owns the routed event.

Returns:

RoutedEvent

The registered routed event if found; otherwise, null.

Gets a registered routed event by name for this element's type.

C#
public RoutedEvent GetRegisterRoutedEvent(string eventName)
Parameters:eventNamestring

The name of the routed event.

Returns:

RoutedEvent

The registered routed event if found; otherwise, null.

Calculates the expanded bounds for a shadow and adjusts the supplied element bounds vertically to center them against that profile.

C#
protected virtual Rectangle GetShadowRect(ref Rectangle elementRect, int shadowDepth)
Parameters:elementRectRectangle

The element bounds; its vertical position is adjusted by this method.

shadowDepthint

The depth whose predefined shadow offsets determine the returned bounds.

Returns:

Rectangle

The expanded rectangle that encloses the shadow profile.

Gets the element's direct children for stylesheet traversal.

C#
protected virtual IEnumerable<RadObject> GetStylableChildren()
Returns:

IEnumerable<RadObject>

The direct children as RadObject instances.

Gets the direct stylable children and their descendants in hierarchy traversal order.

C#
protected virtual IEnumerable<RadObject> GetStylableChildrenHierarchy()
Returns:

IEnumerable<RadObject>

The stylable descendants exposed by each child.

Gets the IFilter instance that may be used to filter the properties, treated as Stylable for this element.

C#
public virtual Filter GetStylablePropertiesFilter()
Returns:

Filter

Gets the rectangle where skin background should be painted. Defaults to BoundingRectangle.

C#
protected virtual Rectangle GetSystemSkinPaintBounds()
Returns:

Rectangle

The rectangle where skin background should be painted.

Gets the type used to match this element against theme registrations and selectors.

C#
public Type GetThemeEffectiveType()
Returns:

Type

Gets the effective value, refreshing style-sourced values when the element tree's style version has changed.

C#
public override object GetValue(RadProperty property)
Parameters:propertyRadProperty

The property whose effective value to retrieve.

Returns:

object

The current value after a stale style value or style-sourced animation has been reset, when applicable.

Overrides: RadObject.GetValue(RadProperty)

Gets the VisualStyleElement instance that describes the skin appearance for the element when the current OS is Windows Vista.

C#
public virtual VisualStyleElement GetVistaVisualStyle()
Returns:

VisualStyleElement

The visual style element for Windows Vista.

Implements: ISupportSystemSkin.GetVistaVisualStyle()

Gets the Visual Style Element instance that describes the skin appearance for the element when the current OS is Windows XP.

C#
public virtual VisualStyleElement GetXPVisualStyle()
Returns:

VisualStyleElement

The visual style element for Windows XP.

Implements: ISupportSystemSkin.GetXPVisualStyle()

Determines whether there is an ancestor in this element tree that is not visible.

C#
public bool HasInvisibleAncestor()
Returns:

bool

True if an invisible ancestor exists, false otherwise.

Hides the currently displayed screen tip.

C#
protected virtual void HideScreenTip()

Performs hit testing on the element to determine if the specified point lies within its bounds.

C#
public virtual bool HitTest(Point point)
Parameters:pointPoint

The point to test in control coordinates.

Returns:

bool

True if the point is within the element bounds, false otherwise.

Initializes member fields to their default values. This method is called prior the CreateChildItems one and allows for initialization of members on which child elements depend.

C#
protected virtual void InitializeFields()

Performs initialization when the element is first-time painted using system skin.

C#
protected virtual void InitializeSystemSkinPaint()

Invalidates the element and schedules it for repainting.

C#
public void Invalidate()

Invalidates the element and schedules it for repainting, optionally checking if layout is suspended.

C#
public void Invalidate(bool checkSuspended)
Parameters:checkSuspendedbool

True to check if layout is suspended before invalidating.

Invalidates the arrangement state of the element, causing it to be re-arranged during the next layout pass.

C#
public void InvalidateArrange()

This overload calls InvalidateArrange(false), invalidating only this element. Use this method when the element's position or arrangement-affecting properties have changed.

Invalidates the arrangement state of the element and optionally its children, causing them to be re-arranged during the next layout pass.

C#
public void InvalidateArrange(bool recursive)
Parameters:recursivebool

True to invalidate this element and all its children; false for this element only.

InvalidateArrange marks the element as needing arrangement and adds it to the layout manager's arrange queue if layout is not currently suspended. This is typically called when properties that affect the element's position or size have changed.

The method respects the element's state and layout suspension. If layout is suspended, the invalidation is recorded but the element won't be queued for arrangement until layout is resumed.

Invalidates the measurement state of the element, causing it to be re-measured during the next layout pass.

C#
public void InvalidateMeasure()

This overload calls InvalidateMeasure(false), invalidating only this element. Use this method when the element's content or measurement-affecting properties have changed.

Invalidates the measurement state of the element and optionally its children, causing them to be re-measured during the next layout pass.

C#
public void InvalidateMeasure(bool recursive)
Parameters:recursivebool

True to invalidate this element and all its children; false for this element only.

InvalidateMeasure marks the element as needing measurement and adds it to the layout manager's measure queue if layout is not currently suspended. This is typically called when properties that affect the element's desired size have changed.

The method respects the element's state and layout suspension. If layout is suspended, the invalidation is recorded but the element won't be queued for measurement until layout is resumed.

Gets a boolean value that determines whether a given element resides in the element hierarchy of this element.

C#
public bool IsAncestorOf(RadElement element)
Parameters:elementRadElement

An instance of the RadElement class which is checked.

Returns:

bool

True if the element is a descendant of this element; otherwise, false.

Get a value indicating whether the element is a direct or indirect child of specified parent element

C#
public bool IsChildOf(RadElement parent)
Parameters:parentRadElement

Parent to test

Returns:

bool

true if the element is child of parent, false otherwise

Determines whether a specific routed event is currently being processed.

C#
public bool IsEventInProcess(RaisedRoutedEvent raisedEvent)
Parameters:raisedEventRaisedRoutedEvent

The routed event to check for processing status.

Returns:

bool

True if the event is currently being processed; otherwise, false.

Determines whether this element or an ancestor is being rendered through a bitmap-capture path.

C#
protected bool IsInGetAsBitmap()
Returns:

bool

true when this element or an ancestor has the bitmap-rendering identity-matrix state set.

Determines whether a key is an input key that should be handled by the element.

C#
protected virtual bool IsInputKey(InputKeyEventArgs e)
Parameters:eInputKeyEventArgs

The input key event arguments.

Returns:

bool

True if the key is an input key; otherwise, false.

Determines whether the element is currently in valid state. That is having a valid ElementTree reference and being in either Constructed or Loaded state.

C#
public bool IsInValidState(bool checkElementTree)
Parameters:checkElementTreebool

True to check if element tree is valid, false otherwise.

Returns:

bool

True if the element is in valid state, false otherwise.

Determines whether this element can intersect the clip rectangle used by the paint pass.

C#
protected virtual bool IsInVisibleClipBounds(Rectangle clipRectangle)
Parameters:clipRectangleRectangle

The invalidated area being painted.

Returns:

bool

true when identity-matrix painting is active or the element's control-space bounds intersect the clip rectangle; otherwise, false.

Determines whether a property change can be canceled according to its element-specific metadata.

C#
protected override bool IsPropertyCancelable(RadPropertyMetadata metadata)
Parameters:metadataRadPropertyMetadata

The metadata associated with the property.

Returns:

bool

The element metadata's Cancelable value, or the base result when the metadata is not element-specific.

Overrides: RadObject.IsPropertyCancelable(RadPropertyMetadata)

Removes keyboard focus from the element.

C#
protected virtual void KillFocus()

Allows inheritors to provide custom load logic.

C#
protected virtual void LoadCore()

Gets the location of this element in control coordinates.

C#
public Point LocationToControl()
Returns:

Point

The location in control coordinates.

Locks the bounds of the element to prevent changes during critical operations.

C#
protected virtual void LockBounds()

Calculates the desired size of the element given the specified available space.

C#
public void Measure(SizeF availableSize)
Parameters:availableSizeSizeF

The available space that can be allocated to this element by its parent.

Exceptions: InvalidOperationException

Thrown when availableSize contains NaN values.

Measure is the first pass of the two-pass layout system (Measure/Arrange). It determines how much space the element would like to occupy based on its content and the constraints provided by its parent.

This method handles layout suspension, validates the availableSize for NaN values, respects element visibility, and coordinates with the layout manager to ensure proper measurement sequencing. The calculated desired size becomes available through the DesiredSize property.

Collapsed elements are given zero desired size but still participate in the measurement process. The method is optimized to avoid redundant measurements when the available size hasn't changed.

Measures children and derives this element's size from their desired sizes when AutoSize is enabled.

C#
protected SizeF MeasureChildren(SizeF availableSize)
Parameters:availableSizeSizeF

The space offered to each child during measurement.

Returns:

SizeF

When auto-sized, the greatest measured child width and height, including applicable parent padding and border thickness. Otherwise, this element's current size after measuring its children.

Auto-sized elements measure only children accepted by ShouldMeasureChild(RadElement). For non-auto-sized elements, every child is measured. Parent padding and border thickness are added for the corresponding fit-to-parent modes unless BypassLayoutPolicies is enabled.

Performs the core measurement logic for the element with the specified available size.

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

The available space that can be allocated to this element.

Returns:

SizeF

The minimum size required by the element to be completely visible.

Measures the space required by the RadElement

Used by the layout system.

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

The size that is available to the RadElement. The available size can be infinity (to take the full size of the element)

Returns:

SizeF

The minimum size required by the element to be completely visible. Cannot be infinity.

In this method call to the Measure method of each child must be made.

Converts mouse event arguments from control coordinates to element coordinates.

C#
protected virtual MouseEventArgs MouseEventArgsFromControl(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event arguments to convert.

Returns:

MouseEventArgs

Mouse event arguments with coordinates relative to this element.

Notifies each direct child that a parent property has changed.

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

The property change forwarded to the children.

C#
protected virtual void NotifyInvalidate(RadElement invalidatedChild)
Parameters:invalidatedChildRadElement

A callback used by the owning RadControl to notify the element for the beginning of a disposing process.

C#
protected virtual void OnBeginDispose()

Called after the element's bounds change and the corresponding layout invalidation is processed.

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

The bounds change, including its old and new values.

Called when the bubble phase of a routed event occurs.

C#
protected virtual void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElement

The element that originally raised the event.

argsRoutedEventArgs

The routed event arguments.

Called when a child's desired size has changed.

C#
protected virtual void OnChildDesiredSizeChanged(RadElement child)
Parameters:childRadElement

The child element whose desired size changed.

Notifies derived elements that the child collection changed and raises ChildrenChanged.

C#
protected virtual void OnChildrenChanged(RadElement child, ItemsChangeOperation changeOperation)
Parameters:childRadElement

The child associated with the operation, when the operation identifies one.

changeOperationItemsChangeOperation

The kind of collection change.

Raises the Click event.

C#
protected virtual void OnClick(EventArgs e)
Parameters:eEventArgs

Raises the element's CLR mouse handlers for routed mouse-down, mouse-up, and mouse-wheel events.

C#
protected virtual void OnCLREventsRise(RoutedEventArgs args)
Parameters:argsRoutedEventArgs

The routed event and its original mouse event data.

Handles display-affecting property changes for this element.

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

The property change that affects the display.

The base implementation invalidates the element when it is loaded.

Raises the DoubleClick event.

C#
protected virtual void OnDoubleClick(EventArgs e)
Parameters:eEventArgs

The element gets notified for a change in its current ElementTree member.

C#
protected virtual void OnElementTreeChanged(ComponentThemableElementTree previousTree)
Parameters:previousTreeComponentThemableElementTree

The previous element tree instance.

Updates pointer, focus, and enabled-descendant state before raising the enabled-changed event.

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

The enabled-property change data.

Called when a layout property has changed.

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

The property changed event arguments.

A callback used by the owning RadControl to notify the element for a first-time screen visualization.

C#
protected void OnLoad(bool recursive)
Parameters:recursivebool

True to notify entire subtree for the load process, false otherwise.

Called when the element has been successfully loaded. That includes loading of all its children as well.

C#
protected virtual void OnLoaded()

Called when a bounds change also changes the element's location.

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

The bounds change, including its old and new values.

The base implementation does not raise a location-changed event or invalidate transformations.

Raises LostMouseCapture when the element loses capture.

C#
protected virtual void OnLostMouseCapture(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse-capture event data.

Captures the element when configured, attempts to focus it, raises its mouse-down event, and records click count state.

C#
protected virtual void OnMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse-down event data.

Raises the element's mouse-enter event.

C#
protected virtual void OnMouseEnter(EventArgs e)
Parameters:eEventArgs

The mouse-enter event data.

Raises the element's mouse-hover event.

C#
protected virtual void OnMouseHover(EventArgs e)
Parameters:eEventArgs

The mouse-hover event data.

Raises the element's mouse-leave event.

C#
protected virtual void OnMouseLeave(EventArgs e)
Parameters:eEventArgs

The mouse-leave event data.

Raises the mouse-move event and, in hover click mode, raises click or double-click while a button is pressed.

C#
protected virtual void OnMouseMove(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse-move event data.

Releases capture when configured and raises the element's mouse-up event.

C#
protected virtual void OnMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse-up event data.

Raises the MouseWheel event.

C#
protected virtual void OnMouseWheel(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event arguments.

Notifies for a change in the Parent value.

C#
protected virtual void OnParentChanged(RadElement previousParent)
Parameters:previousParentRadElement

The previous parent element (if any)

Recalculates this element's enabled state after an ancestor's enabled value changes.

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

The ancestor's enabled-property change data.

The object gets notified for a parent property change.

C#
protected virtual void OnParentPropertyChanged(RadPropertyChangedEventArgs args)
Parameters:argsRadPropertyChangedEventArgs

Applies element-specific effects after the base property-change processing.

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

The property change and its metadata.

Overrides: RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)

Depending on the property, this can notify children, run registered behaviors, invalidate cached values, schedule layout or display updates, and synchronize element state.

Called when the render size of the element has changed.

C#
protected virtual void OnRenderSizeChanged(SizeChangedInfo info)
Parameters:infoSizeChangedInfo

The size change information.

Shows a screen tip.

C#
protected virtual bool OnShowScreenTip(ComponentInputBehavior inputBehavior)
Parameters:inputBehaviorComponentInputBehavior

The input behavior.

Returns:

bool

A value indicating whether a screen tip is shown.

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

This method is executed when a property which affects the absolute position of the element has been changed.

C#
protected virtual void OnTransformationInvalidated()

Called when the tunnel phase of a routed event occurs.

C#
protected virtual void OnTunnelEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElement

The element that originally raised the event.

argsRoutedEventArgs

The routed event arguments.

Unloads the element if it was previously loaded on an element tree.

C#
protected void OnUnload(ComponentThemableElementTree oldTree, bool recursive)
Parameters:oldTreeComponentThemableElementTree

Reference to the element tree from which we are in a process of unload.

recursivebool

True to unload children recursively, false otherwise.

Notifies that the element has been successfully unloaded from an element tree. Allows inheritors to provide custom logic at this stage.

C#
protected virtual void OnUnloaded(ComponentThemableElementTree oldTree)
Parameters:oldTreeComponentThemableElementTree

Reference to the element tree from which the element has been unloaded.

The element gets notified for a change in the UseSystemSkin property. This method will recursively notify all descendants for the change.

C#
protected virtual void OnUseSystemSkinChanged(EventArgs e)
Parameters:eEventArgs

Paints the configured BackgroundShape over the element's bounds, using its DPI scale when enabled.

C#
protected virtual void PaintBackgroundShape(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used to render the shape.

Paints one child after its shadow, allowing subclasses to customize the per-child rendering sequence.

C#
protected virtual void PaintChild(RadElement child, IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale, bool useRelativeTransformation)
Parameters:childRadElement

The child element to paint.

graphicsIGraphics

The graphics context used to paint the element tree.

clipRectangeRectangle

The invalidated area used to cull elements outside the clip.

anglefloat

The accumulated rotation angle of the element and its ancestors.

scaleSizeF

The accumulated scale of the element and its ancestors.

useRelativeTransformationbool

true to apply this element's transform relative to the current graphics transform; otherwise, use its accumulated transform.

Paints eligible children in z-order, painting each child's shadow before the child itself.

C#
protected virtual void PaintChildren(IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale, bool useRelativeTransformation)
Parameters:graphicsIGraphics

The graphics context used to paint the element tree.

clipRectangeRectangle

The invalidated area used to cull elements outside the clip.

anglefloat

The accumulated rotation angle of the element and its ancestors.

scaleSizeF

The accumulated scale of the element and its ancestors.

useRelativeTransformationbool

true to apply this element's transform relative to the current graphics transform; otherwise, use its accumulated transform.

Provides the element's own drawing step between its pre-paint and post-paint hooks; the base implementation draws nothing.

C#
protected virtual void PaintElement(IGraphics graphics, float angle, SizeF scale)
Parameters:graphicsIGraphics

The graphics context used to render the element.

anglefloat

The accumulated rotation angle, in degrees, applied to the element.

scaleSizeF

The accumulated scale applied to the element.

Provides a routine to paint element's content when system skin appearance is desired.

C#
protected virtual void PaintElementSkin(IGraphics graphics)
Parameters:graphicsIGraphics

Draws the standard focus rectangle around this element when its calculated focus bounds are nonempty.

C#
protected virtual void PaintFocusCues(IGraphics graphics, Rectangle clipRectange)
Parameters:graphicsIGraphics

The graphics context used to draw the focus rectangle.

clipRectangeRectangle

The invalidated area being painted.

Virtual layer between PaintChildren() and Paint(). Can be overridden to fully customize element hierarchy paint. Used for painting disabled items.

C#
protected virtual void PaintOverride(IGraphics graphics, Rectangle clipRectangle, float angle, SizeF scale, bool useRelativeTransformation)
Parameters:graphicsIGraphics

The graphics object.

clipRectangleRectangle

The rectangle which has been invalidated.

anglefloat

The angle (in degrees) to which the current element is rotated. This angle is a sum of all AngleTransform properties of this element's parents.

scaleSizeFuseRelativeTransformationbool

Paints a child's shadow when the child is a RadItem with element shadows enabled.

C#
protected virtual void PaintShadow(RadElement child, IGraphics graphics)
Parameters:childRadElement

The child whose shadow should be painted.

graphicsIGraphics

The graphics context used to render the shadow.

Renders the shadow profile configured on a visible item, using its shape or a rounded rectangle when no shape is set.

C#
protected virtual void PaintShadowCore(Graphics graphics, Rectangle bounds, RadItem child)
Parameters:graphicsGraphics

The GDI+ graphics context used to render the shadow.

boundsRectangle

The item's bounds in the graphics coordinate system.

childRadItem

The item that supplies the shadow depth, color, visibility, and optional shape.

Triggers the Click event for the element.

C#
public virtual void PerformClick()

Begins disposal for this element and its descendants, disposes the children, and marks the element disposed.

C#
protected override void PerformDispose(bool disposing)
Parameters:disposingbool

Whether the base disposable-object implementation should release managed resources.

Overrides: DisposableObject.PerformDispose(bool)

Unless disposal has already begun, this method calls OnBeginDispose() on the element and its descendants before disposing children.

Applies this element's layout transformation to an accumulated matrix.

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

The matrix to update; when this element is loaded, an empty matrix is initialized to identity.

Returns:

bool

true if this element adds a layout transformation; otherwise, false.

Applies this element's rotation, scale, and position offset to an accumulated matrix.

C#
protected virtual bool PerformPaintTransformation(ref RadMatrix matrix)
Parameters:matrixRadMatrix

The matrix to update with the paint transformations.

Returns:

bool

true if a paint transformation is applied; otherwise, false.

A scale is applied only when both factors are positive. Under right-to-left layout, the horizontal position offset is reversed.

Retrieves a point in control coordinates taking as a parameter a point which is in element coordinates. The method takes into consideration the AngleTransform property applied on the element and rotates back the transformation. This means that the top left corner of the element is with coordinates (0, 0) no matter what is AngleTransform value.

C#
public Point PointFromControl(Point point)
Parameters:pointPoint

The point in control coordinates to convert.

Returns:

Point

The point in element coordinates.

Retrieves a point in control coordinates taking as a parameter a point which is in screen coordinates.

C#
public Point PointFromScreen(Point point)
Parameters:pointPoint

The point in screen coordinates to convert.

Returns:

Point

The point in element coordinates.

Retrieves a point in control coordinates taking as a parameter a point which is in element coordinates. The method does not take into consideration the AngleTransform property applied on the element.

C#
public Point PointToControl(Point point)
Parameters:pointPoint

The point in element coordinates to convert.

Returns:

Point

The point in control coordinates.

Retrieves a point in screen coordinates taking as a parameter a point which is in element coordinates (this means that the top left corner of the element is with coordinates 0, 0).

C#
public Point PointToScreen(Point point)
Parameters:pointPoint

The point in element coordinates to convert.

Returns:

Point

The point in screen coordinates.

Runs after child painting; the default implementation draws focus cues when this element is focused and cues are enabled.

C#
protected virtual void PostPaintChildren(IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale)
Parameters:graphicsIGraphics

The graphics context used to paint the element tree.

clipRectangeRectangle

The invalidated area being painted.

anglefloat

The accumulated rotation angle of the element and its ancestors.

scaleSizeF

The accumulated scale of the element and its ancestors.

Runs after PaintElement(IGraphics, float, SizeF); the base implementation paints the background shape in post-paint mode.

C#
protected virtual void PostPaintElement(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used to render the element.

Runs before PaintElement(IGraphics, float, SizeF); the base implementation paints the background shape in pre-paint mode.

C#
protected virtual void PrePaintElement(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used to render the element.

Runs registered behaviors whose monitored property matches the property in e.

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

The property change that selects which behaviors to run.

Mouse-down behaviors are skipped in design mode.

Raises the bubble phase of a routed event, traveling up from the target element to the root.

C#
public virtual void RaiseBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElement

The element that originally raised the event.

argsRoutedEventArgs

The routed event arguments.

Raises the routed click event with the supplied original event data.

C#
protected virtual void RaiseClick(EventArgs e)
Parameters:eEventArgs

The original click event data.

Raises the routed double-click event with the supplied original event data.

C#
protected virtual void RaiseDoubleClick(EventArgs e)
Parameters:eEventArgs

The original double-click event data.

Raises the routed mouse-wheel event with the supplied original event data.

C#
protected virtual void RaiseMouseWheel(MouseEventArgs e)
Parameters:eMouseEventArgs

The original mouse-wheel event data.

Raises a routed event on the element, first tunneling down the element tree then bubbling back up.

C#
public virtual void RaiseRoutedEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElement

The element that originally raised the event.

argsRoutedEventArgs

The routed event arguments.

Raises the tunnel phase of a routed event, traveling down from the root to the target element.

C#
public virtual void RaiseTunnelEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElement

The element that originally raised the event.

argsRoutedEventArgs

The routed event arguments.

Retrieves a rectangle in screen coordinates taking as a parameter a rectangle which is in element coordinates (this means that the top left corner of the element is with coordinates 0, 0).

C#
public Rectangle RectangleToScreen(Rectangle rect)
Parameters:rectRectangle

The rectangle in element coordinates to convert.

Returns:

Rectangle

The rectangle in screen coordinates.

Registers a new routed event with the specified name and owner type.

C#
public static RoutedEvent RegisterRoutedEvent(string eventName, Type ownerType)
Parameters:eventNamestring

The name of the routed event.

ownerTypeType

The type that owns the routed event.

Returns:

RoutedEvent

The registered routed event.

Removes one matching property-change behavior from this element.

C#
public void RemoveBehavior(PropertyChangeBehavior behavior)
Parameters:behaviorPropertyChangeBehavior

The behavior to remove.

This removes the registration without invoking BehaviorRemoving(RadElement).

Removes every registration matching the specified property-change behavior.

C#
public virtual void RemoveBehaviors(PropertyChangeBehavior behavior)
Parameters:behaviorPropertyChangeBehavior

The behavior to remove.

This removes registrations without invoking BehaviorRemoving(RadElement).

Removes every registered behavior that matches a behavior in the supplied collection.

C#
public virtual void RemoveRangeBehaviors(PropertyChangeBehaviorCollection propertyChangeBehaviorCollection)
Parameters:propertyChangeBehaviorCollectionPropertyChangeBehaviorCollection

The behaviors to match against this element's registrations.

This removes registrations without invoking BehaviorRemoving(RadElement).

Removes behaviors whose raised-event conditions match entries in the supplied collection.

C#
public virtual void RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection routedEventBehaviorCollection)
Parameters:routedEventBehaviorCollectionRoutedEventBehaviorCollection

The event conditions to match; matching uses IsSameEvent(RaisedRoutedEvent) rather than behavior instance identity.

Add the ElementTree property if we are in the context of RadControlSpy.

C#
protected override PropertyDescriptorCollection ReplaceDefaultDescriptors(PropertyDescriptorCollection props)
Parameters:propsPropertyDescriptorCollectionReturns:

PropertyDescriptorCollection

Overrides: RadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)

Resets all layout related fields and puts the element in its initial layout state.

C#
public void ResetLayout(bool recursive)
Parameters:recursivebool

True to reset children recursively, false otherwise.

Resets the core layout properties and removes this element from layout queues.

C#
protected virtual void ResetLayoutCore()

Resets the Style modifier for the specified property. Will reset all properties if null is passed.

C#
public virtual void ResetStyleSettings(bool recursive, RadProperty property)
Parameters:recursiveboolpropertyRadProperty

Resets the Style modifier of each registered property.

C#
public void ResetStyleSettings(bool recursive)
Parameters:recursivebool

Resumes layout logic for the element and optionally for its children, with an option to force immediate layout.

C#
public virtual void ResumeLayout(bool recursive, bool performLayout)
Parameters:recursivebool

True to resume layout for this element and all its children; false for this element only.

performLayoutbool

True to execute pending layout requests immediately; false to simply resume layout operations.

Layout operations are reference-counted, so each call to SuspendLayout must be matched with a corresponding call to ResumeLayout. When the suspend count reaches zero and the element is loaded, pending layout operations will be executed if performLayout is true. This method is essential for maintaining element tree layout consistency.

Resumes layout logic for the element with an option to force immediate layout.

C#
public void ResumeLayout(bool performLayout)
Parameters:performLayoutbool

True to execute pending layout requests immediately; false to simply resume layout operations.

This overload calls ResumeLayout(false, performLayout), resuming layout for this element only. Use this method after calling SuspendLayout to re-enable layout calculations.

Resumes the previously suspended UpdateReferences(ComponentThemableElementTree, bool, bool) method execution. Each call to SuspendReferenceUpdate() must be paired with a corresponding call to this method.

C#
public void ResumeReferenceUpdate()

Sends this element to the beginning of its parent's z-ordered collection.

C#
public void SendToBack()

Sets the bounds of the element to the specified rectangle (X, Y, width and height).

C#
public void SetBounds(int x, int y, int width, int height)
Parameters:xint

The new X coordinate for the upper-left corner of the element.

yint

The new Y coordinate for the upper-left corner of the element.

widthint

The new width of the element.

heightint

The new height of the element.

Sets the bounds of the element to the specified rectangle (locating and size).

C#
public void SetBounds(Rectangle bounds)
Parameters:boundsRectangle

The rectangle that represents the new location and size.

Sets the bounds of the element to the specified rectangle.

C#
protected virtual void SetBoundsCore(Rectangle bounds)
Parameters:boundsRectangle

The rectangle to set as bounds.

Intersects the graphics clip with the rectangle returned by GetClipRect().

C#
protected virtual void SetClipping(Graphics rawGraphics)
Parameters:rawGraphicsGraphics

The graphics surface being used to paint this element.

Sets the focused state of an element safely without recursion.

C#
protected void SetFocusPropertySafe(bool isFocused)
Parameters:isFocusedbool

The new focused state.

Applies the specified RadElement instance as parent of the current instance.

C#
protected void SetParent(RadElement parent)
Parameters:parentRadElement

The parent element to set.

Used internally to support RadControl infrastructure. This method is not intended for use directly from your code.

C#
protected void SetThemeApplied(bool newValue)
Parameters:newValuebool

Treats local values assigned during construction as default-value overrides before delegating to the base property system.

C#
protected override ValueUpdateResult SetValueCore(RadPropertyValue propVal, object propModifier, object newValue, ValueSource source)
Parameters:propValRadPropertyValue

The property value being updated.

propModifierobject

The modifier associated with the update.

newValueobject

The value being applied.

sourceValueSource

The origin of the value.

Returns:

ValueUpdateResult

The result from the base property update.

Overrides: RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)

Gets a value indicating whether a child will be arranged during the ArrangeOverride(SizeF).

C#
protected virtual bool ShouldArrangeChild(RadElement child)
Parameters:childRadElement

The child element to check.

Returns:

bool

Whether the child will be arranged in ArrangeOverride.

Gets a value indicating, whether a child will be measured during the MeasureOverride.

C#
protected virtual bool ShouldMeasureChild(RadElement child)
Parameters:childRadElement

The child.

Returns:

bool

Whether the child will be measured in MeasureOverride.

Determines whether PaintChildren paints a child.

C#
protected virtual bool ShouldPaintChild(RadElement element)
Parameters:elementRadElement

The child being considered for painting.

Returns:

bool

true to paint the child; otherwise, false.

Determines whether we should paint system skin.

C#
protected virtual bool ShouldPaintSystemSkin()
Returns:

bool

Shows a screen tip for this element.

C#
protected virtual void ShowScreenTip(ScreenTipNeededEventArgs args)
Parameters:argsScreenTipNeededEventArgs

The screen tip event arguments.

Temporarily suspends layout operations upon this element.

C#
public void SuspendLayout()

Temporarily suspends layout operations upon this element.

C#
public virtual void SuspendLayout(bool recursive)
Parameters:recursivebool

True to suspend children also, false otherwise.

Temporarily suspends the UpdateReferences(ComponentThemableElementTree, bool, bool) method execution. This is useful when modifying the element tree structure without triggering immediate reference updates.

C#
public void SuspendReferenceUpdate()

Returns the element's name and type, or its type name when it has no name.

C#
public override string ToString()
Returns:

string

A diagnostic string in the form Name[Type], or just Type when the name is empty.

Overrides: object.ToString()

C#
protected virtual void UnapplyStyle()

Performs cleanup when system skin painting is no longer used.

C#
protected virtual void UnitializeSystemSkinPaint()

Executes the core unload logic. Allows inheritors to perform additional action while the element is unloading itself.

C#
protected virtual void UnloadCore(ComponentThemableElementTree oldTree)
Parameters:oldTreeComponentThemableElementTree

Reference to the element tree from which we are in a process of unload.

Unlocks the bounds of the element after critical operations are complete.

C#
protected virtual void UnlockBounds()

Updates the ContainsFocus property. The notification may be received from a child whose IsFocused property has changed.

C#
protected virtual void UpdateContainsFocus(bool isFocused)
Parameters:isFocusedbool

The current focused state.

Forces the element to update its layout by processing any pending measure and arrange operations.

C#
public void UpdateLayout()

Updates the local references using the provided element tree.

C#
protected virtual void UpdateReferences(ComponentThemableElementTree tree, bool updateInheritance, bool recursive)
Parameters:treeComponentThemableElementTree

The element tree to use for updating references.

updateInheritancebool

True to update inheritance chain, false otherwise.

recursivebool

True to update children also, false otherwise.

Events

Occurs when the children collection of the element is changed.

C#
[Browsable(true)]
public event ChildrenChangedEventHandler ChildrenChanged

Occurs when the element is clicked.

C#
[Browsable(true)]
public event EventHandler Click

Occurs when the element is double-clicked.

C#
[Browsable(true)]
public virtual event EventHandler DoubleClick

Occurs when the enabled state of the element has changed.

C#
public event EventHandler EnabledChanged

Occurs after the associated layout manager completes a layout pass with no remaining layout dirtiness.

C#
[Browsable(false)]
public event EventHandler LayoutUpdated

Handlers are invoked with a null sender and Empty.

Occurs when the element loses mouse capture.

C#
public event MouseEventHandler LostMouseCapture

Occurs when the mouse pointer is over the element and a mouse button is pressed.

C#
[Browsable(true)]
public event MouseEventHandler MouseDown

Occurs when the mouse pointer enters the element.

C#
[Browsable(false)]
public event EventHandler MouseEnter

Occurs when the mouse pointer rests on the element.

C#
[Browsable(false)]
public event EventHandler MouseHover

Occurs when the mouse pointer leaves the element.

C#
[Browsable(false)]
public event EventHandler MouseLeave

Occurs when the mouse pointer is moved over the element.

C#
[Browsable(false)]
public event MouseEventHandler MouseMove

Occurs when the mouse pointer is over the element and a mouse button is released.

C#
[Browsable(false)]
public event MouseEventHandler MouseUp

Occurs when the RadItem has focus and the user scrolls up or down the mouse wheel

C#
[Browsable(true)]
public event MouseEventHandler MouseWheel
In this article
DefinitionConstructorsRadElement()FieldsAlignmentPropertyAngleTransformPropertyAutoSizeModePropertyAutoSizePropertyBackgroundShapePaintModePropertyBackgroundShapePropertyBorderThicknessPropertyBoundsChangedEventBoundsPropertyCanFocusPropertyChildElementAddedEventClassPropertyClickModePropertyClipDrawingPropertyContainsFocusPropertyContainsMousePropertyControlChangedEventEnabledChangedEventEnabledPropertyFitToSizeModePropertyGetPropertyValueCommandIsFocusedPropertyIsItemFocusedPropertyIsMouseDownPropertyIsMouseOverElementPropertyIsMouseOverPropertyMarginPropertyMaxSizePropertyMinSizePropertyMouseClickedEventMouseDoubleClickedEventMouseDownEventMouseUpEventMouseWheelEventNamePropertyPaddingPropertypaintSystemSkinParentChangedEventPositionOffsetPropertyRightToLeftPropertyScaleTransformPropertySetPropertyValueCommandShapePropertyShouldPaintPropertyStretchHorizontallyPropertyStretchVerticallyPropertyStylePropertystyleVersionTagPropertyUseCompatibleTextRenderingPropertyVisibilityChangingEventVisibilityPropertyZIndexPropertyPropertiesAlignmentAngleTransformAutoNumberKeyTipAutoSizeAutoSizeModeAutoToolTipBackgroundShapeBackgroundShapePaintModeBorderThicknessBoundingRectangleBoundsBypassLayoutPoliciesCanFocusCanHaveOwnStyleCaptureCaptureOnMouseDownChildrenChildrenHierarchyClassClickModeClipDrawingContainsFocusContainsMouseControlBoundingRectangleDesiredSizeDoubleClickEnabledDpiScaleFactorElementStateElementTreeEnabledFitToSizeModeInvalidateChildrenOnChildChangedIsAbleToRespondToMouseEventsIsArrangeValidIsElementVisibleIsFocusedIsItemHoveredIsLayoutSuspendedIsMeasureValidIsMouseDownIsMouseOverIsMouseOverElementIsThemeAppliedLayoutableChildrenCountLocationMarginMaxSizeMinSizeNameNotifyParentOnMouseInputPaddingParentPositionOffsetPropagateStyleToChildrenRenderingMaxFramerateRightToLeftRoutedEventBehaviorsScaleTransformScreenTipSerializeChildrenSerializeElementSerializePropertiesShapeShouldApplyThemeShouldHandleMouseInputShouldPaintShouldPaintUsingParentShapeSizeStretchHorizontallyStretchVerticallyStyleTagThemeEffectiveTypeToolTipTextTotalTransformTransformTreeLevelUseCenteredAngleTransformUseCompatibleTextRenderingUseSystemSkinVisibilityZIndexMethodsAddBehavior(PropertyChangeBehavior)AddRangeBehavior(PropertyChangeBehaviorCollection)AddStylePropertySetting(IPropertySetting)Arrange(RectangleF)ArrangeCore(RectangleF)ArrangeOverride(SizeF)BringToFront()CalcLayoutOffset(PointF)CallCreateChildElements()CanExecuteLayoutOperation()CanRaisePropertyChangeNotifications(RadPropertyValue)ClearBehaviors()ComposeShouldPaintSystemSkin()CreateChildElements()DisposeChildren()DisposeManagedResources()DoClick(EventArgs)DoDoubleClick(EventArgs)DoMouseDown(MouseEventArgs)DoMouseEnter(EventArgs)DoMouseHover(EventArgs)DoMouseLeave(EventArgs)DoMouseMove(MouseEventArgs)DoMouseUp(MouseEventArgs)DoMouseWheel(MouseEventArgs)DpiScaleChanged(SizeF)EnumDescendants(Filter, TreeTraversalMode)EnumDescendants(Predicate<RadElement>, TreeTraversalMode)EnumDescendants(TreeTraversalMode)FindAncestor<T>()FindAncestorByThemeEffectiveType(Type)FindDescendant(Predicate<RadElement>)FindDescendant(Type)FindDescendant<T>()Focus()Focus(bool)GetAncestors(Filter)GetAncestors(Predicate<RadElement>)GetArrangeRect(RectangleF)GetAsBitmap(Brush, float, SizeF)GetAsBitmap(IGraphics, Brush, float, SizeF)GetAsBitmapEx(Brush, float, SizeF)GetAsBitmapEx(Color, float, SizeF)GetAsTransformedBitmap(Brush, float, SizeF)GetAsTransformedBitmap(IGraphics, Brush, float, SizeF)GetAsTransformedBitmap(Rectangle, Brush, float, SizeF)GetBehaviors()GetBorderThickness(BorderPrimitive)GetBoundingRectangle(Rectangle)GetBoundingRectangle(Size)GetChildren(ChildrenListOptions)GetChildrenByBaseType(Type)GetChildrenByType(Type)GetClientRectangle(SizeF)GetClipRect()GetCurrentShape()GetDescendants(Filter, TreeTraversalMode)GetDescendants(Predicate<RadElement>, TreeTraversalMode)GetDesiredSize(bool)GetFocusRect()GetInvalidateBounds()GetPaintRectangle(float, float, SizeF)GetPatchedRect(RectangleF, float, SizeF)GetRegisterRoutedEvent(string, string)GetRegisterRoutedEvent(string, Type)GetRegisterRoutedEvent(string)GetShadowRect(ref Rectangle, int)GetStylableChildren()GetStylableChildrenHierarchy()GetStylablePropertiesFilter()GetSystemSkinPaintBounds()GetThemeEffectiveType()GetValue(RadProperty)GetVistaVisualStyle()GetXPVisualStyle()HasInvisibleAncestor()HideScreenTip()HitTest(Point)InitializeFields()InitializeSystemSkinPaint()Invalidate()Invalidate(bool)InvalidateArrange()InvalidateArrange(bool)InvalidateMeasure()InvalidateMeasure(bool)IsAncestorOf(RadElement)IsChildOf(RadElement)IsEventInProcess(RaisedRoutedEvent)IsInGetAsBitmap()IsInputKey(InputKeyEventArgs)IsInValidState(bool)IsInVisibleClipBounds(Rectangle)IsPropertyCancelable(RadPropertyMetadata)KillFocus()LoadCore()LocationToControl()LockBounds()Measure(SizeF)MeasureChildren(SizeF)MeasureCore(SizeF)MeasureOverride(SizeF)MouseEventArgsFromControl(MouseEventArgs)NotifyChildren(RadPropertyChangedEventArgs)NotifyInvalidate(RadElement)OnBeginDispose()OnBoundsChanged(RadPropertyChangedEventArgs)OnBubbleEvent(RadElement, RoutedEventArgs)OnChildDesiredSizeChanged(RadElement)OnChildrenChanged(RadElement, ItemsChangeOperation)OnClick(EventArgs)OnCLREventsRise(RoutedEventArgs)OnDisplayPropertyChanged(RadPropertyChangedEventArgs)OnDoubleClick(EventArgs)OnElementTreeChanged(ComponentThemableElementTree)OnEnabledChanged(RadPropertyChangedEventArgs)OnLayoutPropertyChanged(RadPropertyChangedEventArgs)OnLoad(bool)OnLoaded()OnLocationChanged(RadPropertyChangedEventArgs)OnLostMouseCapture(MouseEventArgs)OnMouseDown(MouseEventArgs)OnMouseEnter(EventArgs)OnMouseHover(EventArgs)OnMouseLeave(EventArgs)OnMouseMove(MouseEventArgs)OnMouseUp(MouseEventArgs)OnMouseWheel(MouseEventArgs)OnParentChanged(RadElement)OnParentEnabledChanged(RadPropertyChangedEventArgs)OnParentPropertyChanged(RadPropertyChangedEventArgs)OnPropertyChanged(RadPropertyChangedEventArgs)OnRenderSizeChanged(SizeChangedInfo)OnShowScreenTip(ComponentInputBehavior)OnStyleChanged(RadPropertyChangedEventArgs)OnTransformationInvalidated()OnTunnelEvent(RadElement, RoutedEventArgs)OnUnload(ComponentThemableElementTree, bool)OnUnloaded(ComponentThemableElementTree)OnUseSystemSkinChanged(EventArgs)PaintBackgroundShape(IGraphics)PaintChild(RadElement, IGraphics, Rectangle, float, SizeF, bool)PaintChildren(IGraphics, Rectangle, float, SizeF, bool)PaintElement(IGraphics, float, SizeF)PaintElementSkin(IGraphics)PaintFocusCues(IGraphics, Rectangle)PaintOverride(IGraphics, Rectangle, float, SizeF, bool)PaintShadow(RadElement, IGraphics)PaintShadowCore(Graphics, Rectangle, RadItem)PerformClick()PerformDispose(bool)PerformLayoutTransformation(ref RadMatrix)PerformPaintTransformation(ref RadMatrix)PointFromControl(Point)PointFromScreen(Point)PointToControl(Point)PointToScreen(Point)PostPaintChildren(IGraphics, Rectangle, float, SizeF)PostPaintElement(IGraphics)PrePaintElement(IGraphics)ProcessBehaviors(RadPropertyChangedEventArgs)RaiseBubbleEvent(RadElement, RoutedEventArgs)RaiseClick(EventArgs)RaiseDoubleClick(EventArgs)RaiseMouseWheel(MouseEventArgs)RaiseRoutedEvent(RadElement, RoutedEventArgs)RaiseTunnelEvent(RadElement, RoutedEventArgs)RectangleToScreen(Rectangle)RegisterRoutedEvent(string, Type)RemoveBehavior(PropertyChangeBehavior)RemoveBehaviors(PropertyChangeBehavior)RemoveRangeBehaviors(PropertyChangeBehaviorCollection)RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)ReplaceDefaultDescriptors(PropertyDescriptorCollection)ResetLayout(bool)ResetLayoutCore()ResetStyleSettings(bool, RadProperty)ResetStyleSettings(bool)ResumeLayout(bool, bool)ResumeLayout(bool)ResumeReferenceUpdate()SendToBack()SetBounds(int, int, int, int)SetBounds(Rectangle)SetBoundsCore(Rectangle)SetClipping(Graphics)SetFocusPropertySafe(bool)SetParent(RadElement)SetThemeApplied(bool)SetValueCore(RadPropertyValue, object, object, ValueSource)ShouldArrangeChild(RadElement)ShouldMeasureChild(RadElement)ShouldPaintChild(RadElement)ShouldPaintSystemSkin()ShowScreenTip(ScreenTipNeededEventArgs)SuspendLayout()SuspendLayout(bool)SuspendReferenceUpdate()ToString()UnapplyStyle()UnitializeSystemSkinPaint()UnloadCore(ComponentThemableElementTree)UnlockBounds()UpdateContainsFocus(bool)UpdateLayout()UpdateReferences(ComponentThemableElementTree, bool, bool)EventsChildrenChangedClickDoubleClickEnabledChangedLayoutUpdatedLostMouseCaptureMouseDownMouseEnterMouseHoverMouseLeaveMouseMoveMouseUpMouseWheel
Not finding the help you need?
Contact Support