Class RadItem

Represents an interactive element within the Telerik Presentation Framework that can respond to user input, participate in collections, and provide advanced UI behaviors such as selection, focus, and accessibility.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
CollapsibleElement
RadHostItem
RadScreenTipElement
RootRadElement
UIElement
BaseTimeSpanPickerComponent
CarouselItemsContainer
CollapsiblePanelLayoutElement
ContextualTabGroup
DataFilterCheckboxEditorElement
DataFilterDescriptorItem
DockingGuideImageElement
DockingGuidesElement
ToolWindowCaptionElement
GridLinkItem
GroupBoxVisualElement
RadButtonItem
RadCarouselElement
RadCheckBoxEditorElement
RadCheckmark
RadDropDownButtonElement
RadEditorElement
RadFormElement
RadFormMdiControlStripItem
RadGalleryElement
RadGalleryGroupFilter
RadGalleryGroupItem
RadGalleryPopupElement
RadImageItem
RadItemsContainer
RadLabelElement
RadLineItem
RadMenuElement
RadPanelElement
RadRotatorElement
RadRotatorItem
RadScrollablePanelElement
RadScrollBarElement
RadScrollViewer
RadSpinArrowElement
RadSpinControlButtonsElement
RadStatusBarElement
RadStatusBarPanelElement
RadTitleBarElement
RadTrackBarItem
RadWebBrowserElement
RatingVisualItem
RibbonBarGroupSeparator
SchedulerRangeBase
ScrollBarThumb
SizeGripElement
SizeGripItem
SnapshotDragItem
SplitContainerElement
SplitPanelElement
SplitterElement
TrackBarThumb
UIItemBase
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

[ComVisible(true)]
public class RadItem : RadComponentElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode
Remarks

RadItem extends RadComponentElement with comprehensive user interaction capabilities, making it the base class for all interactive elements in Telerik controls. It provides mouse, keyboard, and touch gesture support with proper event routing and state management.

The class implements ISupportDrag and ISupportDrop for drag-and-drop scenarios, participates in ItemsCollection containers for design-time manipulation, and provides accessibility support through proper role definitions and screen reader compatibility.

RadItem includes extensive design-time support, robust text handling with data binding capabilities, and command integration through IShortcutProvider. It serves as the foundation for interactive elements like buttons, menu items, list items, and tree nodes.

Constructors

RadItem()

Initializes a new instance of the RadItem class.

Declaration
public RadItem()

Fields

ActionCommand

Declaration
public static readonly ClickCommand ActionCommand
Field Value
ClickCommand

BorderHighlightColorProperty

Declaration
public static RadProperty BorderHighlightColorProperty
Field Value
RadProperty

BorderHighlightThicknessProperty

Declaration
public static RadProperty BorderHighlightThicknessProperty
Field Value
RadProperty

EnableBorderHighlightProperty

Declaration
public static RadProperty EnableBorderHighlightProperty
Field Value
RadProperty

EnableElementShadowProperty

Declaration
public static RadProperty EnableElementShadowProperty
Field Value
RadProperty

EnableFocusBorderAnimationProperty

Declaration
public static RadProperty EnableFocusBorderAnimationProperty
Field Value
RadProperty

EnableFocusBorderProperty

Declaration
public static RadProperty EnableFocusBorderProperty
Field Value
RadProperty

EnableHighlightProperty

Declaration
public static RadProperty EnableHighlightProperty
Field Value
RadProperty

EnableRippleAnimationProperty

Declaration
public static RadProperty EnableRippleAnimationProperty
Field Value
RadProperty

FlipTextProperty

Declaration
public static RadProperty FlipTextProperty
Field Value
RadProperty

FocusBorderColorProperty

Declaration
public static RadProperty FocusBorderColorProperty
Field Value
RadProperty

FocusBorderWidthProperty

Declaration
public static RadProperty FocusBorderWidthProperty
Field Value
RadProperty

FocusCommand

Declaration
public static readonly FocusCommand FocusCommand
Field Value
FocusCommand

HighlightColorProperty

Declaration
public static RadProperty HighlightColorProperty
Field Value
RadProperty

IsAddNewItemProperty

Declaration
public static RadProperty IsAddNewItemProperty
Field Value
RadProperty

IsPaintingRipple

Declaration
protected bool IsPaintingRipple
Field Value
System.Boolean

KeyDownEvent

Declaration
public static RoutedEvent KeyDownEvent
Field Value
RoutedEvent

KeyPressEvent

Declaration
public static RoutedEvent KeyPressEvent
Field Value
RoutedEvent

KeyUpEvent

Declaration
public static RoutedEvent KeyUpEvent
Field Value
RoutedEvent

RadItemLastStateKey

This constant is not relevant for this class.

Declaration
protected const long RadItemLastStateKey = 4398046511104L
Field Value
System.Int64

RippleAnimationColorProperty

Declaration
public static RadProperty RippleAnimationColorProperty
Field Value
RadProperty

ShadowColorProperty

Declaration
public static RadProperty ShadowColorProperty
Field Value
RadProperty

ShadowDepthProperty

Declaration
public static RadProperty ShadowDepthProperty
Field Value
RadProperty

StringAlignmentProperty

Declaration
public static RadProperty StringAlignmentProperty
Field Value
RadProperty

TextOrientationProperty

Declaration
public static RadProperty TextOrientationProperty
Field Value
RadProperty

TextProperty

Declaration
public static RadProperty TextProperty
Field Value
RadProperty

ToolTipTextProperty

Declaration
public static RadProperty ToolTipTextProperty
Field Value
RadProperty

UseDefaultDisabledPaintProperty

Declaration
public static RadProperty UseDefaultDisabledPaintProperty
Field Value
RadProperty

VisualStateProperty

Declaration
public static RadProperty VisualStateProperty
Field Value
RadProperty

Properties

AccessibleDescription

Gets or sets the description that will be reported to accessibility client applications.

Declaration
public virtual string AccessibleDescription { get; set; }
Property Value
System.String

AccessibleName

Gets or sets the name of the control for use by accessibility client applications.

Declaration
public virtual string AccessibleName { get; set; }
Property Value
System.String

AccessibleRole

Gets or sets the accessible role of the item, which specifies the type of user interface element of the item.

Declaration
public virtual AccessibleRole AccessibleRole { get; set; }
Property Value
System.Windows.Forms.AccessibleRole

AllowDrag

Determines whether the element may be dragged by a RadDragDropService instance.

Declaration
public bool AllowDrag { get; set; }
Property Value
System.Boolean

Implements

AllowDrop

Determines whether the element may accept a drop operation.

Declaration
public bool AllowDrop { get; set; }
Property Value
System.Boolean

Implements

BorderHighlightColor

Declaration
public Color BorderHighlightColor { get; set; }
Property Value
System.Drawing.Color

BorderHighlightThickness

Declaration
public int BorderHighlightThickness { get; set; }
Property Value
System.Int32

CanHaveOwnStyle

Declaration
public override bool CanHaveOwnStyle { get; }
Property Value
System.Boolean

Overrides

CommandBinding

This property is not relevant for this class.

Declaration
public virtual InputBinding CommandBinding { get; set; }
Property Value
InputBinding

ContainsMnemonic

This property is not relevant for this class.

Declaration
public bool ContainsMnemonic { get; set; }
Property Value
System.Boolean

DefaultAutoToolTip

Gets the default value for the AutoToolTip property.

Declaration
protected virtual bool DefaultAutoToolTip { get; }
Property Value
System.Boolean

The default auto tooltip behavior for this item type.

DesignTimeAllowDrag

This property is not relevant for this class.

Declaration
public virtual bool DesignTimeAllowDrag { get; set; }
Property Value
System.Boolean

DesignTimeAllowDrop

This property is not relevant for this class.

Declaration
public virtual bool DesignTimeAllowDrop { get; set; }
Property Value
System.Boolean

EnableAnalytics

This property is not relevant for this class.

Declaration
public virtual bool EnableAnalytics { get; set; }
Property Value
System.Boolean

EnableBorderHighlight

Declaration
public bool EnableBorderHighlight { get; set; }
Property Value
System.Boolean

EnableElementShadow

Declaration
public bool EnableElementShadow { get; set; }
Property Value
System.Boolean

EnableFocusBorder

Declaration
public bool EnableFocusBorder { get; set; }
Property Value
System.Boolean

EnableFocusBorderAnimation

Declaration
public bool EnableFocusBorderAnimation { get; set; }
Property Value
System.Boolean

EnableHighlight

Declaration
public bool EnableHighlight { get; set; }
Property Value
System.Boolean

EnableRippleAnimation

Declaration
public bool EnableRippleAnimation { get; set; }
Property Value
System.Boolean

FlipText

Specifies the text associated with this item will be flipped.

Declaration
[RadPropertyDefaultValue("FlipText", typeof(RadItem))]
public virtual bool FlipText { get; set; }
Property Value
System.Boolean

FocusBorderColor

Declaration
public Color FocusBorderColor { get; set; }
Property Value
System.Drawing.Color

FocusBorderWidth

Declaration
public int FocusBorderWidth { get; set; }
Property Value
System.Int32

HighlightColor

Declaration
public Color HighlightColor { get; set; }
Property Value
System.Drawing.Color

KeyTip

Gets or sets the key tip text for this item used for keyboard navigation.

Declaration
public virtual string KeyTip { get; set; }
Property Value
System.String

MnemonicText

Declaration
protected virtual string MnemonicText { get; }
Property Value
System.String

ParentItem

Gets the parent RadItem of this item, if any.

Declaration
protected RadItem ParentItem { get; }
Property Value
RadItem

RippleAnimationColor

Declaration
public Color RippleAnimationColor { get; set; }
Property Value
System.Drawing.Color

Selectable

Gets or sets a value indicating whether the item can be selected.

Declaration
public virtual bool Selectable { get; }
Property Value
System.Boolean

SerializeProperties

Declaration
public override bool SerializeProperties { get; set; }
Property Value
System.Boolean

Overrides

ShadowColor

Declaration
public Color ShadowColor { get; set; }
Property Value
System.Drawing.Color

ShadowDepth

Declaration
[RadPropertyDefaultValue("ShadowDepth", typeof(RadItem))]
public int ShadowDepth { get; set; }
Property Value
System.Int32

Shortcuts

Gets the collection of all RadShortcut instances registered with this item.

Declaration
public RadShortcutCollection Shortcuts { get; }
Property Value
RadShortcutCollection

Implements

ShortcutsHandler

Gets the shortcuts handler for managing keyboard shortcuts.

Declaration
protected virtual IComponentTreeHandler ShortcutsHandler { get; }
Property Value
IComponentTreeHandler

ShouldHandleMouseInput

Gets or sets a value indicating whether the item should handle mouse input events.

Declaration
public override bool ShouldHandleMouseInput { get; set; }
Property Value
System.Boolean

Overrides

StateManager

Declaration
public virtual ItemStateManagerBase StateManager { get; set; }
Property Value
ItemStateManagerBase

Implements

Text

Gets or sets the text displayed by this item.

Declaration
[RadPropertyDefaultValue("", typeof(RadItem))]
public virtual string Text { get; set; }
Property Value
System.String

The text content of the item. The default value is an empty string.
Remarks

This property supports data binding and localization. The text can contain HTML markup when the HTML support is enabled for the containing control. Changes to this property will trigger layout updates and repainting of the item.

TextOrientation

Specifies the orientation of the text associated with this item. Whether it should appear horizontal or vertical.

Declaration
[RadPropertyDefaultValue("TextOrientation", typeof(RadItem))]
public virtual Orientation TextOrientation { get; set; }
Property Value
System.Windows.Forms.Orientation

ThemeRole

Declaration
public string ThemeRole { get; set; }
Property Value
System.String

ToolTipText

Declaration
public override string ToolTipText { get; set; }
Property Value
System.String

Overrides

UseDefaultDisabledPaint

Gets or sets whether the item should use the default way for painting the item when disabled (making it gray) or whether the disabled appearance should be controlled by the theme.

Declaration
[RadPropertyDefaultValue("UseDefaultDisabledPaint", typeof(RadItem))]
public bool UseDefaultDisabledPaint { get; set; }
Property Value
System.Boolean

VisualState

Gets or sets string representing the current visual state of the Item which is used by themes to determine the appearance of the item and its child elements

Declaration
public string VisualState { get; set; }
Property Value
System.String

Methods

CallOnGesture(GestureEventArgs)

Calls the OnGesture(GestureEventArgs) method for handling gesture input.

Declaration
protected void CallOnGesture(GestureEventArgs args)
Parameters
GestureEventArgs args

The gesture event arguments.

CallRaiseKeyDown(KeyEventArgs)

This method is used internally.

Declaration
public void CallRaiseKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

CallRaiseKeyPress(KeyPressEventArgs)

This method is used internally.

Declaration
public void CallRaiseKeyPress(KeyPressEventArgs e)
Parameters
System.Windows.Forms.KeyPressEventArgs e

The key press event arguments.

CallRaiseKeyUp(KeyEventArgs)

This method is used internally.

Declaration
public void CallRaiseKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

CanDragCore(Point)

Determines whether the element may be dragged.

Declaration
protected virtual bool CanDragCore(Point dragStartPoint)
Parameters
System.Drawing.Point dragStartPoint

Returns
System.Boolean

CanHandleShortcut(ShortcutEventArgs)

Declaration
protected virtual bool CanHandleShortcut(ShortcutEventArgs e)
Parameters
ShortcutEventArgs e

Returns
System.Boolean

ContainsText()

Determines if the item displays any text.

Declaration
protected virtual bool ContainsText()
Returns
System.Boolean

True if the item contains text; otherwise, false.

Deselect()

Deselects this item if it is selectable.

Declaration
public void Deselect()

DisposeManagedResources()

Releases managed resources used by this element.

Declaration
protected override void DisposeManagedResources()
Overrides

DoKeyDown(KeyEventArgs)

Handles the KeyDown event for this item.

Declaration
protected virtual void DoKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

DoKeyPress(KeyPressEventArgs)

Handles the KeyPress event for this item.

Declaration
protected virtual void DoKeyPress(KeyPressEventArgs e)
Parameters
System.Windows.Forms.KeyPressEventArgs e

The key press event arguments.

DoKeyUp(KeyEventArgs)

Handles the KeyUp event for this item.

Declaration
protected virtual void DoKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

GetAvailableVisualStates()

Gets the available visual states for this item. Visual states can be combined using "." (dot).

Declaration
public List<string> GetAvailableVisualStates()
Returns
System.Collections.Generic.List<System.String>

A list with the available visual states for this element.

GetDragContextCore()

Gets the context, associated with a drag operation.

Declaration
protected virtual object GetDragContextCore()
Returns
System.Object

The drag context object.

GetDragHintCore()

Gets the image to be used as a hint when this element is being dragged.

Declaration
protected virtual Image GetDragHintCore()
Returns
System.Drawing.Image

An image representing the drag hint for this element.

InitializeFields()

Initializes the fields of this instance with their default values.

Declaration
protected override void InitializeFields()
Overrides

IsOnActiveForm(Control, Boolean)

Declaration
protected virtual bool IsOnActiveForm(Control focusedControl, bool checkLoaded)
Parameters
System.Windows.Forms.Control focusedControl

System.Boolean checkLoaded

Returns
System.Boolean

OnDeselect()

Called when the item is deselected. Notifies the parent control to clear the selected item.

Declaration
protected virtual void OnDeselect()

OnEnabledChanged(RadPropertyChangedEventArgs)

Called when the Enabled property changes, applying special handling for disabled state.

Declaration
protected override void OnEnabledChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

The property changed event arguments.
Overrides

OnFlipTextChanged(EventArgs)

Raises the FlipTextChanged event.

Declaration
protected virtual void OnFlipTextChanged(EventArgs e)
Parameters
System.EventArgs e

An System.EventArgs that contains the event data.

OnGesture(GestureEventArgs)

Calls the appropriate gesture event according to the GestureType property of the event arguments.

Declaration
protected virtual void OnGesture(GestureEventArgs args)
Parameters
GestureEventArgs args

The event arguments.

OnKeyDown(KeyEventArgs)

Raises the KeyDown event.

Declaration
protected virtual void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

OnKeyPress(KeyPressEventArgs)

Raises the KeyPress event.

Declaration
protected virtual void OnKeyPress(KeyPressEventArgs e)
Parameters
System.Windows.Forms.KeyPressEventArgs e

The key press event arguments.

OnKeyUp(KeyEventArgs)

Raises the KeyUp event.

Declaration
protected virtual void OnKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

The key event arguments.

OnMouseDown(MouseEventArgs)

Called when a mouse button is pressed down over the item.

Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The mouse event arguments.
Overrides

OnMouseLeave(EventArgs)

Declaration
protected override void OnMouseLeave(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnMouseMove(MouseEventArgs)

Called when the mouse moves over the item, handling highlight and border highlight effects.

Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The mouse event arguments.
Overrides

OnMouseUp(MouseEventArgs)

Called when a mouse button is released over the item.

Declaration
protected override void OnMouseUp(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The mouse event arguments.
Overrides

OnPanGesture(PanGestureEventArgs)

Fires the PanGesture event.

Declaration
protected virtual void OnPanGesture(PanGestureEventArgs args)
Parameters
PanGestureEventArgs args

The arguments for the PanGesture event.

OnPressAndTapGesture(PressAndTapGestureEventArgs)

Fires the PressAndTapGesture event.

Declaration
protected virtual void OnPressAndTapGesture(PressAndTapGestureEventArgs args)
Parameters
PressAndTapGestureEventArgs args

The arguments for the PressAndTapGesture event.

OnPropertyChanged(RadPropertyChangedEventArgs)

Called when a property value has changed, handling item-specific property change logic including text, visual state, and animation properties.

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

The property changed event arguments.
Overrides

OnPropertyChanging(RadPropertyChangingEventArgs)

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

Declaration
protected override void OnPropertyChanging(RadPropertyChangingEventArgs args)
Parameters
RadPropertyChangingEventArgs args

The property changing event arguments.
Overrides

OnRotateGesture(RotateGestureEventArgs)

Fires the RotateGesture event.

Declaration
protected virtual void OnRotateGesture(RotateGestureEventArgs args)
Parameters
RotateGestureEventArgs args

The arguments for the RotateGesture event.

OnSelect()

Called when the item is selected. Notifies the parent control to update the selected item.

Declaration
protected virtual void OnSelect()

OnTextChanged(EventArgs)

Raises the TextChanged event.

Declaration
protected virtual void OnTextChanged(EventArgs e)
Parameters
System.EventArgs e

An System.EventArgs that contains the event data.

OnTextChanging(TextChangingEventArgs)

Raises the TextChanging event.

Declaration
protected virtual void OnTextChanging(TextChangingEventArgs e)
Parameters
TextChangingEventArgs e

A TextChangingEventArgs that contains the event data.

OnTextOrientationChanged(EventArgs)

Raises the TextOrientationChanged event.

Declaration
protected virtual void OnTextOrientationChanged(EventArgs e)
Parameters
System.EventArgs e

An System.EventArgs that contains the event data.

OnTwoFingerTapGesture(GestureEventArgs)

Fires the TwoFingerTapGesture event.

Declaration
protected virtual void OnTwoFingerTapGesture(GestureEventArgs args)
Parameters
GestureEventArgs args

The arguments for the TwoFingerTapGesture event.

OnZoomGesture(ZoomGestureEventArgs)

Fires the ZoomGesture event.

Declaration
protected virtual void OnZoomGesture(ZoomGestureEventArgs args)
Parameters
ZoomGestureEventArgs args

The arguments for the ZoomGesture event.

PaintOverride(IGraphics, Rectangle, Single, SizeF, Boolean)

Paints the item, handling disabled state rendering with special grayscale treatment when UseDefaultDisabledPaint is true.

Declaration
protected override void PaintOverride(IGraphics screenRadGraphics, Rectangle clipRectangle, float angle, SizeF scale, bool useRelativeTransformation)
Parameters
IGraphics screenRadGraphics

The graphics object to paint on.
System.Drawing.Rectangle clipRectangle

The clipping rectangle for painting.
System.Single angle

The rotation angle to apply.
System.Drawing.SizeF scale

The scale factor to apply.
System.Boolean useRelativeTransformation

Whether to use relative transformation.
Overrides

ProcessCmdKey(ref Message, Keys)

Declaration
protected virtual bool ProcessCmdKey(ref Message m, Keys keyData)
Parameters
System.Windows.Forms.Message m

System.Windows.Forms.Keys keyData

Returns
System.Boolean

ProcessDialogKey(Keys)

Declaration
protected virtual bool ProcessDialogKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

Returns
System.Boolean

ProcessDragDrop(Point, ISupportDrag)

Core logic when a drag-drop is performed over this element. Allows inheritors to provide their own implementations.

Declaration
protected virtual void ProcessDragDrop(Point dropLocation, ISupportDrag dragObject)
Parameters
System.Drawing.Point dropLocation

The location where the drop occurred.
ISupportDrag dragObject

The object being dragged.

ProcessDragEnter(Point, ISupportDrag)

Allows the element to perform additional action upon mouse entering its bounds upon a drag-and-drop operation.

Declaration
protected virtual void ProcessDragEnter(Point mousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point mousePosition

The current mouse position.
ISupportDrag dragObject

The object being dragged.

ProcessDragLeave(Point, ISupportDrag)

Allows the element to perform additional action upon mouse leaving its bounds upon a drag-and-drop operation.

Declaration
protected virtual void ProcessDragLeave(Point oldMousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point oldMousePosition

The previous mouse position.
ISupportDrag dragObject

The object being dragged.

ProcessDragOver(Point, ISupportDrag)

Determines whether the element may be treated as a drop target during drag-and-drop operation.

Declaration
protected virtual bool ProcessDragOver(Point mousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point mousePosition

The current mouse position.
ISupportDrag dragObject

The object being dragged.
Returns
System.Boolean

True if the element can accept the drop; otherwise, false.

ProcessMnemonic(Char)

This method is not relevant for this class.

Declaration
public virtual bool ProcessMnemonic(char charCode)
Parameters
System.Char charCode

The mnemonic character code.
Returns
System.Boolean

True if the mnemonic was processed; otherwise, false.

RaiseBubbleEvent(RadElement, RoutedEventArgs)

Raises routed events in the bubble phase, handling key events specifically.

Declaration
public override void RaiseBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters
RadElement sender

The element that raised the event.
RoutedEventArgs args

The routed event arguments.
Overrides

RaiseKeyDown(KeyEventArgs)

Declaration
protected virtual void RaiseKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

RaiseKeyPress(KeyPressEventArgs)

Declaration
protected virtual void RaiseKeyPress(KeyPressEventArgs e)
Parameters
System.Windows.Forms.KeyPressEventArgs e

RaiseKeyUp(KeyEventArgs)

Declaration
protected virtual void RaiseKeyUp(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

ReplaceDefaultDescriptors(PropertyDescriptorCollection)

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

Declaration
protected override PropertyDescriptorCollection ReplaceDefaultDescriptors(PropertyDescriptorCollection props)
Parameters
System.ComponentModel.PropertyDescriptorCollection props

Returns
System.ComponentModel.PropertyDescriptorCollection

Overrides

ResetThemeValueOverride(RadProperty)

Resets all overrides for the theme settings of a given property.

Declaration
public void ResetThemeValueOverride(RadProperty property)
Parameters
RadProperty property

The property to reset overrides for.

ResetThemeValueOverride(RadProperty, String)

Resets all overrides for the theme settings of a given property and a given state.

Declaration
public void ResetThemeValueOverride(RadProperty property, string state)
Parameters
RadProperty property

The property to reset overrides for.
System.String state

The state to reset.

ResetThemeValueOverrides()

Resets all theme override settings for this element.

Declaration
public void ResetThemeValueOverrides()

ResumeApplyOfThemeSettings()

Resumes the apply of theme settings.

Declaration
public void ResumeApplyOfThemeSettings()

Select()

Selects this item if it is selectable.

Declaration
public bool Select()
Returns
System.Boolean

True if the item was successfully selected; otherwise, false.

SetOwnerCollection(RadItemOwnerCollection)

Sets the owner collection for this item.

Declaration
protected virtual void SetOwnerCollection(RadItemOwnerCollection ownerCollection)
Parameters
RadItemOwnerCollection ownerCollection

The collection that owns this item.

SetThemeValueOverride(RadProperty, Object, String)

Applies the provided value as an override of the theme setting for the specified property in the specified state.

Declaration
public void SetThemeValueOverride(RadProperty property, object value, string state)
Parameters
RadProperty property

The property to override.
System.Object value

The value to override the theme setting with.
System.String state

The VisualState of the item for which the setting will be applied. States can be combined using "." (dot). To see a list of the available states for this element, use the GetAvailableVisualStates method.

SetThemeValueOverride(RadProperty, Object, String, String)

Applies the provided value as an override of the theme setting for the specified property in the specified state.

Declaration
public void SetThemeValueOverride(RadProperty property, object value, string state, string childElementClass)
Parameters
RadProperty property

The property to override.
System.Object value

The value to override the theme setting with.
System.String state

The VisualState of the item for which the setting will be applied. States can be combined using "." (dot). To see a list of the available states for this element, use the GetAvailableVisualStates method.
System.String childElementClass

The value of the Class property of the child element for which the override stands. (e.g. ButtonFill, ButtonBorder, etc.)

SetThemeValueOverride(RadProperty, Object, String, Type)

Applies the provided value as an override of the theme setting for the specified property in the specified state.

Declaration
public void SetThemeValueOverride(RadProperty property, object value, string state, Type childElementType)
Parameters
RadProperty property

The property to override.
System.Object value

The value to override the theme setting with.
System.String state

The VisualState of the item for which the setting will be applied. States can be combined using "." (dot). To see a list of the available states for this element, use the GetAvailableVisualStates method.
System.Type childElementType

The type of the child element for which the override stands. (e.g. typeof(FillPrimitive), typeof(BorderPrimitive), etc.)

ShouldFallbackToDefaultTheme()

Declaration
protected virtual bool ShouldFallbackToDefaultTheme()
Returns
System.Boolean

ShouldSerializeProperty(PropertyDescriptor)

Declaration
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters
System.ComponentModel.PropertyDescriptor property

Returns
System.Nullable<System.Boolean>

Overrides

StartRippleAnimation(MouseEventArgs)

Declaration
protected virtual void StartRippleAnimation(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

SuspendApplyOfThemeSettings()

Suspends the apply of theme settings.

Declaration
public void SuspendApplyOfThemeSettings()

UpdateFocusBorder(Boolean)

Declaration
protected virtual void UpdateFocusBorder(bool isFocused)
Parameters
System.Boolean isFocused

UpdateOnShortcutsChanged()

Declaration
protected virtual void UpdateOnShortcutsChanged()

Events

FlipTextChanged

Occurs when the FlipText property value changes.

Declaration
public event EventHandler FlipTextChanged
Event Type
System.EventHandler

KeyDown

Occurs when the RadItem has focus and the user presses a key down.

Declaration
public event KeyEventHandler KeyDown
Event Type
System.Windows.Forms.KeyEventHandler

KeyPress

Occurs when the RadItem has focus and the user presses a key.

Declaration
public event KeyPressEventHandler KeyPress
Event Type
System.Windows.Forms.KeyPressEventHandler

KeyUp

Occurs when the RadItem has focus and the user releases the pressed key up.

Declaration
public event KeyEventHandler KeyUp
Event Type
System.Windows.Forms.KeyEventHandler

PanGesture

Occurs when a pan gesture was sent by a touch input device.

Declaration
public event PanGestureEventHandler PanGesture
Event Type
PanGestureEventHandler

PressAndTapGesture

Occurs when a press-and-tap gesture was sent by a touch input device.

Declaration
public event PressAndTapGestureEventHandler PressAndTapGesture
Event Type
PressAndTapGestureEventHandler

QueryAccessibilityHelp

Occurs when help is requested for an accessibility object.

Declaration
public event QueryAccessibilityHelpEventHandler QueryAccessibilityHelp
Event Type
System.Windows.Forms.QueryAccessibilityHelpEventHandler

RotateGesture

Occurs when a rotate gesture was sent by a touch input device.

Declaration
public event RotateGestureEventHandler RotateGesture
Event Type
RotateGestureEventHandler

TextChanged

Occurs when the Text property value changes.

Declaration
public event EventHandler TextChanged
Event Type
System.EventHandler

TextChanging

Occurs when the Text property value is about to be changed.

Declaration
public event TextChangingEventHandler TextChanging
Event Type
TextChangingEventHandler

TextOrientationChanged

Occurs when the TextOrientation property value changes.

Declaration
public event EventHandler TextOrientationChanged
Event Type
System.EventHandler

TwoFingerTapGesture

Occurs when a two-finger-tap gesture was sent by a touch input device.

Declaration
public event GestureEventHandler TwoFingerTapGesture
Event Type
GestureEventHandler

ZoomGesture

Occurs when a zoom gesture was sent by a touch input device.

Declaration
public event ZoomGestureEventHandler ZoomGesture
Event Type
ZoomGestureEventHandler

Explicit Interface Implementations

IShortcutProvider.OnPartialShortcut(PartialShortcutEventArgs)

Declaration
void IShortcutProvider.OnPartialShortcut(PartialShortcutEventArgs e)
Parameters
PartialShortcutEventArgs e

Implements

IShortcutProvider.OnShortcut(ShortcutEventArgs)

Declaration
void IShortcutProvider.OnShortcut(ShortcutEventArgs e)
Parameters
ShortcutEventArgs e

Implements

IShortcutProvider.OnShortcutsChanged()

Declaration
void IShortcutProvider.OnShortcutsChanged()
Implements

IStylableElement.FallbackToDefaultTheme

Declaration
bool IStylableElement.FallbackToDefaultTheme { get; }
Returns
System.Boolean

Implements

IStylableElement.ThemeRole

Declaration
string IStylableElement.ThemeRole { get; }
Returns
System.String

Implements

IStylableElement.VisualState

Declaration
string IStylableElement.VisualState { get; set; }
Returns
System.String

Implements

ISupportDrag.CanDrag(Point)

Declaration
bool ISupportDrag.CanDrag(Point dragStartPoint)
Parameters
System.Drawing.Point dragStartPoint

Returns
System.Boolean

Implements

ISupportDrag.GetDataContext()

Declaration
object ISupportDrag.GetDataContext()
Returns
System.Object

Implements

ISupportDrag.GetDragHint()

Declaration
Image ISupportDrag.GetDragHint()
Returns
System.Drawing.Image

Implements

ISupportDrop.DragDrop(Point, ISupportDrag)

Declaration
void ISupportDrop.DragDrop(Point dropLocation, ISupportDrag dragObject)
Parameters
System.Drawing.Point dropLocation

ISupportDrag dragObject

Implements

ISupportDrop.DragEnter(Point, ISupportDrag)

Declaration
void ISupportDrop.DragEnter(Point mousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point mousePosition

ISupportDrag dragObject

Implements

ISupportDrop.DragLeave(Point, ISupportDrag)

Declaration
void ISupportDrop.DragLeave(Point oldMousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point oldMousePosition

ISupportDrag dragObject

Implements

ISupportDrop.DragOver(Point, ISupportDrag)

Declaration
bool ISupportDrop.DragOver(Point mousePosition, ISupportDrag dragObject)
Parameters
System.Drawing.Point mousePosition

ISupportDrag dragObject

Returns
System.Boolean

Implements

Extension Methods