• Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • Conversational UI
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for Xamarin
    Desktop
    UI for WinForms UI for WPF UI for WinUI UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    Debugging
    FiddlerCore Fiddler Everywhere
    CMS
    Sitefinity
    UX Design
    Unite UX
    Document Management
    Telerik Document Processing
    Innovations Lab
    VR DataViz
    Free Tools
    Fiddler Classic JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Edit Profile
    • Payment Profiles
    • Renewals & Upgrades
    • Support Tickets
    • Log out
  • Login
  • Contact Us
  • Try now

Class RadListDataItem

Inheritance
System.Object
DisposableObject
RadObject
RadListDataItem
CommandBarItemsListDataItem
CommandBarStripsListDataItem
DescriptionTextListDataItem
RadCheckedListDataItem
Inherited Members
RadObject.BindingContextProperty
RadObject.RadType
RadObject.DisposeManagedResources()
RadObject.ClearPropertyStore()
RadObject.SuspendPropertyNotifications()
RadObject.ResumePropertyNotifications()
RadObject.GetPropertyValue(RadProperty)
RadObject.SetDefaultValueOverride(RadProperty, Object)
RadObject.SetValueAtDesignTime(RadProperty, Object)
RadObject.GetValue(RadProperty)
RadObject.SetValue(RadProperty, Object)
RadObject.ResetValue(RadProperty)
RadObject.ResetValue(RadProperty, ValueResetFlags)
RadObject.UpdateValue(RadProperty)
RadObject.GetValueSource(RadProperty)
RadObject.GetRegisteredRadProperty(String)
RadObject.UpdateValueCore(RadPropertyValue)
RadObject.SetValueCore(RadPropertyValue, Object, Object, ValueSource)
RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)
RadObject.GetDefaultValue(RadPropertyValue, Object)
RadObject.CoerceValue(RadPropertyValue, Object)
RadObject.ShouldSerializeProperty(PropertyDescriptor)
RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)
RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)
RadObject.UnbindProperty(RadProperty)
RadObject.AddStylePropertySetting(IPropertySetting)
RadObject.RemoveStylePropertySetting(IPropertySetting)
RadObject.RemoveStylePropertySetting(RadProperty)
RadObject.GetInheritedValue(RadProperty)
RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)
RadObject.OnNotifyPropertyChanged(String)
RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)
RadObject.IsPropertyCancelable(RadPropertyMetadata)
RadObject.PropertyValues
RadObject.IsDesignMode
RadObject.PropertyFilter
RadObject.RadObjectType
RadObject.BindingContext
RadObject.PropertyChanged
RadObject.RadPropertyChanged
RadObject.RadPropertyChanging
DisposableObject.GetBitState(Int64)
DisposableObject.SetBitState(Int64, Boolean)
DisposableObject.OnBitStateChanged(Int64, Boolean, Boolean)
DisposableObject.Dispose()
DisposableObject.Dispose(Boolean)
DisposableObject.PerformDispose(Boolean)
DisposableObject.DisposeUnmanagedResources()
DisposableObject.BitState
DisposableObject.Events
DisposableObject.IsDisposing
DisposableObject.IsDisposed
DisposableObject.Disposed
DisposableObject.Disposing
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.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadListDataItem : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IDataItem

Constructors

RadListDataItem()

Declaration
public RadListDataItem()

RadListDataItem(String)

Declaration
public RadListDataItem(string text)
Parameters
System.String text

RadListDataItem(String, Object)

Declaration
public RadListDataItem(string text, object value)
Parameters
System.String text

System.Object value

Fields

ActiveProperty

Declaration
public static readonly RadProperty ActiveProperty
Field Value
RadProperty

dataLayer

Declaration
protected ListDataLayer dataLayer
Field Value
ListDataLayer

HeightProperty

Declaration
public static readonly RadProperty HeightProperty
Field Value
RadProperty

ownerElement

Declaration
protected RadListElement ownerElement
Field Value
RadListElement

SelectedProperty

Declaration
public static readonly RadProperty SelectedProperty
Field Value
RadProperty

ValueProperty

Declaration
public static readonly RadProperty ValueProperty
Field Value
RadProperty

Properties

Active

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

DataBoundItem

Gets or sets a value that represents the raw data item that this RadListDataItem is associated with. This property will be non null when the item is created via RadListControl's data binding and will contain the underlaying data item. Setting this property explicitly will have no effect in unbound mode and will throw an InvalidOperationException in bound mode.

Declaration
public object DataBoundItem { get; set; }
Property Value
System.Object

Implements
IDataItem.DataBoundItem

DisplayValue

Gets a value that will be used in the visual representation of this item.

Declaration
public object DisplayValue { get; }
Property Value
System.Object

Enabled

Gets or sets whether this item responds to GUI events.

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

FieldCount

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

Implements
IDataItem.FieldCount

Font

Gets or sets the font for this RadListDataItem instance.

Declaration
[RadPropertyDefaultValue("Font", typeof(VisualElement))]
public Font Font { get; set; }
Property Value
System.Drawing.Font

ForeColor

Gets or sets the text color for this RadListDataItem instance.

Declaration
[RadPropertyDefaultValue("ForeColor", typeof(VisualElement))]
public Color ForeColor { get; set; }
Property Value
System.Drawing.Color

Height

Gets or sets the visual height of this item. This property can be set only when AutoSizeItems of the parent RadListControl is true.

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

Image

Gets or sets an image for this RadListDataItem instance.

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

ImageAlignment

Gets or sets the image alignment for this RadListDataItem instance.

Declaration
public ContentAlignment ImageAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

Index

Gets the index of item in GridViewRowCollection.

Declaration
public virtual int Index { get; }
Property Value
System.Int32

The index.

IsDataBound

Gets a value indicating whether this data item is data bound.

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

IsVisible

Gets a value that indicates if this item is currently visible.

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

Item[Int32]

Declaration
public object this[int index] { get; set; }
Parameters
System.Int32 index

Property Value
System.Object

Implements
IDataItem.Item[Int32]

Item[String]

Declaration
public object this[string name] { get; set; }
Parameters
System.String name

Property Value
System.Object

Implements
IDataItem.Item[String]

MeasuredSize

Gets or sets the preferred size for the element which will present this item.

Declaration
public SizeF MeasuredSize { get; set; }
Property Value
System.Drawing.SizeF

Owner

Gets a value representing the owner RadListElement of this data item.

Declaration
public virtual RadListElement Owner { get; }
Property Value
RadListElement

OwnerControl

Gets a value representing the owner control of this data item.

Declaration
public Control OwnerControl { get; }
Property Value
System.Windows.Forms.Control

RowIndex

Gets the index of this data item in the Items collection of RadListControl.

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

Selected

Gets or sets a value that indicates if this item is selected. Setting this property will cause the selection events of the owner list control to fire if there is one.

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

SvgImage

Gets or sets a vector image for this RadListDataItem instance.

Declaration
public RadSvgImage SvgImage { get; set; }
Property Value
RadSvgImage

Tag

Declaration
public object Tag { get; set; }
Property Value
System.Object

Text

Gets or sets the text for this RadListDataItem instance.

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

TextAlignment

Gets or sets the text alignment for this RadListDataItem instance.

Declaration
public ContentAlignment TextAlignment { get; set; }
Property Value
System.Drawing.ContentAlignment

TextImageRelation

Gets or sets the text-image relation for this RadListDataItem instance.

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

TextOrientation

Gets or sets the text orientation for this RadListDataItem instance.

Declaration
public Orientation TextOrientation { get; set; }
Property Value
System.Windows.Forms.Orientation

TextWrap

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

Value

Gets or sets a value for the property indicated by ValueMember if in bound mode, and private value in unbound mode. Trying to explicitly set this property in bound mode will result in an InvalidOperationException.

Declaration
public virtual object Value { get; set; }
Property Value
System.Object

VisualItem

Gets a value that visually represents this data item. If the item is not visible, this property returns null. The visual item returned should be used only to get information about a particular item. Since visual items are shared between different data items, properties must not be set directly on the visual item in order to avoid uncustomizable or unwanted behavior. For example if properties are set directly to the visual item the themes may not work correctly.

Declaration
public RadListVisualItem VisualItem { get; }
Property Value
RadListVisualItem

Methods

GetBoundValue()

Gets a value for the Value property while in bound mode.

Declaration
protected virtual object GetBoundValue()
Returns
System.Object

Gets an object reference pointing to the value of the Value property in bound mode.

GetUnboundValue()

Gets a value for the Value property in unbound mode.

Declaration
protected virtual object GetUnboundValue()
Returns
System.Object

Returns an object reference pointing to the value of the Value property in unbound mode.

IndexOf(String)

Declaration
public int IndexOf(string name)
Parameters
System.String name

Returns
System.Int32

Implements
IDataItem.IndexOf(String)

OnPropertyChanged(RadPropertyChangedEventArgs)

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

Overrides
RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)

SetDataBoundItem(Boolean, Object)

This method is used to assign the DataBoundItem property of this RadListDataItem. If a user attempts to set DataBoundItem while in bound mode, an exception should be thrown. In unbound mode this property can be set to any value and will not affect the behavior of this RadListDataItem.

Declaration
protected virtual void SetDataBoundItem(bool dataBinding, object value)
Parameters
System.Boolean dataBinding

A flag that indicates if the data bound item is being set from the data binding engine or by the user. true means it is being set by the data binding engine.

System.Object value

The value that will be assigned to the DataBoundItem property.

SetUnboundValue(Object)

This method is called when setting the Value property of a RadListDataItem when it is in unbound mode.

Declaration
protected virtual void SetUnboundValue(object value)
Parameters
System.Object value

The value to set the Value property to.

ToString()

Declaration
public override string ToString()
Returns
System.String

Overrides
System.Object.ToString()

Extension Methods

CommonExtensions.ClearIfNoBindingAndSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
CommonExtensions.SetIfDifferent(RadObject, RadProperty, Object)
CommonExtensions.ClearIfSet(RadObject, RadProperty)
CommonExtensions.IsLocalValueSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Install Now
  • Demos
  • Step-by-Step Tutorial
  • Sample Applications
  • SDK Samples
  • Visual Studio Extensions
Support Resources
  • Code Library
  • Knowledge Base
  • Videos
Community
  • Forums
  • Blogs
  • Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.