Class RadElement
RadElement class represents the smallest unit in a RadControl that can be painted or that has a layout slot in a RadControl.
Generally each RadCotnrol is composed of a tree of RadElements. The tree has as a root the Root
Inherited Members
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll
Syntax
public class RadElement : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNodeRemarks
Elements nesting also represents the visual nesting. Elements are painted starting
from the root to the leaves of the tree. the leaves are most often primitive
elements like, text, fills, borders and so on. Elements that are descendants of
LayoutPanel are responsible for arranging their children in the available space
and/or for notifying the parent that the layout space is not enough to expand.
Layout behavior of each element can be adjusted using the properties:
Auto
Constructors
RadElement()
Declaration
public RadElement()Fields
AlignmentProperty
AngleTransformProperty
AutoSizeModeProperty
AutoSizeProperty
BackgroundShapePaintModeProperty
BackgroundShapeProperty
BorderThicknessProperty
BoundsChangedEvent
Tunnels when bounds changed in order to notify any children that should take special actions in this case - like RadHostItem.
Declaration
public static RoutedEvent BoundsChangedEventField Value
BoundsProperty
CanFocusProperty
ChildElementAddedEvent
Routed event key for ChildElementAdded event. Bubbles when element is added
Declaration
public static RoutedEvent ChildElementAddedEventField Value
ClassProperty
ClickModeProperty
ClipDrawingProperty
ContainsFocusProperty
ContainsMouseProperty
ControlChangedEvent
Tunnels when the winforms control has been changed.
Declaration
public static RoutedEvent ControlChangedEventField Value
EnabledChangedEvent
Tunnels when the Enabled property changes in order to notify any children that should take special actions.
Declaration
public static RoutedEvent EnabledChangedEventField Value
EnabledProperty
FitToSizeModeProperty
GetPropertyValueCommand
Declaration
public static readonly GetPropertyValueCommand GetPropertyValueCommandField Value
IsEditedInSpyProperty
Used by RadControlSpy to display certain hidden properties in the Property Grid.
Declaration
public static RadProperty IsEditedInSpyPropertyField Value
IsFocusedProperty
IsItemFocusedProperty
IsMouseDownProperty
IsMouseOverElementProperty
IsMouseOverProperty
MarginProperty
MaxSizeProperty
Get or sets the maximum size to apply on an element when layout is calculated.
Declaration
public static RadProperty MaxSizePropertyField Value
MinSizeProperty
MouseClickedEvent
Tunnels and bubbles on MouseClick on current element
Declaration
public static RoutedEvent MouseClickedEventField Value
MouseDoubleClickedEvent
Tunnels and bubbles on MouseDoubleClick on current element
Declaration
public static RoutedEvent MouseDoubleClickedEventField Value
MouseDownEvent
Tunnels and bubbles on MouseDown on current element
Declaration
public static RoutedEvent MouseDownEventField Value
MouseUpEvent
Tunnels and bubbles on MouseUp on current element
Declaration
public static RoutedEvent MouseUpEventField Value
MouseWheelEvent
Tunnels and bubbles on MouseWheel on current element
Declaration
public static RoutedEvent MouseWheelEventField Value
NameProperty
PaddingProperty
paintSystemSkin
Declaration
protected bool? paintSystemSkinField Value
|
System.
|
ParentChangedEvent
Routed event key for ParentChanged event. Tunnels when element parent changes
Declaration
public static RoutedEvent ParentChangedEventField Value
PositionOffsetProperty
RadElementLastStateKey
This constant is used internally.
Declaration
protected const long RadElementLastStateKey = 68719476736LField Value
|
System.
|
RightToLeftProperty
ScaleTransformProperty
SetPropertyValueCommand
Declaration
public static readonly SetPropertyValueCommand SetPropertyValueCommandField Value
ShapeProperty
ShouldPaintProperty
StretchHorizontallyProperty
StretchVerticallyProperty
StyleProperty
styleVersion
Declaration
protected int styleVersionField Value
|
System.
|
TagProperty
TraceInvalidation
This field is used internally.
Declaration
public static bool TraceInvalidationField Value
|
System.
|
UseCompatibleTextRenderingProperty
VisibilityChangingEvent
Tunnels and bubbles when changes the current element
Declaration
public static RoutedEvent VisibilityChangingEventField Value
VisibilityProperty
ZIndexProperty
Property key of the ZIndex Property.
Declaration
public static RadProperty ZIndexPropertyField Value
Properties
Alignment
Gets or sets the preferred location of the element if its size is less than its parent size.
Declaration
[RadPropertyDefaultValue("Alignment", typeof(RadElement))]
public virtual ContentAlignment Alignment { get; set; }Property Value
|
System.
|
AngleTransform
Gets or sets the rotation transform angle used when painting the element and its children.
Declaration
[RadPropertyDefaultValue("AngleTransform", typeof(RadElement))]
public virtual float AngleTransform { get; set; }Property Value
|
System.
|
ArrangeInProgress
This property is used internally!
Declaration
public bool ArrangeInProgress { get; set; }Property Value
|
System.
|
ArrangeIsDirty
This property is used internally!
Declaration
public bool ArrangeIsDirty { get; set; }Property Value
|
System.
|
AutoNumberKeyTip
Declaration
protected virtual int AutoNumberKeyTip { get; set; }Property Value
|
System.
|
AutoSize
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.
Declaration
[RadPropertyDefaultValue("AutoSize", typeof(RadElement))]
public virtual bool AutoSize { get; set; }Property Value
|
System.
|
AutoSizeMode
Gets or sets the way the element should calculate its Size, when
the Auto
Declaration
[RadPropertyDefaultValue("AutoSizeMode", typeof(RadElement))]
public virtual RadAutoSizeMode AutoSizeMode { get; set; }Property Value
AutoToolTip
Declaration
public virtual bool AutoToolTip { get; set; }Property Value
|
System.
|
BackgroundShape
Gets or sets the RadImageShape that describes the background of the element.
Declaration
[VsbBrowsable(true)]
public RadImageShape BackgroundShape { get; set; }Property Value
BackgroundShapePaintMode
Gets or sets a value indiicating when to paint the Background
Declaration
[VsbBrowsable(true)]
public BackgroundShapePaintMode BackgroundShapePaintMode { get; set; }Property Value
BorderThickness
Gets or sets the border thickness of the element. This thickness is included into the element's bounding rectangle.
Declaration
[RadPropertyDefaultValue("BorderThickness", typeof(RadElement))]
public virtual Padding BorderThickness { get; set; }Property Value
|
System.
|
BoundingRectangle
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.
Declaration
public virtual Rectangle BoundingRectangle { get; }Property Value
|
System.
|
Bounds
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 Auto
Declaration
[RadPropertyDefaultValue("Bounds", typeof(RadElement))]
public virtual Rectangle Bounds { get; set; }Property Value
|
System.
|
BypassLayoutPolicies
Declaration
public bool BypassLayoutPolicies { get; set; }Property Value
|
System.
|
CanFocus
Gets or sets a value indicating whether the element can receive input focus.
Declaration
[RadPropertyDefaultValue("CanFocus", typeof(RadElement))]
public virtual bool CanFocus { get; set; }Property Value
|
System.
|
CanHaveOwnStyle
Gets a value indicating whether the element can have its own style with style conditions.
Declaration
public virtual bool CanHaveOwnStyle { get; }Property Value
|
System.
|
Capture
Declaration
public bool Capture { get; set; }Property Value
|
System.
|
CaptureOnMouseDown
Determines whether mouse will be captured upon MouseDown event.
Declaration
public bool CaptureOnMouseDown { get; set; }Property Value
|
System.
|
Children
Gets the collection of elements that are child elements in the element tree.
Declaration
public virtual RadElementCollection Children { get; }Property Value
ChildrenHierarchy
Enumerates entire subtree of elements (using depth-first approach), starting from this one as a root.
Declaration
public IEnumerable<RadElement> ChildrenHierarchy { get; }Property Value
|
System.
|
Class
Gets or sets a string value indicating the element visual class name. It's used when a stylesheet has been applied to this element.
Declaration
[RadPropertyDefaultValue("Class", typeof(RadElement))]
[StyleBuilderReadOnly]
public string Class { get; set; }Property Value
|
System.
|
Remarks
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.
ClickMode
Specifies when the Click event should fire.
Declaration
[RadPropertyDefaultValue("ClickMode", typeof(RadElement))]
public ClickMode ClickMode { get; set; }Property Value
ClipDrawing
Indicates whether the painting of the element and its children should be restricted to its bounds.
Declaration
[RadPropertyDefaultValue("ClipDrawing", typeof(RadElement))]
public bool ClipDrawing { get; set; }Property Value
|
System.
|
ContainsFocus
Determines whether the element or one of its descendants currently contains the keyboard focus.
Declaration
public bool ContainsFocus { get; }Property Value
|
System.
|
ContainsMouse
Determines whether the element or one of its descendants currently contains the mouse.
Declaration
public bool ContainsMouse { get; set; }Property Value
|
System.
|
ControlBoundingRectangle
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.
Declaration
public virtual Rectangle ControlBoundingRectangle { get; }Property Value
|
System.
|
DesiredSize
Gets the element desired size.
Declaration
public SizeF DesiredSize { get; }Property Value
|
System.
|
DoubleClickEnabled
Gets or sets a value indicating whether the DoubleClick event will fire for this item.
Declaration
public virtual bool DoubleClickEnabled { get; set; }Property Value
|
System.
|
DpiScaleFactor
Declaration
public SizeF DpiScaleFactor { get; protected set; }Property Value
|
System.
|
ElementState
Gets the current state of the element.
Declaration
public ElementState ElementState { get; }Property Value
ElementTree
Gets a reference to the tree object, that contains information about the scene where the element is currently visualized.
Declaration
public virtual ComponentThemableElementTree ElementTree { get; }Property Value
Enabled
Gets or sets a value indicating whether the element can respond to user interaction.
Declaration
[RadPropertyDefaultValue("Enabled", typeof(RadElement))]
public virtual bool Enabled { get; set; }Property Value
|
System.
|
Remarks
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.
FitToSizeMode
Gets or sets a value indicating the way element will fill its available size when parent element is calculating element size and location.
Declaration
[RadPropertyDefaultValue("FitToSizeMode", typeof(RadElement))]
public virtual RadFitToSizeMode FitToSizeMode { get; set; }Property Value
HideFromElementHierarchyEditor
This property is used internally!
Declaration
public bool HideFromElementHierarchyEditor { get; set; }Property Value
|
System.
|
InvalidateChildrenOnChildChanged
Provide for use within TelerikLayoutEngine.
Declaration
public virtual bool InvalidateChildrenOnChildChanged { get; set; }Property Value
|
System.
|
InvalidateMeasureOnRemove
This property is used internally!
Declaration
public bool InvalidateMeasureOnRemove { get; set; }Property Value
|
System.
|
IsAbleToRespondToMouseEvents
Declaration
protected bool IsAbleToRespondToMouseEvents { get; }Property Value
|
System.
|
IsArrangeValid
Declaration
public bool IsArrangeValid { get; }Property Value
|
System.
|
IsElementVisible
Gets a value indicating if the element is visible.
Declaration
public virtual bool IsElementVisible { get; }Property Value
|
System.
|
IsFocusable
This property is used internally!
Declaration
public virtual bool IsFocusable { get; set; }Property Value
|
System.
|
IsFocused
Gets a value indicating whether the element has input focus.
Declaration
public bool IsFocused { get; }Property Value
|
System.
|
IsItemHovered
Declaration
protected virtual bool IsItemHovered { get; }Property Value
|
System.
|
IsLayoutSuspended
Gets a value indicating whether the layout is suspended or not.
Declaration
public bool IsLayoutSuspended { get; }Property Value
|
System.
|
IsMeasureValid
Declaration
public bool IsMeasureValid { get; }Property Value
|
System.
|
IsMouseDown
Gets or sets a value indicating whether the mouse button has been pressed when inside the bounds of the element.
Declaration
public bool IsMouseDown { get; set; }Property Value
|
System.
|
IsMouseOver
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.
Declaration
public bool IsMouseOver { get; set; }Property Value
|
System.
|
IsMouseOverElement
Gets or sets a value indicating whether the mouse has entered the bounds of the element.
Declaration
public bool IsMouseOverElement { get; set; }Property Value
|
System.
|
IsThemeApplied
Gets a value indicating if theme finished applying
Declaration
public bool IsThemeApplied { get; }Property Value
|
System.
|
LayoutableChildrenCount
Gets the count of all elements, which visibility is not ElementVisibility.Collapsed.
Declaration
public int LayoutableChildrenCount { get; }Property Value
|
System.
|
LayoutManager
Gets the layout manager of the element. Will be null until the element is loaded on a visual scene.
Declaration
public ILayoutManager LayoutManager { get; }Property Value
Location
Gets or sets the location of the element based on the element parent rectangle. Corresponds to Bounds.Location
Declaration
public virtual Point Location { get; set; }Property Value
|
System.
|
Margin
Gets or sets a value corresponding to the margins of the element. Margins are not included into the element's bounding rectangle.
Declaration
[RadPropertyDefaultValue("Margin", typeof(RadElement))]
public virtual Padding Margin { get; set; }Property Value
|
System.
|
MaxSize
Get or sets the maximum size to apply on an element when layout is calculated.
Declaration
[RadPropertyDefaultValue("MaxSize", typeof(RadElement))]
public virtual Size MaxSize { get; set; }Property Value
|
System.
|
MeasureInProgress
This property is used internally!
Declaration
public bool MeasureInProgress { get; set; }Property Value
|
System.
|
MeasureIsDirty
This property is used internally!
Declaration
public bool MeasureIsDirty { get; set; }Property Value
|
System.
|
MinSize
Get or sets the minimum size to apply on an element when layout is calculated.
Declaration
[RadPropertyDefaultValue("MinSize", typeof(RadElement))]
public virtual Size MinSize { get; set; }Property Value
|
System.
|
Name
Represents the element unique name.
Declaration
[RadPropertyDefaultValue("Name", typeof(RadElement))]
[StyleBuilderReadOnly]
public virtual string Name { get; set; }Property Value
|
System.
|
NeverArranged
This property is used internally!
Declaration
public bool NeverArranged { get; set; }Property Value
|
System.
|
NeverMeasured
This property is used internally!
Declaration
public bool NeverMeasured { get; set; }Property Value
|
System.
|
NotifyParentOnMouseInput
Gets or sets a value indicating whether the element should pass the handled mouse
event to the first parent element which has the
Should
Declaration
public virtual bool NotifyParentOnMouseInput { get; set; }Property Value
|
System.
|
Padding
Gets or sets the padding sizes of the element. The paddings are included into the element's bounding rectangle.
Declaration
[RadPropertyDefaultValue("Padding", typeof(RadElement))]
public virtual Padding Padding { get; set; }Property Value
|
System.
|
Parent
Gets a reference to the parent element in the visual element tree.
Declaration
public RadElement Parent { get; }Property Value
PositionOffset
Gets or sets the offset of the origin of the coordinate system used when painting the element and its children.
Declaration
[RadPropertyDefaultValue("PositionOffset", typeof(RadElement))]
public virtual SizeF PositionOffset { get; set; }Property Value
|
System.
|
Remarks
TrnslateTransform of the graphics is used prior to painting the element and after painting element children, to reset the transformation
PreviousArrangeRect
This property is used internally.
Declaration
public RectangleF PreviousArrangeRect { get; }Property Value
|
System.
|
PreviousConstraint
Declaration
public SizeF PreviousConstraint { get; }Property Value
|
System.
|
PropagateStyleToChildren
Defines whether stylesheet rules should be applied for this element and its children, or only for this element
Declaration
public virtual bool PropagateStyleToChildren { get; }Property Value
|
System.
|
RenderingMaxFramerate
Gets or sets a value indicating maximum rendered frames per second.
Declaration
public static int RenderingMaxFramerate { get; set; }Property Value
|
System.
|
RightToLeft
Gets or sets the direction of flow of the elements and whether elements are aligned to support locales using right-to-left fonts.
Declaration
[RadPropertyDefaultValue("RightToLeft", typeof(RadElement))]
public virtual bool RightToLeft { get; set; }Property Value
|
System.
|
RoutedEventBehaviors
Declaration
public RoutedEventBehaviorCollection RoutedEventBehaviors { get; }Property Value
ScaleTransform
Gets or sets a value indicating the scale transform factors, when painting the element and its children.
Declaration
[RadPropertyDefaultValue("ScaleTransform", typeof(RadElement))]
public virtual SizeF ScaleTransform { get; set; }Property Value
|
System.
|
ScreenTip
Declaration
public virtual RadScreenTipElement ScreenTip { get; set; }Property Value
SerializeChildren
Gets or sets whether the children of this element should be serialized
Declaration
public virtual bool SerializeChildren { get; set; }Property Value
|
System.
|
SerializeElement
Gets or sets whether the element should be serialized in designer
Declaration
public virtual bool SerializeElement { get; set; }Property Value
|
System.
|
SerializeProperties
Gets or sets whether the properties of this element should be serialized
Declaration
public virtual bool SerializeProperties { get; set; }Property Value
|
System.
|
Shape
Gets or sets an instance of the Shape object of an element. The shape of the element is both responsible for clipping the element's children and for providing its' border(s) with custom shape.
Declaration
[RadPropertyDefaultValue("Shape", typeof(RadElement))]
public virtual ElementShape Shape { get; set; }Property Value
Remarks
Value of null (or Nothing in VisualBasic.Net) indicates that element has rectangular (or no) shape.
Shape is an object that defines the bounding graphics path of an element. Graphics clip is always applied when an element has shape.
Shape is considered when painting the border element, and when hit-testing an element.
Some predefined shapes are available, like Round
ShouldApplyTheme
Gets a value indicating if a theme should be applied
Declaration
public virtual bool ShouldApplyTheme { get; set; }Property Value
|
System.
|
ShouldHandleMouseInput
Specifies whether the Item should handle MouseOver, MouseMove and related mouse events.
Declaration
public virtual bool ShouldHandleMouseInput { get; set; }Property Value
|
System.
|
Remarks
By default only elements that inherit RadItem can process mouse input.
ShouldPaint
Gets or sets a value indicating whether the element should be painted.
Declaration
[RadPropertyDefaultValue("ShouldPaint", typeof(RadElement))]
public virtual bool ShouldPaint { get; set; }Property Value
|
System.
|
Remarks
Children visibility is not be affected.
ShouldPaintChildren
This property is used internally!
Declaration
public bool ShouldPaintChildren { get; set; }Property Value
|
System.
|
ShouldPaintUsingParentShape
Declaration
protected virtual bool ShouldPaintUsingParentShape { get; }Property Value
|
System.
|
Size
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 Auto
Declaration
public virtual Size Size { get; set; }Property Value
|
System.
|
StretchHorizontally
Declaration
[RadPropertyDefaultValue("StretchHorizontally", typeof(RadElement))]
public virtual bool StretchHorizontally { get; set; }Property Value
|
System.
|
StretchVertically
Declaration
[RadPropertyDefaultValue("StretchVertically", typeof(RadElement))]
public virtual bool StretchVertically { get; set; }Property Value
|
System.
|
Style
Gets or sets the stylesheet associated with the element.
Declaration
public StyleSheet Style { get; set; }Property Value
Implements
Remarks
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.
Tag
Declaration
public object Tag { get; set; }Property Value
|
System.
|
ThemeEffectiveType
Declaration
protected virtual Type ThemeEffectiveType { get; }Property Value
|
System.
|
ToolTipText
Declaration
public virtual string ToolTipText { get; set; }Property Value
|
System.
|
TotalTransform
Transform
TreeLevel
Gets the level of this element in the ElementTree it currently resides.
Declaration
public byte TreeLevel { get; }Property Value
|
System.
|
UseCenteredAngleTransform
Gets a value indicating whether the AngleTransform should use the center of the object as origin for the transformation.
Declaration
public bool UseCenteredAngleTransform { get; set; }Property Value
|
System.
|
UseCompatibleTextRendering
Determines whether to use compatible text rendering engine (GDI+) or not (GDI).
Declaration
[RadPropertyDefaultValue("UseCompatibleTextRendering", typeof(RadElement))]
public virtual bool UseCompatibleTextRendering { get; set; }Property Value
|
System.
|
UseSystemSkin
Gets or sets the mode that describes the usage of system skinning (if available).
Declaration
public virtual UseSystemSkinMode UseSystemSkin { get; set; }Property Value
Implements
Visibility
Gets or sets a value indicating element visibility.
Declaration
[RadPropertyDefaultValue("Visibility", typeof(RadElement))]
public virtual ElementVisibility Visibility { get; set; }Property Value
Remarks
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.
VsbVisible
Determines whether the element may be added associated with metadata in the Visual Style Builder.
Declaration
public virtual bool VsbVisible { get; }Property Value
|
System.
|
ZIndex
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
Get
Declaration
[RadPropertyDefaultValue("ZIndex", typeof(RadElement))]
public virtual int ZIndex { get; set; }Property Value
|
System.
|
Methods
AddBehavior(PropertyChangeBehavior)
Adds a property change behavior to the list of behaviors of the element.
Declaration
public void AddBehavior(PropertyChangeBehavior behavior)Parameters
|
Property behavior instance - should not be null (or Nothing in VB.NET) |
Remarks
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.
AddRangeBehavior(PropertyChangeBehaviorCollection)
Declaration
public void AddRangeBehavior(PropertyChangeBehaviorCollection behaviors)Parameters
|
Property list of behaviors |
AddStylePropertySetting(IPropertySetting)
Declaration
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)Parameters
|
IProperty
|
Returns
Overrides
Arrange(RectangleF)
Declaration
public void Arrange(RectangleF finalRect)Parameters
|
System.
|
ArrangeCore(RectangleF)
Declaration
protected virtual void ArrangeCore(RectangleF finalRect)Parameters
|
System.
|
ArrangeOverride(SizeF)
Arranges the Rad
Declaration
protected virtual SizeF ArrangeOverride(SizeF finalSize)Parameters
|
System. The size that is available for element. |
Returns
|
System. The rectangle occupied by the element. Usually |
Remarks
In this method call to the Arrange method of each child must be made.
BringToFront()
Sends this element at the end of its parent's z-ordered collection.
Declaration
public void BringToFront()CalcLayoutOffset(PointF)
Declaration
protected virtual PointF CalcLayoutOffset(PointF startPoint)Parameters
|
System.
|
Returns
|
System.
|
CallCreateChildElements()
Creates the child elements and sets their locally applied values as Default
Declaration
protected virtual void CallCreateChildElements()CallDoClick(EventArgs)
This method is used internally!
Declaration
public void CallDoClick(EventArgs e)Parameters
|
System.
|
CallDoDoubleClick(EventArgs)
This method is used internally!
Declaration
public void CallDoDoubleClick(EventArgs e)Parameters
|
System.
|
CallDoMouseDown(MouseEventArgs)
This method is used internally!
Declaration
public void CallDoMouseDown(MouseEventArgs e)Parameters
|
System.
|
CallDoMouseEnter(EventArgs)
This method is used internally!
Declaration
public void CallDoMouseEnter(EventArgs e)Parameters
|
System.
|
CallDoMouseHover(EventArgs)
This method is used internally!
Declaration
public void CallDoMouseHover(EventArgs e)Parameters
|
System.
|
CallDoMouseLeave(EventArgs)
This method is used internally!
Declaration
public void CallDoMouseLeave(EventArgs e)Parameters
|
System.
|
CallDoMouseMove(MouseEventArgs)
This method is used internally!
Declaration
public void CallDoMouseMove(MouseEventArgs e)Parameters
|
System.
|
CallDoMouseUp(MouseEventArgs)
This method is used internally!
Declaration
public void CallDoMouseUp(MouseEventArgs e)Parameters
|
System.
|
CallDoMouseWheel(MouseEventArgs)
This method is used internally!
Declaration
public void CallDoMouseWheel(MouseEventArgs e)Parameters
|
System.
|
CallOnLoad(Boolean)
This method is used internally.
Declaration
public void CallOnLoad(bool recursive)Parameters
|
System.
|
CallOnRenderSizeChanged(SizeChangedInfo)
This method is used internally.
Declaration
public void CallOnRenderSizeChanged(SizeChangedInfo info)Parameters
|
Size
|
CanExecuteLayoutOperation()
Determines whether the element can perform layout operation.
Declaration
protected virtual bool CanExecuteLayoutOperation()Returns
|
System.
|
CanRaisePropertyChangeNotifications(RadPropertyValue)
Declaration
protected override bool CanRaisePropertyChangeNotifications(RadPropertyValue propVal)Parameters
|
Rad
|
Returns
|
System.
|
Overrides
ChangeCollection(RadElement, ItemsChangeOperation)
Performs an update after a change in the Children collection.
Declaration
public void ChangeCollection(RadElement child, ItemsChangeOperation changeOperation)Parameters
|
Rad The element associated with the change. |
|
Items
|
ClearBehaviors()
Declaration
public void ClearBehaviors()ComposeShouldPaintSystemSkin()
Composes a value which determines whether the element should use system skins when painting.
This method will traverse the element and control tree and will end with the global Use
Declaration
protected virtual bool ComposeShouldPaintSystemSkin()Returns
|
System.
|
CreateChildElements()
Called by the element when constructed. Allows inheritors to build the element tree.
Declaration
protected virtual void CreateChildElements()DisposeChildren()
Declaration
public void DisposeChildren()DisposeManagedResources()
Declaration
protected override void DisposeManagedResources()Overrides
DoClick(EventArgs)
Declaration
protected virtual void DoClick(EventArgs e)Parameters
|
System.
|
DoDoubleClick(EventArgs)
Declaration
protected virtual void DoDoubleClick(EventArgs e)Parameters
|
System.
|
DoMouseDown(MouseEventArgs)
Declaration
protected virtual void DoMouseDown(MouseEventArgs e)Parameters
|
System.
|
DoMouseEnter(EventArgs)
Declaration
protected virtual void DoMouseEnter(EventArgs e)Parameters
|
System.
|
DoMouseHover(EventArgs)
Declaration
protected virtual void DoMouseHover(EventArgs e)Parameters
|
System.
|
DoMouseLeave(EventArgs)
Declaration
protected virtual void DoMouseLeave(EventArgs e)Parameters
|
System.
|
DoMouseMove(MouseEventArgs)
Declaration
protected virtual void DoMouseMove(MouseEventArgs e)Parameters
|
System.
|
DoMouseUp(MouseEventArgs)
Declaration
protected virtual void DoMouseUp(MouseEventArgs e)Parameters
|
System.
|
DoMouseWheel(MouseEventArgs)
Declaration
protected virtual void DoMouseWheel(MouseEventArgs e)Parameters
|
System.
|
DpiScaleChanged(SizeF)
Declaration
public virtual void DpiScaleChanged(SizeF scaleFactor)Parameters
|
System.
|
EnumDescendants(Predicate<RadElement>, TreeTraversalMode)
Provides flexible routine for traversing all descendants of this instance that match the provided predicate.
Declaration
public IEnumerable<RadElement> EnumDescendants(Predicate<RadElement> predicate, TreeTraversalMode traverseMode)Parameters
|
System. The filter that defines the match criteria. |
|
Tree The mode used to traverse the subtree. |
Returns
|
System.
|
EnumDescendants(Filter, TreeTraversalMode)
Provides flexible routine for traversing all descendants of this instance that match the provided filter.
Declaration
public IEnumerable<RadElement> EnumDescendants(Filter filter, TreeTraversalMode traverseMode)Parameters
|
Filter
filter
The filter that defines the match criteria. |
|
Tree The mode used to traverse the subtree. |
Returns
|
System.
|
EnumDescendants(TreeTraversalMode)
Provides flexible routine for traversing all descendants of this instance that match the provided predicate.
Declaration
public IEnumerable<RadElement> EnumDescendants(TreeTraversalMode traverseMode)Parameters
|
Tree The mode used to traverse the subtree. |
Returns
|
System.
|
FindAncestor<T>()
Searches up the parent chain and returns the first parent of type T.
Declaration
public T FindAncestor<T>()
where T : RadElementReturns
|
T
|
Type Parameters
|
T
|
FindAncestorByThemeEffectiveType(Type)
Searches up the parent chain and returns the first parent with the provided ThemeEffectiveType.
Declaration
public RadElement FindAncestorByThemeEffectiveType(Type themeEffectiveType)Parameters
|
System.
|
Returns
FindDescendant(Predicate<RadElement>)
Searches down the subtree of elements, using breadth-first approach, and returns the first descendant of type T.
Declaration
public RadElement FindDescendant(Predicate<RadElement> criteria)Parameters
|
System.
|
Returns
FindDescendant(Type)
Searches down the subtree of elements, using breadth-first approach, and returns the first descendant of the specified Type.
Declaration
public RadElement FindDescendant(Type descendantType)Parameters
|
System.
|
Returns
FindDescendant<T>()
Searches down the subtree of elements, using breadth-first approach, and returns the first descendant of type T.
Declaration
public T FindDescendant<T>()
where T : RadElementReturns
|
T
|
Type Parameters
|
T
|
Focus()
Declaration
public virtual bool Focus()Returns
|
System.
|
Focus(Boolean)
Declaration
protected bool Focus(bool setParentControlFocus)Parameters
|
System.
|
Returns
|
System.
|
GetAncestors(Predicate<RadElement>)
Provides a routine which enumerates all ancestors up in the parent chain of this element, which match the provided predicate.
Declaration
public IEnumerable<RadElement> GetAncestors(Predicate<RadElement> predicate)Parameters
|
System. The predicate used to filter parents. |
Returns
|
System.
|
GetAncestors(Filter)
Provides a routine which enumerates all ancestors up in the parent chain of this element, which match the provided Filter.
Declaration
public IEnumerable<RadElement> GetAncestors(Filter filter)Parameters
|
Filter
filter
|
Returns
|
System.
|
GetArrangeRect(RectangleF)
Gets the arrange rectangle, valid for this element.
Declaration
protected virtual RectangleF GetArrangeRect(RectangleF proposed)Parameters
|
System.
|
Returns
|
System.
|
GetAsBitmap(Brush, Single, SizeF)
Declaration
public Bitmap GetAsBitmap(Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsBitmap(IGraphics, Brush, Single, SizeF)
Declaration
public Bitmap GetAsBitmap(IGraphics screenRadGraphics, Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
IGraphics
screenRadGraphics
|
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsBitmapEx(Brush, Single, SizeF)
Declaration
public Bitmap GetAsBitmapEx(Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsBitmapEx(Color, Single, SizeF)
Declaration
public virtual Bitmap GetAsBitmapEx(Color backColor, float totalAngle, SizeF totalScale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsTransformedBitmap(Brush, Single, SizeF)
Declaration
public Bitmap GetAsTransformedBitmap(Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsTransformedBitmap(Rectangle, Brush, Single, SizeF)
Declaration
public Bitmap GetAsTransformedBitmap(Rectangle clippingRectangle, Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
System.
|
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetAsTransformedBitmap(IGraphics, Brush, Single, SizeF)
Declaration
public Bitmap GetAsTransformedBitmap(IGraphics screenRadGraphics, Brush backgroundBrush, float totalAngle, SizeF totalScale)Parameters
|
IGraphics
screenRadGraphics
|
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetBehaviors()
Declaration
public PropertyChangeBehaviorCollection GetBehaviors()Returns
GetBorderThickness(BorderPrimitive)
Declaration
protected Padding GetBorderThickness(BorderPrimitive element)Parameters
|
Border
|
Returns
|
System.
|
GetBoundingRectangle(Rectangle)
Declaration
public Rectangle GetBoundingRectangle(Rectangle bounds)Parameters
|
System.
|
Returns
|
System.
|
GetBoundingRectangle(Size)
Gets the rectangle which surrounds the rotated element (if having AngleTransform property set).
Declaration
public Rectangle GetBoundingRectangle(Size size)Parameters
|
System. The size of the element which is accepted as a parameter (for example when returned from GetPreferredSize). |
Returns
|
System.
|
GetChildAt(Int32)
Method used by control Code Dom serializer to access items in the collection
Declaration
public virtual RadElement GetChildAt(int index)Parameters
|
System.
|
Returns
GetChildren(ChildrenListOptions)
Allows enumerating of this element's children, using the specified options.
Declaration
public IEnumerable<RadElement> GetChildren(ChildrenListOptions options)Parameters
|
Children
|
Returns
|
System.
|
GetChildrenByBaseType(Type)
Declaration
public List<RadElement> GetChildrenByBaseType(Type type)Parameters
|
System.
|
Returns
|
System.
|
GetChildrenByType(Type)
Gets a list of child elements using the type to filter the results.
Declaration
public List<RadElement> GetChildrenByType(Type type)Parameters
|
System.
|
Returns
|
System.
|
GetClientRectangle(SizeF)
Declaration
protected virtual RectangleF GetClientRectangle(SizeF finalSize)Parameters
|
System.
|
Returns
|
System.
|
GetClipRect()
Declaration
protected virtual RectangleF GetClipRect()Returns
|
System.
|
GetCurrentShape()
GetDescendants(Predicate<RadElement>, TreeTraversalMode)
Gets a list with all the descendants that match the provided filter.
Declaration
public List<RadElement> GetDescendants(Predicate<RadElement> predicate, TreeTraversalMode traverseMode)Parameters
|
System.
|
|
Tree
|
Returns
|
System.
|
GetDescendants(Filter, TreeTraversalMode)
Gets a list with all the descendants that match the provided filter.
Declaration
public List<RadElement> GetDescendants(Filter filter, TreeTraversalMode traverseMode)Parameters
|
Filter
filter
|
|
Tree
|
Returns
|
System.
|
GetDesiredSize(Boolean)
Declaration
public SizeF GetDesiredSize(bool checkCollapsed)Parameters
|
System.
|
Returns
|
System.
|
GetFocusRect()
Declaration
protected virtual Rectangle GetFocusRect()Returns
|
System.
|
GetInvalidateBounds()
Returns the bounds of the area that should be invalidated when the element is invalidated.
Declaration
public virtual Rectangle GetInvalidateBounds()Returns
|
System. The bounds to invalidate. |
GetPaintRectangle(Single, Single, SizeF)
Declaration
protected RectangleF GetPaintRectangle(float borderWidth, float angle, SizeF scale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetPatchedRect(RectangleF, Single, SizeF)
Declaration
protected RectangleF GetPatchedRect(RectangleF rect, float angle, SizeF scale)Parameters
|
System.
|
|
System.
|
|
System.
|
Returns
|
System.
|
GetRegisterRoutedEvent(String)
Declaration
public RoutedEvent GetRegisterRoutedEvent(string eventName)Parameters
|
System.
|
Returns
GetRegisterRoutedEvent(String, String)
Declaration
public static RoutedEvent GetRegisterRoutedEvent(string eventName, string className)Parameters
|
System.
|
|
System.
|
Returns
GetRegisterRoutedEvent(String, Type)
Declaration
public static RoutedEvent GetRegisterRoutedEvent(string eventName, Type ownerType)Parameters
|
System.
|
|
System.
|
Returns
GetScrollingOffset()
Gets the offset that is caused by scrolling. The difference between this method and PositionOffset property is that GetScrollingOffset() takes into account RightToLeft.
Declaration
public Point GetScrollingOffset()Returns
|
System. The scrolling offset for this element. |
GetShadowRect(ref Rectangle, Int32)
Declaration
protected virtual Rectangle GetShadowRect(ref Rectangle elementRect, int shadowDepth)Parameters
|
System.
|
|
System.
|
Returns
|
System.
|
GetStylableChildren()
Declaration
protected virtual IEnumerable<RadObject> GetStylableChildren()Returns
|
System.
|
GetStylableChildrenHierarchy()
Declaration
protected virtual IEnumerable<RadObject> GetStylableChildrenHierarchy()Returns
|
System.
|
GetStylablePropertiesFilter()
Gets the IFilter instance that may be used to filter the properties, treated as Stylable for this element.
Declaration
public virtual Filter GetStylablePropertiesFilter()Returns
GetSystemSkinPaintBounds()
Gets the rectangle where skin background should be painted. Defaults to BoundingRectangle.
Declaration
protected virtual Rectangle GetSystemSkinPaintBounds()Returns
|
System.
|
GetThemeEffectiveType()
Declaration
public Type GetThemeEffectiveType()Returns
|
System.
|
GetValue(RadProperty)
Declaration
public override object GetValue(RadProperty property)Parameters
|
Rad
|
Returns
|
System.
|
Overrides
GetVistaVisualStyle()
Gets the VisualStyleElement instance that describes the skin appearance for the element when the current OS is Windows Vista.
Declaration
public virtual VisualStyleElement GetVistaVisualStyle()Returns
|
System.
|
Implements
GetXPVisualStyle()
Gets the VisualStyleElement instance that describes the skin appearance for the element when the current OS is Windows XP.
Declaration
public virtual VisualStyleElement GetXPVisualStyle()Returns
|
System.
|
Implements
HasInvisibleAncestor()
Determines whether there is an ancestor in this element tree that is not visible.
Declaration
public bool HasInvisibleAncestor()Returns
|
System.
|
HideScreenTip()
Declaration
protected virtual void HideScreenTip()HitTest(Point)
Declaration
public virtual bool HitTest(Point point)Parameters
|
System.
|
Returns
|
System.
|
InitializeFields()
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.
Declaration
protected virtual void InitializeFields()InitializeSystemSkinPaint()
Performs initialization when the element is first-time painted using system skin.
Declaration
protected virtual void InitializeSystemSkinPaint()Invalidate()
Declaration
public void Invalidate()Invalidate(Boolean)
Declaration
public void Invalidate(bool checkSuspended)Parameters
|
System.
|
InvalidateArrange()
Declaration
public void InvalidateArrange()InvalidateArrange(Boolean)
Declaration
public void InvalidateArrange(bool recursive)Parameters
|
System.
|
InvalidateMeasure()
Declaration
public void InvalidateMeasure()InvalidateMeasure(Boolean)
Declaration
public void InvalidateMeasure(bool recursive)Parameters
|
System.
|
InvalidateTransformations()
This method is used internally.
Declaration
public void InvalidateTransformations()IsAncestorOf(RadElement)
Gets a boolean value that determines whether a given element resides in the element hierarchy of this element.
Declaration
public bool IsAncestorOf(RadElement element)Parameters
|
Rad An instance of the Rad |
Returns
|
System.
|
IsChildOf(RadElement)
Get a value indicating whether the element is a direct or indirect child of specified parent element
Declaration
public bool IsChildOf(RadElement parent)Parameters
|
Rad Parent to test |
Returns
|
System. true if the element is child of parent, false otherwise |
IsEventInProcess(RaisedRoutedEvent)
Declaration
public bool IsEventInProcess(RaisedRoutedEvent raisedEvent)Parameters
|
Raised
|
Returns
|
System.
|
IsInGetAsBitmap()
Declaration
protected bool IsInGetAsBitmap()Returns
|
System.
|
IsInputKey(InputKeyEventArgs)
Declaration
protected virtual bool IsInputKey(InputKeyEventArgs e)Parameters
Returns
|
System.
|
IsInValidState(Boolean)
Determines whether the element is currently in valid state. That is having a valid RadElementTree reference and being in either Constructed or Loaded state.
Declaration
public bool IsInValidState(bool checkElementTree)Parameters
|
System.
|
Returns
|
System.
|
IsInVisibleClipBounds(Rectangle)
Declaration
protected virtual bool IsInVisibleClipBounds(Rectangle clipRectangle)Parameters
|
System.
|
Returns
|
System.
|
IsPropertyCancelable(RadPropertyMetadata)
Declaration
protected override bool IsPropertyCancelable(RadPropertyMetadata metadata)Parameters
|
Rad
|
Returns
|
System.
|
Overrides
KillFocus()
Declaration
protected virtual void KillFocus()LoadCore()
Allows inheritors to provide custom load logic.
Declaration
protected virtual void LoadCore()LocationToControl()
Declaration
public Point LocationToControl()Returns
|
System.
|
LockBounds()
Declaration
protected virtual void LockBounds()MapStyleProperty(RadProperty, String)
Maps a style property to another property. This method is used
to map corresponding properties of LightVisualElement
instances and Base
Declaration
public virtual RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)Parameters
|
Rad An instance of the Rad |
|
System.
|
Returns
|
Rad An instance of the Rad |
Measure(SizeF)
Declaration
public void Measure(SizeF availableSize)Parameters
|
System.
|
MeasureChildren(SizeF)
Declaration
protected SizeF MeasureChildren(SizeF availableSize)Parameters
|
System.
|
Returns
|
System.
|
MeasureCore(SizeF)
Declaration
protected virtual SizeF MeasureCore(SizeF availableSize)Parameters
|
System.
|
Returns
|
System.
|
MeasureOverride(SizeF)
Measures the space required by the Rad
Used by the layout system.
Declaration
protected virtual SizeF MeasureOverride(SizeF availableSize)Parameters
|
System. The size that is available to the Rad |
Returns
|
System. The minimum size required by the element to be completely visible. Cannot be infinity. |
Remarks
In this method call to the Measure method of each child must be made.
MouseEventArgsFromControl(MouseEventArgs)
Declaration
protected virtual MouseEventArgs MouseEventArgsFromControl(MouseEventArgs e)Parameters
|
System.
|
Returns
|
System.
|
NotifyChildren(RadPropertyChangedEventArgs)
Declaration
protected virtual void NotifyChildren(RadPropertyChangedEventArgs e)Parameters
NotifyInvalidate(RadElement)
Declaration
protected virtual void NotifyInvalidate(RadElement invalidatedChild)Parameters
|
Rad
|
OnBeginDispose()
A callback used by the owning RadControl to notify the element for the beginning of a disposing process.
Declaration
protected virtual void OnBeginDispose()OnBoundsChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnBoundsChanged(RadPropertyChangedEventArgs e)Parameters
OnBubbleEvent(RadElement, RoutedEventArgs)
Declaration
protected virtual void OnBubbleEvent(RadElement sender, RoutedEventArgs args)Parameters
|
Rad
|
|
Routed
|
OnChildDesiredSizeChanged(RadElement)
Declaration
protected virtual void OnChildDesiredSizeChanged(RadElement child)Parameters
|
Rad
|
OnChildrenChanged(RadElement, ItemsChangeOperation)
Declaration
protected virtual void OnChildrenChanged(RadElement child, ItemsChangeOperation changeOperation)Parameters
|
Rad
|
|
Items
|
OnClick(EventArgs)
Raises the Click event.
Declaration
protected virtual void OnClick(EventArgs e)Parameters
|
System.
|
OnCLREventsRise(RoutedEventArgs)
Declaration
protected virtual void OnCLREventsRise(RoutedEventArgs args)Parameters
|
Routed
|
OnDisplayPropertyChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnDisplayPropertyChanged(RadPropertyChangedEventArgs e)Parameters
OnDoubleClick(EventArgs)
Raises the DoubleClick event.
Declaration
protected virtual void OnDoubleClick(EventArgs e)Parameters
|
System.
|
OnElementTreeChanged(ComponentThemableElementTree)
The element gets notified for a change in its current ElementTree member.
Declaration
protected virtual void OnElementTreeChanged(ComponentThemableElementTree previousTree)Parameters
|
Component
|
OnEnabledChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnEnabledChanged(RadPropertyChangedEventArgs e)Parameters
OnLayoutPropertyChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnLayoutPropertyChanged(RadPropertyChangedEventArgs e)Parameters
OnLoad(Boolean)
A callback used by the owning RadControl to notify the element for a first-time screen visualization.
Declaration
protected void OnLoad(bool recursive)Parameters
|
System. True to notify entire subtree for the load process, false otherwise. |
OnLoaded()
Called when the element has been successfully loaded. That includes loading of all its children as well.
Declaration
protected virtual void OnLoaded()OnLocationChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnLocationChanged(RadPropertyChangedEventArgs e)Parameters
OnLostMouseCapture(MouseEventArgs)
Declaration
protected virtual void OnLostMouseCapture(MouseEventArgs e)Parameters
|
System.
|
OnMouseDown(MouseEventArgs)
Declaration
protected virtual void OnMouseDown(MouseEventArgs e)Parameters
|
System.
|
OnMouseEnter(EventArgs)
Declaration
protected virtual void OnMouseEnter(EventArgs e)Parameters
|
System.
|
OnMouseHover(EventArgs)
Declaration
protected virtual void OnMouseHover(EventArgs e)Parameters
|
System.
|
OnMouseLeave(EventArgs)
Declaration
protected virtual void OnMouseLeave(EventArgs e)Parameters
|
System.
|
OnMouseMove(MouseEventArgs)
Declaration
protected virtual void OnMouseMove(MouseEventArgs e)Parameters
|
System.
|
OnMouseUp(MouseEventArgs)
Declaration
protected virtual void OnMouseUp(MouseEventArgs e)Parameters
|
System.
|
OnMouseWheel(MouseEventArgs)
Raises the MouseWheel event.
Declaration
protected virtual void OnMouseWheel(MouseEventArgs e)Parameters
|
System.
|
OnParentChanged(RadElement)
Notifies for a change in the Parent value.
Declaration
protected virtual void OnParentChanged(RadElement previousParent)Parameters
|
Rad The previous parent element (if any) |
OnParentEnabledChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnParentEnabledChanged(RadPropertyChangedEventArgs e)Parameters
OnParentPropertyChanged(RadPropertyChangedEventArgs)
The object gets notified for a parent property change.
Declaration
protected virtual void OnParentPropertyChanged(RadPropertyChangedEventArgs args)Parameters
OnPropertyChanged(RadPropertyChangedEventArgs)
Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)Parameters
Overrides
OnRenderSizeChanged(SizeChangedInfo)
Declaration
protected virtual void OnRenderSizeChanged(SizeChangedInfo info)Parameters
|
Size
|
OnShowScreenTip(ComponentInputBehavior)
Shows a screen tip.
Declaration
protected virtual bool OnShowScreenTip(ComponentInputBehavior inputBehavior)Parameters
|
Component The input behavior. |
Returns
|
System. A value indicating whether a screen tip is shown. |
OnStyleChanged(RadPropertyChangedEventArgs)
Declaration
protected virtual void OnStyleChanged(RadPropertyChangedEventArgs e)Parameters
OnTransformationInvalidated()
This method is executed when a property which affects the absolute position of the element has been changed.
Declaration
protected virtual void OnTransformationInvalidated()OnTunnelEvent(RadElement, RoutedEventArgs)
Declaration
protected virtual void OnTunnelEvent(RadElement sender, RoutedEventArgs args)Parameters
|
Rad
|
|
Routed
|
OnUnload(ComponentThemableElementTree, Boolean)
Unloads the element if it was previously loaded on an element tree.
Declaration
protected void OnUnload(ComponentThemableElementTree oldTree, bool recursive)Parameters
|
Component Reference to the element tree from which we are in a process of unload. |
|
System.
|
OnUnloaded(ComponentThemableElementTree)
Notifies that the element has been successfully unloaded from an element tree. Allows inheritors to provide custom logic at this stage.
Declaration
protected virtual void OnUnloaded(ComponentThemableElementTree oldTree)Parameters
|
Component Reference to the element tree from which the element has been unloaded. |
OnUseSystemSkinChanged(EventArgs)
The element gets notified for a change in the Use
Declaration
protected virtual void OnUseSystemSkinChanged(EventArgs e)Parameters
|
System.
|
Paint(IGraphics, Rectangle, Single, SizeF, Boolean)
This method is used internally.
Declaration
public void Paint(IGraphics graphics, Rectangle clipRectangle, float angle, SizeF scale, bool useRelativeTransformation)Parameters
|
IGraphics
graphics
|
|
System.
|
|
System.
|
|
System.
|
|
System.
|
PaintBackgroundShape(IGraphics)
Declaration
protected virtual void PaintBackgroundShape(IGraphics graphics)Parameters
|
IGraphics
graphics
|
PaintChild(RadElement, IGraphics, Rectangle, Single, SizeF, Boolean)
Declaration
protected virtual void PaintChild(RadElement child, IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale, bool useRelativeTransformation)Parameters
|
Rad
|
|
IGraphics
graphics
|
|
System.
|
|
System.
|
|
System.
|
|
System.
|
PaintChildren(IGraphics, Rectangle, Single, SizeF, Boolean)
Declaration
protected virtual void PaintChildren(IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale, bool useRelativeTransformation)Parameters
|
IGraphics
graphics
|
|
System.
|
|
System.
|
|
System.
|
|
System.
|
PaintElement(IGraphics, Single, SizeF)
Declaration
protected virtual void PaintElement(IGraphics graphics, float angle, SizeF scale)Parameters
|
IGraphics
graphics
|
|
System.
|
|
System.
|
PaintElementSkin(IGraphics)
Provides a routine to paint element's content when system skin appearance is desired.
Declaration
protected virtual void PaintElementSkin(IGraphics graphics)Parameters
|
IGraphics
graphics
|
PaintFocusCues(IGraphics, Rectangle)
Declaration
protected virtual void PaintFocusCues(IGraphics graphics, Rectangle clipRectange)Parameters
|
IGraphics
graphics
|
|
System.
|
PaintOverride(IGraphics, Rectangle, Single, SizeF, Boolean)
Virtual layer between PaintChildren() and Paint(). Can be overridden to fully customize element hierarchy paint. Used for painting disabled items.
Declaration
protected virtual void PaintOverride(IGraphics graphics, Rectangle clipRectangle, float angle, SizeF scale, bool useRelativeTransformation)Parameters
|
IGraphics
graphics
The graphics object. |
|
System. The rectangle which has been invalidated. |
|
System. 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. |
|
System.
|
|
System.
|
PaintShadow(RadElement, IGraphics)
Declaration
protected virtual void PaintShadow(RadElement child, IGraphics graphics)Parameters
|
Rad
|
|
IGraphics
graphics
|
PaintShadowCore(Graphics, Rectangle, RadItem)
Declaration
protected virtual void PaintShadowCore(Graphics graphics, Rectangle bounds, RadItem child)Parameters
|
System.
|
|
System.
|
|
Rad
|
PerformClick()
Declaration
public virtual void PerformClick()PerformDispose(Boolean)
Declaration
protected override void PerformDispose(bool disposing)Parameters
|
System.
|
Overrides
PerformLayoutTransformation(ref RadMatrix)
Declaration
protected virtual bool PerformLayoutTransformation(ref RadMatrix matrix)Parameters
|
Rad
|
Returns
|
System.
|
PerformPaintTransformation(ref RadMatrix)
Declaration
protected virtual bool PerformPaintTransformation(ref RadMatrix matrix)Parameters
|
Rad
|
Returns
|
System.
|
PointFromControl(Point)
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.
Declaration
public Point PointFromControl(Point point)Parameters
|
System.
|
Returns
|
System.
|
PointFromScreen(Point)
Retrieves a point in control coordinates taking as a parameter a point which is in screen coordinates.
Declaration
public Point PointFromScreen(Point point)Parameters
|
System.
|
Returns
|
System.
|
PointToControl(Point)
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.
Declaration
public Point PointToControl(Point point)Parameters
|
System.
|
Returns
|
System.
|
PointToScreen(Point)
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).
Declaration
public Point PointToScreen(Point point)Parameters
|
System.
|
Returns
|
System.
|
PostPaintChildren(IGraphics, Rectangle, Single, SizeF)
Declaration
protected virtual void PostPaintChildren(IGraphics graphics, Rectangle clipRectange, float angle, SizeF scale)Parameters
|
IGraphics
graphics
|
|
System.
|
|
System.
|
|
System.
|
PostPaintElement(IGraphics)
Declaration
protected virtual void PostPaintElement(IGraphics graphics)Parameters
|
IGraphics
graphics
|
PrePaintElement(IGraphics)
Declaration
protected virtual void PrePaintElement(IGraphics graphics)Parameters
|
IGraphics
graphics
|
ProcessBehaviors(RadPropertyChangedEventArgs)
Declaration
protected virtual void ProcessBehaviors(RadPropertyChangedEventArgs e)Parameters
RaiseBubbleEvent(RadElement, RoutedEventArgs)
Declaration
public virtual void RaiseBubbleEvent(RadElement sender, RoutedEventArgs args)Parameters
|
Rad
|
|
Routed
|
RaiseClick(EventArgs)
Declaration
protected virtual void RaiseClick(EventArgs e)Parameters
|
System.
|
RaiseDoubleClick(EventArgs)
Declaration
protected virtual void RaiseDoubleClick(EventArgs e)Parameters
|
System.
|
RaiseMouseWheel(MouseEventArgs)
Declaration
protected virtual void RaiseMouseWheel(MouseEventArgs e)Parameters
|
System.
|
RaiseRoutedEvent(RadElement, RoutedEventArgs)
Declaration
public virtual void RaiseRoutedEvent(RadElement sender, RoutedEventArgs args)Parameters
|
Rad
|
|
Routed
|
RaiseTunnelEvent(RadElement, RoutedEventArgs)
Declaration
public virtual void RaiseTunnelEvent(RadElement sender, RoutedEventArgs args)Parameters
|
Rad
|
|
Routed
|
RectangleToScreen(Rectangle)
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).
Declaration
public Rectangle RectangleToScreen(Rectangle rect)Parameters
|
System.
|
Returns
|
System.
|
RegisterRoutedEvent(String, Type)
Declaration
public static RoutedEvent RegisterRoutedEvent(string eventName, Type ownerType)Parameters
|
System.
|
|
System.
|
Returns
RemoveBehavior(PropertyChangeBehavior)
Declaration
public void RemoveBehavior(PropertyChangeBehavior behavior)Parameters
|
Property
|
RemoveBehaviors(PropertyChangeBehavior)
Declaration
public virtual void RemoveBehaviors(PropertyChangeBehavior behavior)Parameters
|
Property
|
RemoveRangeBehaviors(PropertyChangeBehaviorCollection)
Declaration
public virtual void RemoveRangeBehaviors(PropertyChangeBehaviorCollection propertyChangeBehaviorCollection)Parameters
|
Property
|
RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)
Declaration
public virtual void RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection routedEventBehaviorCollection)Parameters
|
Routed
|
ReplaceDefaultDescriptors(PropertyDescriptorCollection)
Add the ElementTree property if we are in the context of RadControlSpy.
Declaration
protected override PropertyDescriptorCollection ReplaceDefaultDescriptors(PropertyDescriptorCollection props)Parameters
|
System.
|
Returns
|
System.
|
Overrides
ResetLayout(Boolean)
Resets all layout related fields and puts the element in its initial layout state.
Declaration
public void ResetLayout(bool recursive)Parameters
|
System.
|
ResetLayoutCore()
Declaration
protected virtual void ResetLayoutCore()ResetStyleSettings(Boolean)
Resets the Style modifier of each registered property.
Declaration
public void ResetStyleSettings(bool recursive)Parameters
|
System.
|
ResetStyleSettings(Boolean, RadProperty)
Resets the Style modifier for the specified property. Will reset all properties if null is passed.
Declaration
public virtual void ResetStyleSettings(bool recursive, RadProperty property)Parameters
|
System.
|
|
Rad
|
ResetStyleVersion()
Declaration
protected void ResetStyleVersion()ResetUseCompatibleTextRendering()
Declaration
public void ResetUseCompatibleTextRendering()ResumeLayout(Boolean)
Declaration
public void ResumeLayout(bool performLayout)Parameters
|
System.
|
ResumeLayout(Boolean, Boolean)
Declaration
public virtual void ResumeLayout(bool recursive, bool performLayout)Parameters
|
System.
|
|
System.
|
ResumeReferenceUpdate()
Resumes previously suspended UpdateReference method.
Declaration
public void ResumeReferenceUpdate()ResumeThemeRefresh()
This method is used internally.
Declaration
public void ResumeThemeRefresh()SendToBack()
Sends this element to the beginning of its parent's z-ordered collection.
Declaration
public void SendToBack()SetAllLocalValuesAsDefault(Boolean)
This method is used internally.
Declaration
public virtual void SetAllLocalValuesAsDefault(bool recursive)Parameters
|
System.
|
SetBounds(Rectangle)
Sets the bounds of the element to the specified rectangle (locating and size).
Declaration
public void SetBounds(Rectangle bounds)Parameters
|
System.
|
SetBounds(Int32, Int32, Int32, Int32)
Sets the bounds of the element to the specified rectangle (X, Y, width and height).
Declaration
public void SetBounds(int x, int y, int width, int height)Parameters
|
System.
|
|
System.
|
|
System.
|
|
System.
|
SetBoundsCore(Rectangle)
Declaration
protected virtual void SetBoundsCore(Rectangle bounds)Parameters
|
System.
|
SetClipping(Graphics)
Declaration
protected virtual void SetClipping(Graphics rawGraphics)Parameters
|
System.
|
SetElementFocused(Boolean)
This method sets the focused state of an element. It is used internally.
Declaration
public void SetElementFocused(bool isFocused)Parameters
|
System. The new focused state. |
SetFocus()
This method is used internally!
Declaration
public virtual void SetFocus()SetFocusPropertySafe(Boolean)
Declaration
protected void SetFocusPropertySafe(bool isFocused)Parameters
|
System.
|
SetIsDesignMode(Boolean, Boolean)
This method is used internally!
Declaration
public void SetIsDesignMode(bool value, bool recursive)Parameters
|
System.
|
|
System.
|
SetParent(RadElement)
Applies the specified Rad
Declaration
protected void SetParent(RadElement parent)Parameters
|
Rad
|
SetThemeApplied(Boolean)
Used internally to support RadControl infrastructure. This method is not intended for use directly from your code.
Declaration
protected void SetThemeApplied(bool newValue)Parameters
|
System.
|
SetValueCore(RadPropertyValue, Object, Object, ValueSource)
Declaration
protected override ValueUpdateResult SetValueCore(RadPropertyValue propVal, object propModifier, object newValue, ValueSource source)Parameters
|
Rad
|
|
System.
|
|
System.
|
|
Value
|
Returns
Overrides
ShouldArrangeChild(RadElement)
Gets a value indicating, whether a child will be arranged during the ArrangeOverride.
Declaration
protected virtual bool ShouldArrangeChild(RadElement child)Parameters
|
Rad The child. |
Returns
|
System. Whether the child will be arranged in ArrangeOverride. |
ShouldMeasureChild(RadElement)
Gets a value indicating, whether a child will be measured during the MeasureOverride.
Declaration
protected virtual bool ShouldMeasureChild(RadElement child)Parameters
|
Rad The child. |
Returns
|
System. Whether the child will be measured in MeasureOverride. |
ShouldPaintChild(RadElement)
Declaration
protected virtual bool ShouldPaintChild(RadElement element)Parameters
|
Rad
|
Returns
|
System.
|
ShouldPaintSystemSkin()
Determines whether we should paint system skin.
Declaration
protected virtual bool ShouldPaintSystemSkin()Returns
|
System.
|
ShouldSerializeUseCompatibleTextRendering()
Declaration
public bool ShouldSerializeUseCompatibleTextRendering()Returns
|
System.
|
ShowScreenTip(ScreenTipNeededEventArgs)
Declaration
protected virtual void ShowScreenTip(ScreenTipNeededEventArgs args)Parameters
SuspendLayout()
Temporary suspends layout operations upon this element.
Declaration
public void SuspendLayout()SuspendLayout(Boolean)
Temporary suspends layout operations upon this element.
Declaration
public virtual void SuspendLayout(bool recursive)Parameters
|
System. True to suspend children also, false otherwise. |
SuspendReferenceUpdate()
Temporary suspends UpdateReferences method. Useful when modifying the element tree without changing the actual element's references.
Declaration
public void SuspendReferenceUpdate()SuspendThemeRefresh()
This method is used internally.
Declaration
public void SuspendThemeRefresh()ToString()
Declaration
public override string ToString()Returns
|
System.
|
Overrides
UnapplyStyle()
Declaration
protected virtual void UnapplyStyle()UnitializeSystemSkinPaint()
Declaration
protected virtual void UnitializeSystemSkinPaint()UnloadCore(ComponentThemableElementTree)
Executes the core unload logic. Allows inheritors to perform additional action while the element is unloading itself.
Declaration
protected virtual void UnloadCore(ComponentThemableElementTree oldTree)Parameters
|
Component Reference to the element tree from which we are in a process of unload. |
UnlockBounds()
Declaration
protected virtual void UnlockBounds()UpdateContainsFocus(Boolean)
Updates the ContainsFocus property. The notification may be received from a child whose IsFocused property has changed.
Declaration
protected virtual void UpdateContainsFocus(bool isFocused)Parameters
|
System.
|
UpdateContainsMouse()
Updates the ContainsMouse property. The notification may be received from a child whose IsMouseOver property has changed.
Declaration
public virtual void UpdateContainsMouse()UpdateLayout()
Declaration
public void UpdateLayout()UpdateReferences(ComponentThemableElementTree, Boolean, Boolean)
Updates the local references using the provided element tree.
Declaration
protected virtual void UpdateReferences(ComponentThemableElementTree tree, bool updateInheritance, bool recursive)Parameters
|
Component
|
|
System. True to update inheritance chain, false otherwise. |
|
System. True to update children also, false otherwise. |
Events
ChildrenChanged
Occurs when the children collection of the element is changed.
Declaration
public event ChildrenChangedEventHandler ChildrenChangedEvent Type
Click
Occurs when the element is clicked.
Declaration
public event EventHandler ClickEvent Type
|
System.
|
DoubleClick
Occurs when the element is double-clicked.
Declaration
public virtual event EventHandler DoubleClickEvent Type
|
System.
|
ElementPainted
This event occurs after printing the element. It is used internally.
Declaration
public event PaintEventHandler ElementPaintedEvent Type
|
System.
|
EnabledChanged
Occurs when the enabled state of the element has changed.
Declaration
public event EventHandler EnabledChangedEvent Type
|
System.
|
LayoutUpdated
Declaration
public event EventHandler LayoutUpdatedEvent Type
|
System.
|
LostMouseCapture
Declaration
public event MouseEventHandler LostMouseCaptureEvent Type
|
System.
|
MouseDown
Occurs when the mouse pointer is over the element and a mouse button is pressed.
Declaration
public event MouseEventHandler MouseDownEvent Type
|
System.
|
MouseEnter
Occurs when the mouse pointer enters the element.
Declaration
public event EventHandler MouseEnterEvent Type
|
System.
|
MouseHover
Occurs when the mouse pointer rests on the element.
Declaration
public event EventHandler MouseHoverEvent Type
|
System.
|
MouseLeave
Occurs when the mouse pointer leaves the element.
Declaration
public event EventHandler MouseLeaveEvent Type
|
System.
|
MouseMove
Occurs when the mouse pointer is moved over the element.
Declaration
public event MouseEventHandler MouseMoveEvent Type
|
System.
|
MouseUp
Occurs when the mouse pointer is over the element and a mouse button is released.
Declaration
public event MouseEventHandler MouseUpEvent Type
|
System.
|
MouseWheel
Occurs when the RadItem has focus and the user scrolls up or down the mouse wheel
Declaration
public event MouseEventHandler MouseWheelEvent Type
|
System.
|
Explicit Interface Implementations
IStylableNode.ApplySettings(PropertySettingGroup)
Declaration
void IStylableNode.ApplySettings(PropertySettingGroup group)Parameters
|
Property
|
Implements
IStylableNode.Children
Declaration
IEnumerable<RadObject> IStylableNode.Children { get; }Returns
|
System.
|
Implements
IStylableNode.ChildrenHierarchy
Declaration
IEnumerable<RadObject> IStylableNode.ChildrenHierarchy { get; }Returns
|
System.
|
Implements
IStylableNode.Class
Declaration
string IStylableNode.Class { get; }Returns
|
System.
|
Implements
IStylableNode.GetThemeEffectiveType()
Declaration
Type IStylableNode.GetThemeEffectiveType()Returns
|
System.
|
Implements
IStylableNode.Parent
Declaration
IStylableNode IStylableNode.Parent { get; }
