skip navigation
  • Product Bundles

    DevCraft

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

    • AI Coding Assistants
    • Embedded Reporting
    • Document Processing Libraries
    • SSO Account Sign-in

    Web

    Kendo UI UI for Angular UI for Vue UI for jQuery KendoReact UI for Blazor UI for ASP.NET Core UI for ASP.NET MVC UI for ASP.NET AJAX

    Mobile

    UI for .NET MAUI

    Document Management

    Telerik Document Processing

    Desktop

    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF

    Reporting

    Telerik Reporting Telerik Report Server

    Testing & Mocking

    Test Studio Telerik JustMock

    CMS

    Sitefinity

    AI Productivity Tools

    AI Coding Assistants

    UI/UX Tools

    ThemeBuilder Design System Kit Templates and Building Blocks

    Debugging

    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Everywhere Reporter FiddlerCore

    Free Tools

    KendoReact Free VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Support and Learning

    • Support and Learning Hub
    • First Steps
    • Docs
    • Demos
    • Virtual Classroom
    • Forums
    • Videos
    • Blogs
    • Accessibility
    • Submit a Ticket

    Productivity and Design Tools

    • Visual Studio Extensions
    • Visual Studio Templates
    • Embedded Reporting
  • Pricing
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Downloads
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class RadListView

Displays a flat collection of labeled items, each represented by a ListViewDataItem.

Inheritance
System.Object
RadControl
RadListView
FileBrowserListView
RadCardView
RadCheckedListBox
RadDiagramToolbox
StyleListView
SymbolsTable
Inherited Members
RadControl.isResizing2
RadControl.isDisposing2
RadControl.invalidResizeRect
RadControl.isAccessibilityRequested
RadControl.Dispose(Boolean)
RadControl.Construct()
RadControl.CreateBehavior()
RadControl.CreateRootElement()
RadControl.InitializeRootElement(RootRadElement)
RadControl.LoadElementTree()
RadControl.LoadElementTree(Size)
RadControl.SetIsInitializing(Boolean)
RadControl.ShouldSerializeBackColor()
RadControl.SetBackColorThemeOverrides()
RadControl.ResetBackColorThemeOverrides()
RadControl.ShouldSerializeForeColor()
RadControl.SetForeColorThemeOverrides()
RadControl.ResetForeColorThemeOverrides()
RadControl.ShouldSerializeFont()
RadControl.OnKeyUp(KeyEventArgs)
RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)
RadControl.OnClick(EventArgs)
RadControl.OnDoubleClick(EventArgs)
RadControl.OnMouseEnter(EventArgs)
RadControl.OnMouseLeave(EventArgs)
RadControl.OnMouseHover(EventArgs)
RadControl.OnMouseCaptureChanged(EventArgs)
RadControl.OnCreateControl()
RadControl.OnHandleDestroyed(EventArgs)
RadControl.OnParentChanged(EventArgs)
RadControl.OnVisibleChanged(EventArgs)
RadControl.OnFontChanged(EventArgs)
RadControl.OnForeColorChanged(EventArgs)
RadControl.OnBackColorChanged(EventArgs)
RadControl.OnEnabledChanged(EventArgs)
RadControl.OnBindingContextChanged(EventArgs)
RadControl.OnLocationChanged(EventArgs)
RadControl.OnPaddingChanged(EventArgs)
RadControl.OnRightToLeftChanged(EventArgs)
RadControl.OnPaint(PaintEventArgs)
RadControl.OnLayout(LayoutEventArgs)
RadControl.OnAutoSizeChanged(EventArgs)
RadControl.WndProc(Message)
RadControl.OnInvalidated(RadElement)
RadControl.OnCaptureLosing()
RadControl.OnThemeChanged()
RadControl.OnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadControl.OnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadControl.ProcessMnemonic(Char)
RadControl.ProcessFocusRequested(RadElement)
RadControl.ProcessCaptureChangeRequested(RadElement, Boolean)
RadControl.ProcessAutoSizeChanged(Boolean)
RadControl.CallOnMouseCaptureChanged(EventArgs)
RadControl.CallBaseOnGotFocus(EventArgs)
RadControl.CallBaseOnLostFocus(EventArgs)
RadControl.CallOnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadControl.CallOnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadControl.CallOnMouseUp(MouseEventArgs)
RadControl.CallOnMouseDown(MouseEventArgs)
RadControl.CallOnClick(EventArgs)
RadControl.CallOnDoubleClick(EventArgs)
RadControl.CallOnMouseEnter(EventArgs)
RadControl.CallOnMouseWheel(MouseEventArgs)
RadControl.CallOnMouseLeave(EventArgs)
RadControl.CallOnMouseMove(MouseEventArgs)
RadControl.CallOnMouseHover(EventArgs)
RadControl.CallOnPreviewKeyDown(PreviewKeyDownEventArgs)
RadControl.CallBaseOnKeyDown(KeyEventArgs)
RadControl.CallOnKeyDown(KeyEventArgs)
RadControl.CallBaseOnKeyPress(KeyPressEventArgs)
RadControl.CallOnKeyPress(KeyPressEventArgs)
RadControl.GetInputElement()
RadControl.CallBaseOnKeyUp(KeyEventArgs)
RadControl.CallOnKeyUp(KeyEventArgs)
RadControl.CallOnThemeNameChanged(ThemeNameChangedEventArgs)
RadControl.CallOnVisibleChanged(EventArgs)
RadControl.BeginInit()
RadControl.EndInit()
RadControl.OnNotifyPropertyChanged(String)
RadControl.IComponentTreeHandler.GetShowFocusCues()
RadControl.IComponentTreeHandler.CreateRootElement()
RadControl.IComponentTreeHandler.CreateChildItems(RadElement)
RadControl.IComponentTreeHandler.InitializeRootElement(RootRadElement)
RadControl.IComponentTreeHandler.InvalidateElement(RadElement)
RadControl.IComponentTreeHandler.InvalidateElement(RadElement, Rectangle)
RadControl.IComponentTreeHandler.InvalidateIfNotSuspended()
RadControl.IComponentTreeHandler.GetAmbientPropertyValue(RadProperty)
RadControl.IComponentTreeHandler.ControlThemeChangedCallback()
RadControl.IComponentTreeHandler.OnAmbientPropertyChanged(RadProperty)
RadControl.IComponentTreeHandler.OnFocusRequested(RadElement)
RadControl.IComponentTreeHandler.OnCaptureChangeRequested(RadElement, Boolean)
RadControl.IComponentTreeHandler.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)
RadControl.IComponentTreeHandler.CallOnThemeNameChanged(ThemeNameChangedEventArgs)
RadControl.IComponentTreeHandler.CallOnMouseCaptureChanged(EventArgs)
RadControl.IComponentTreeHandler.CallOnToolTipTextNeeded(Object, ToolTipTextNeededEventArgs)
RadControl.IComponentTreeHandler.CallOnScreenTipNeeded(Object, ScreenTipNeededEventArgs)
RadControl.GetPreferredSize(Size)
RadControl.SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)
RadControl.GetRootElementDesiredSize(Int32, Int32, Int32, Int32)
RadControl.OnZoomGesture(ZoomGestureEventArgs)
RadControl.OnRotateGesture(RotateGestureEventArgs)
RadControl.OnPanGesture(PanGestureEventArgs)
RadControl.OnTwoFingerTapGesture(GestureEventArgs)
RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)
RadControl.OnGesture(GestureEventArgs)
RadControl.ProcessGesture(Message)
RadControl.EnableGesture(GestureType)
RadControl.DisableGesture(GestureType)
RadControl.Refresh()
RadControl.SuspendUpdate()
RadControl.ResumeUpdate()
RadControl.ResumeUpdate(Boolean)
RadControl.InvokeLayoutCallback(LayoutCallback)
RadControl.RegisterHostedControl(RadHostItem)
RadControl.UnregisterHostedControl(RadHostItem, Boolean)
RadControl.ControlDefinesThemeForElement(RadElement)
RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)
RadControl.GetPlainText()
RadControl.CanEditUIElement(RadElement)
RadControl.GetChildAt(Int32)
RadControl.ShouldSerializeProperty(RadProperty)
RadControl.ShouldSerializeProperty(RadProperty, RadObject)
RadControl.ResetProperty(RadProperty, RadObject)
RadControl.GetControlDefaultSize()
RadControl.GetDpiScaledSize(Size)
RadControl.GetDpiScaledSize(SizeF)
RadControl.ProcessCodedUIMessage(IPCMessage)
RadControl.FindPropertyInChildren(RadControl, IPCMessage)
RadControl.CallAccessibilityNotifyClients(AccessibleEvents, Int32)
RadControl.IPCHost.ProcessMessage(IPCMessage)
RadControl.ScaleControl(SizeF, BoundsSpecified)
RadControl.PerformRadAutoScale(Nullable<BoundsSpecified>)
RadControl.SetRadAutoScale(Boolean)
RadControl.IComponentTreeHandler.get_Name()
RadControl.IComponentTreeHandler.set_Name(String)
RadControl.EnableDpiScaling
RadControl.EnableRadAutoScale
RadControl.EnableRadFormInitialDpiScaling
RadControl.EnableImageDpiScaling
RadControl.EnableSvgImages
RadControl.IsTrial
RadControl.IsLoaded
RadControl.LayoutManager
RadControl.ElementTree
RadControl.UseCompatibleTextRenderingDefaultValue
RadControl.Behavior
RadControl.RootElement
RadControl.Padding
RadControl.ThemeName
RadControl.EnableTheming
RadControl.ThemeClassName
RadControl.ImageList
RadControl.ImageScalingSize
RadControl.UseCompatibleTextRendering
RadControl.MaximumSize
RadControl.MinimumSize
RadControl.Focusable
RadControl.Site
RadControl.CausesValidation
RadControl.IsInitializing
RadControl.SmallImageList
RadControl.SmallImageScalingSize
RadControl.IsDesignMode
RadControl.IsDisplayed
RadControl.FocusedElement
RadControl.AllowShowFocusCues
RadControl.ShowItemToolTips
RadControl.CommandBindings
RadControl.EnableKeyMap
RadControl.Font
RadControl.ValidationCancel
RadControl.IComponentTreeHandler.IsDesignMode
RadControl.IComponentTreeHandler.ElementTree
RadControl.IComponentTreeHandler.Behavior
RadControl.IComponentTreeHandler.Initializing
RadControl.IComponentTreeHandler.ThemeClassName
RadControl.EnableGestures
RadControl.EnableAnalytics
RadControl.AnalyticsName
RadControl.EnableRadAccessibilityObjects
RadControl.AccessibilityRequested
RadControl.EnableCodedUITests
RadControl.EnableCodedUITestsDefaultValue
RadControl.EnableUIAutomation
RadControl.EnableUIAutomationDefaultValue
RadControl.IPCHost.Context
RadControl.ElementInvalidated
RadControl.ToolTipTextNeeded
RadControl.ScreenTipNeeded
RadControl.ThemeNameChanged
RadControl.Initialized
RadControl.PropertyChanged
RadControl.ZoomGesture
RadControl.RotateGesture
RadControl.PanGesture
RadControl.TwoFingerTapGesture
RadControl.PressAndTapGesture
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Data Controls")]
public class RadListView : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, IFilterable

Constructors

RadListView()

Initializes a new instance of the RadListView control with default settings and empty item collection.

Declaration
public RadListView()

Properties

ActiveEditor

Gets the currently active editor.

Declaration
public IInputEditor ActiveEditor { get; }
Property Value
IInputEditor

AllowArbitraryItemHeight

Gets or sets a value indicating whether the items can have different height.

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

AllowArbitraryItemWidth

Gets or sets a value indicating whether the items can have different width.

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

AllowColumnReorder

Gets or sets a value indicating whether users can reorder columns by dragging column headers in DetailsView mode.

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

AllowColumnResize

Gets or sets a value indicating whether users can resize column widths by dragging column borders in DetailsView mode.

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

AllowDragDrop

Gets or sets a value indicating whether users can reorder items by dragging them to different positions.

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

AllowEdit

Gets or sets value indicating whether editing is enabled.

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

AllowRemove

Gets or sets a value indicating whether users can remove selected items by pressing the Delete key.

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

AutoSize

Gets or sets whether the edit control is auto-sized

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

Overrides
RadControl.AutoSize

AutoSizeColumnsMode

Gets or sets a value indicating how column widths in DetailsView mode are determined.

Declaration
public ListViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }
Property Value
ListViewAutoSizeColumnsMode

BackColor

Gets or sets the background color of the RadListView.

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

Overrides
RadControl.BackColor

CaseSensitiveColumnNames

Gets or sets a value indicating whether column names which differ only in casing are treated as different columns.

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

CheckBoxesAlignment

Gets or sets the vertical alignment of checkboxes within each item when ShowCheckBoxes is enabled.

Declaration
public CheckBoxesAlignment CheckBoxesAlignment { get; set; }
Property Value
CheckBoxesAlignment

CheckBoxesPosition

Gets or sets the position of checkboxes relative to the item content when ShowCheckBoxes is enabled.

Declaration
public CheckBoxesPosition CheckBoxesPosition { get; set; }
Property Value
CheckBoxesPosition

CheckedItems

Gets a collection containing the checked items.

Declaration
public ListViewCheckedItemCollection CheckedItems { get; }
Property Value
ListViewCheckedItemCollection

CheckedMember

Gets or sets the checked member.

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

CheckOnClickMode

Gets or sets a value indicating the conditions under which an item's check state automatically changes when the item is clicked.

Declaration
public virtual CheckOnClickMode CheckOnClickMode { get; set; }
Property Value
CheckOnClickMode

Columns

Gets a collection of ListViewDetailColumn objects that define the columns displayed in DetailsView mode.

Declaration
public ListViewColumnCollection Columns { get; }
Property Value
ListViewColumnCollection

CurrentColumn

Gets or sets the current column in Details View.

Declaration
public ListViewDetailColumn CurrentColumn { get; set; }
Property Value
ListViewDetailColumn

CurrentItem

Gets or sets the current item.

Declaration
public ListViewDataItem CurrentItem { get; set; }
Property Value
ListViewDataItem

DataMember

Gets or sets the specific list or table within the data source that the RadListView should bind to when the data source contains multiple lists.

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

DataSource

Gets or sets the data source of a RadListView.

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

DefaultSize

Gets the default size for the RadListView.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

DisplayMember

Gets or sets the name of the data source property that provides the display text for each item when data binding is used.

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

EnableColumnSort

Gets or sets a value indicating whether clicking on column headers in DetailsView mode will sort the items by that column.

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

EnableCustomGrouping

Gets or sets a value indicating whether custom grouping is enabled.

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

EnableFiltering

Gets or sets a value indicating whether filtering is enabled.

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

EnableGrouping

Gets or sets a value indicating whether grouping is enabled.

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

EnableKineticScrolling

Gets or sets a value indicating whether kinetic scrolling is enabled for smooth touch-based scrolling. This is automatically disabled when lasso selection is enabled.

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

EnableLassoSelection

Gets or sets a value indicating whether users can select multiple items by dragging a selection rectangle around them.

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

EnableSorting

Gets or sets a value indicating whether sorting is enabled.

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

FilterDescriptors

Gets a collection of filter descriptors that define the filtering criteria applied to the ListView items.

Declaration
public ListViewFilterDescriptorCollection FilterDescriptors { get; }
Property Value
ListViewFilterDescriptorCollection

FilterPredicate

Gets or sets a custom predicate function used to filter items in the ListView based on complex criteria.

Declaration
public Predicate<ListViewDataItem> FilterPredicate { get; set; }
Property Value
System.Predicate<ListViewDataItem>

FindStringComparer

Gets or sets the string comparer used by the keyboard navigation functionality.

Declaration
public IFindStringComparer FindStringComparer { get; set; }
Property Value
IFindStringComparer

ForeColor

Gets or sets the foreground color of the RadListView.

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

Overrides
RadControl.ForeColor

FullRowSelect

Gets or sets a value indicating whether the entire row is highlighted when an item is selected in DetailsView mode, rather than just the first column.

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

GroupDescriptors

Gets a collection of group descriptors that define the grouping criteria applied to organize ListView items into groups.

Declaration
public GroupDescriptorCollection GroupDescriptors { get; }
Property Value
GroupDescriptorCollection

GroupIndent

Gets or sets the horizontal indentation applied to items when they are displayed within a group.

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

GroupItemSize

Gets or sets the default size for group header items when grouping is enabled.

Declaration
public virtual Size GroupItemSize { get; set; }
Property Value
System.Drawing.Size

Groups

Gets a collection containing all the groups that organize items in the RadListView when grouping is enabled.

Declaration
public virtual ListViewDataItemGroupCollection Groups { get; }
Property Value
ListViewDataItemGroupCollection

HeaderHeight

Gets or sets the height of the header in Details View.

Declaration
public virtual float HeaderHeight { get; set; }
Property Value
System.Single

HorizontalScrollState

Gets or sets the display behavior of the horizontal scrollbar, controlling when it appears and how it behaves.

Declaration
public ScrollState HorizontalScrollState { get; set; }
Property Value
ScrollState

HotTracking

Gets or sets a value indicating whether items should react on mouse hover.

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

IsDataBound

Gets a value indicating whether the RadListView is currently bound to a data source.

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

IsEditing

Indicates whether there is an active editor.

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

Items

Gets a collection of ListViewDataItem objects that represent all items displayed in the RadListView.

Declaration
public ListViewDataItemCollection Items { get; }
Property Value
ListViewDataItemCollection

ItemSize

Gets or sets the default size for items when they are displayed in the ListView.

Declaration
public virtual Size ItemSize { get; set; }
Property Value
System.Drawing.Size

ItemSpacing

Gets or sets the amount of spacing in pixels between adjacent items in the ListView.

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

KeyboardSearchEnabled

Gets or sets a value indicating whether users can search for items by typing characters when the RadListView has focus.

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

KeyboardSearchResetInterval

Gets or sets a value that specifies how long the user must wait before searching with the keyboard is reset.

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

ListViewElement

Gets the underlying RadListViewElement that provides the core functionality and visual representation of the ListView.

Declaration
public RadListViewElement ListViewElement { get; }
Property Value
RadListViewElement

MultiSelect

Gets or sets value indicating whether multi selection is enabled.

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

SelectedIndex

Gets or sets the index of the selected item.

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

SelectedItem

Gets or sets the selected item.

Declaration
public ListViewDataItem SelectedItem { get; set; }
Property Value
ListViewDataItem

SelectedItems

Gets a collection containing the selected items.

Declaration
public ListViewSelectedItemCollection SelectedItems { get; }
Property Value
ListViewSelectedItemCollection

SelectLastAddedItem

Gets or sets a value indicating whether the most recently added item to the data source should be automatically selected.

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

ShowCheckBoxes

Gets or sets a value indicating whether checkboxes are displayed next to each item for selection purposes.

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

ShowColumnHeaders

Gets or sets a value indicating whether column headers are visible in DetailsView mode.

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

ShowGridLines

Gets or sets a value indicating whether grid lines are displayed between items and columns in DetailsView mode.

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

ShowGroups

Gets or sets a value indicating whether items are organized and displayed within their respective groups.

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

SortDescriptors

Gets a collection of sort descriptors that define the sorting criteria and order applied to the ListView items.

Declaration
public SortDescriptorCollection SortDescriptors { get; }
Property Value
SortDescriptorCollection

Text

This property is not relevant for RadListView and should not be used.

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

Overrides
RadControl.Text

ThreeStateMode

Gets or sets a value indicating whether checkboxes support three states: checked, unchecked, and indeterminate.

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

ValueMember

Gets or sets the name of the data source property that provides the value for each item when data binding is used.

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

VerticalScrollState

Gets or sets the display behavior of the vertical scrollbar, controlling when it appears and how it behaves.

Declaration
public ScrollState VerticalScrollState { get; set; }
Property Value
ScrollState

ViewType

Gets or sets the view mode that determines how items are displayed, such as ListView, DetailsView, IconView.

Declaration
public virtual ListViewType ViewType { get; set; }
Property Value
ListViewType

Methods

BeginEdit()

Begins an edit operation over the currently selected item.

Declaration
public bool BeginEdit()
Returns
System.Boolean

True if editing was successfully started; false if editing could not be initiated

BeginUpdate()

Suspend any item change notifications until RadListView.EndUpdate is called.

Declaration
public void BeginUpdate()

CancelEdit()

Ends the current edit operations if such. Discards the changes.

Declaration
public bool CancelEdit()
Returns
System.Boolean

True if editing was successfully canceled; false otherwise

CanEditElementAtDesignTime(RadElement)

Determines whether the specified RadElement can be edited at design time in the Visual Studio designer.

Declaration
protected override bool CanEditElementAtDesignTime(RadElement element)
Parameters
RadElement element

The RadElement to check for design-time editability

Returns
System.Boolean

True if the element can be edited at design time; otherwise, false

Overrides
RadControl.CanEditElementAtDesignTime(RadElement)

CheckAllItems()

Checks all of the items.

Declaration
public void CheckAllItems()

CheckSelectedItems()

Checks the selected items.

Declaration
public void CheckSelectedItems()

CollapseAll()

Collapses all the groups in the control.

Declaration
public void CollapseAll()

CreateAccessibilityInstance()

Creates and returns the accessibility object that provides information to assistive technology applications.

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

An AccessibleObject that represents the RadListView for accessibility purposes

CreateChildItems(RadElement)

Creates the child elements of the RadListView control, including the main list view element.

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

The parent RadElement that will contain the child elements

Overrides
RadControl.CreateChildItems(RadElement)

CreateListViewElement()

Creates and returns a new instance of the RadListViewElement that provides the core functionality for the control.

Declaration
protected virtual RadListViewElement CreateListViewElement()
Returns
RadListViewElement

A new RadListViewElement instance

EndEdit()

Ends the current edit operations if such. Saves the changes.

Declaration
public bool EndEdit()
Returns
System.Boolean

True if editing was successfully completed and changes were saved; false otherwise

EndUpdate()

Resumes the item change notifications.

Declaration
public void EndUpdate()

ExpandAll()

Expands all the groups in the control.

Declaration
public void ExpandAll()

FindItemByKey(Object)

Finds an item with the specified key.

Declaration
public ListViewDataItem FindItemByKey(object key)
Parameters
System.Object key

The key value to search for among the items

Returns
ListViewDataItem

The first ListViewDataItem with the specified key, or null if no matching item is found

FindItemByKey(Object, Boolean)

Finds an item with the specified key.

Declaration
public ListViewDataItem FindItemByKey(object key, bool searchVisibleItems)
Parameters
System.Object key

The key value to search for among the items

System.Boolean searchVisibleItems

True to search only currently visible items; false to search all items

Returns
ListViewDataItem

The first ListViewDataItem with the specified key, or null if no matching item is found

IsInputKey(Keys)

Determines whether the specified key should be treated as an input key for navigation and selection.

Declaration
protected override bool IsInputKey(Keys keyData)
Parameters
System.Windows.Forms.Keys keyData

The key data to examine

Returns
System.Boolean

True if the key should be treated as an input key; otherwise, false

Overrides
RadControl.IsInputKey(Keys)

OnGotFocus(EventArgs)

Handles the GotFocus event and performs initialization operations when the control receives input focus.

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

Event arguments containing information about the focus change

Overrides
RadControl.OnGotFocus(EventArgs)

OnKeyDown(KeyEventArgs)

Handles key press events and delegates processing to the list view element for navigation and selection.

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

Key event arguments containing information about the key press

Overrides
RadControl.OnKeyDown(KeyEventArgs)

OnKeyPress(KeyPressEventArgs)

Handles character input events and delegates processing to the list view element for keyboard search functionality.

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

Key press event arguments containing information about the character input

Overrides
RadControl.OnKeyPress(KeyPressEventArgs)

OnLoad(Size)

Called when the control is loaded.

Declaration
protected override void OnLoad(Size desiredSize)
Parameters
System.Drawing.Size desiredSize

The desired size for the control

Overrides
RadControl.OnLoad(Size)

OnLostFocus(EventArgs)

Handles the LostFocus event and performs cleanup operations when the control loses input focus.

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

Event arguments containing information about the focus change

Overrides
RadControl.OnLostFocus(EventArgs)

OnMouseDown(MouseEventArgs)

Handles mouse button press events and delegates processing to the list view element.

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

Mouse event arguments containing information about the button press

Overrides
RadControl.OnMouseDown(MouseEventArgs)

OnMouseMove(MouseEventArgs)

Handles mouse movement events and delegates processing to the list view element for hit testing and hover effects.

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

Mouse event arguments containing information about the mouse movement

Overrides
RadControl.OnMouseMove(MouseEventArgs)

OnMouseUp(MouseEventArgs)

Handles mouse button release events and delegates processing to the list view element.

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

Mouse event arguments containing information about the button release

Overrides
RadControl.OnMouseUp(MouseEventArgs)

OnMouseWheel(MouseEventArgs)

Handles mouse wheel events and delegates processing to the list view element for scrolling functionality.

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

Mouse event arguments containing information about the mouse wheel operation

Overrides
RadControl.OnMouseWheel(MouseEventArgs)

OnNotifyPropertyChanged(PropertyChangedEventArgs)

Handles property change notifications and performs special processing for filter predicate changes in custom grouping scenarios.

Declaration
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)
Parameters
System.ComponentModel.PropertyChangedEventArgs e

Property change event arguments containing the name of the property that changed

Overrides
RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)

OnThemeNameChanged(ThemeNameChangedEventArgs)

Handles theme name changes and performs necessary cleanup and reinitialization of visual elements.

Declaration
protected override void OnThemeNameChanged(ThemeNameChangedEventArgs e)
Parameters
ThemeNameChangedEventArgs e

Event arguments containing information about the theme change

Overrides
RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)

RadListView_Initialized(Object, EventArgs)

Handles the initialization completion event and applies any property values that were set during the initialization phase.

Declaration
protected virtual void RadListView_Initialized(object sender, EventArgs e)
Parameters
System.Object sender

The object that raised the event

System.EventArgs e

Event arguments containing information about the initialization completion

Select(ListViewDataItem[])

Selects a set of items.

Declaration
public void Select(ListViewDataItem[] items)
Parameters
ListViewDataItem[] items

An array of ListViewDataItem objects to select

UncheckAllItems()

Unchecks all of the items.

Declaration
public void UncheckAllItems()

UncheckSelectedItems()

Unchecks the selected items.

Declaration
public void UncheckSelectedItems()

Events

BindingCompleted

Occurs when the process of binding the RadListViewElement to a data source has finished successfully.

Declaration
public event EventHandler BindingCompleted
Event Type
System.EventHandler

BindingContextChanged

Occurs when the binding context for the RadListView has changed, typically during data binding operations.

Declaration
public event EventHandler BindingContextChanged
Event Type
System.EventHandler

CellCreating

Occurs when a new DetailListViewCellElement needs to be created for displaying cell content in DetailsView mode.

Declaration
public virtual event ListViewCellElementCreatingEventHandler CellCreating
Event Type
ListViewCellElementCreatingEventHandler

CellFormatting

Occurs when a cell in DetailsView mode needs to be formatted, allowing custom appearance to be applied.

Declaration
public virtual event ListViewCellFormattingEventHandler CellFormatting
Event Type
ListViewCellFormattingEventHandler

ColumnCreating

Occurs when a new ListViewDetailColumn needs to be created for DetailsView mode.

Declaration
public event ListViewColumnCreatingEventHandler ColumnCreating
Event Type
ListViewColumnCreatingEventHandler

CurrentItemChanged

Occurs when the CurrentItem property has been changed to point to a different item.

Declaration
public event ListViewItemEventHandler CurrentItemChanged
Event Type
ListViewItemEventHandler

CurrentItemChanging

Occurs when the CurrentItem property is about to change to a different item. This event is cancelable.

Declaration
public event ListViewItemChangingEventHandler CurrentItemChanging
Event Type
ListViewItemChangingEventHandler

EditorInitialized

Occurs when an editor control has been initialized and is ready for user input.

Declaration
public event ListViewItemEditorInitializedEventHandler EditorInitialized
Event Type
ListViewItemEditorInitializedEventHandler

EditorRequired

Occurs when an editor control is required for in-place editing of an item's value.

Declaration
public event ListViewItemEditorRequiredEventHandler EditorRequired
Event Type
ListViewItemEditorRequiredEventHandler

GroupExpanded

Occurs when a group has been expanded and is now displaying its child items.

Declaration
public event EventHandler<ListViewGroupEventArgs> GroupExpanded
Event Type
System.EventHandler<ListViewGroupEventArgs>

GroupExpanding

Occurs when a group is about to expand and display its child items. This event is cancelable.

Declaration
public event EventHandler<ListViewGroupCancelEventArgs> GroupExpanding
Event Type
System.EventHandler<ListViewGroupCancelEventArgs>

ItemCheckedChanged

Occurs when a ListViewDataItem has had its checked state changed successfully.

Declaration
public event ListViewItemEventHandler ItemCheckedChanged
Event Type
ListViewItemEventHandler

ItemCheckedChanging

Occurs when a ListViewDataItem is about to have its checked state changed. This event is cancelable.

Declaration
public event ListViewItemCancelEventHandler ItemCheckedChanging
Event Type
ListViewItemCancelEventHandler

ItemCreating

Occurs when a new ListViewDataItem needs to be created, allowing custom item types to be provided.

Declaration
public event ListViewItemCreatingEventHandler ItemCreating
Event Type
ListViewItemCreatingEventHandler

ItemDataBound

Occurs when a data-bound object is being attached to a ListViewDataItem during the data binding process.

Declaration
public event ListViewItemEventHandler ItemDataBound
Event Type
ListViewItemEventHandler

ItemEdited

Occurs when a ListViewDataItem has been successfully edited and the changes have been committed.

Declaration
public event ListViewItemEditedEventHandler ItemEdited
Event Type
ListViewItemEditedEventHandler

ItemEditing

Occurs when an edit operation is about to begin on an item. This event is cancelable.

Declaration
public event ListViewItemEditingEventHandler ItemEditing
Event Type
ListViewItemEditingEventHandler

ItemMouseClick

Occurs when the user single-clicks on a ListViewDataItem with any mouse button.

Declaration
public event ListViewItemEventHandler ItemMouseClick
Event Type
ListViewItemEventHandler

ItemMouseDoubleClick

Occurs when the user double-clicks on a ListViewDataItem with the primary mouse button.

Declaration
public event ListViewItemEventHandler ItemMouseDoubleClick
Event Type
ListViewItemEventHandler

ItemMouseDown

Occurs when the user presses a mouse button while the mouse pointer is positioned over a ListViewDataItem.

Declaration
public event ListViewItemMouseEventHandler ItemMouseDown
Event Type
ListViewItemMouseEventHandler

ItemMouseEnter

Occurs when the mouse pointer enters the boundaries of a ListViewDataItem.

Declaration
public event ListViewItemEventHandler ItemMouseEnter
Event Type
ListViewItemEventHandler

ItemMouseHover

Occurs when the user pauses the mouse pointer over a ListViewDataItem for a predefined period of time.

Declaration
public event ListViewItemEventHandler ItemMouseHover
Event Type
ListViewItemEventHandler

ItemMouseLeave

Occurs when the mouse pointer leaves the boundaries of a ListViewDataItem.

Declaration
public event ListViewItemEventHandler ItemMouseLeave
Event Type
ListViewItemEventHandler

ItemMouseMove

Occurs when the user moves the mouse pointer while it is positioned over a ListViewDataItem.

Declaration
public event ListViewItemMouseEventHandler ItemMouseMove
Event Type
ListViewItemMouseEventHandler

ItemMouseUp

Occurs when the user releases a mouse button while the mouse pointer is positioned over a ListViewDataItem.

Declaration
public event ListViewItemMouseEventHandler ItemMouseUp
Event Type
ListViewItemMouseEventHandler

ItemRemoved

Occurs when an item has been successfully removed from the collection using the Delete key.

Declaration
public event ListViewItemEventHandler ItemRemoved
Event Type
ListViewItemEventHandler

ItemRemoving

Occurs when an item is about to be removed from the collection using the Delete key. This event is cancelable.

Declaration
public event ListViewItemCancelEventHandler ItemRemoving
Event Type
ListViewItemCancelEventHandler

ItemValidating

Occurs when an edit operation needs to be validated.

Declaration
public event ListViewItemValidatingEventHandler ItemValidating
Event Type
ListViewItemValidatingEventHandler

ItemValueChanged

Occurs when the value of a ListViewDataItem has been successfully changed.

Declaration
public event ListViewItemValueChangedEventHandler ItemValueChanged
Event Type
ListViewItemValueChangedEventHandler

ItemValueChanging

Occurs when the value of a ListViewDataItem is about to change. This event is cancelable.

Declaration
public event ListViewItemValueChangingEventHandler ItemValueChanging
Event Type
ListViewItemValueChangingEventHandler

SelectedIndexChanged

Occurs when the selected item has changed.

Declaration
public event EventHandler SelectedIndexChanged
Event Type
System.EventHandler

SelectedItemChanged

Occurs when the selected item has changed.

Declaration
public event EventHandler SelectedItemChanged
Event Type
System.EventHandler

SelectedItemChanging

Occurs when a ListViewDataItem is about to be selected, allowing the selection operation to be canceled.

Declaration
public event ListViewItemCancelEventHandler SelectedItemChanging
Event Type
ListViewItemCancelEventHandler

SelectedItemsChanged

Occurs when the content of the SelectedItems collection has changed due to items being added or removed from the selection.

Declaration
public event EventHandler SelectedItemsChanged
Event Type
System.EventHandler

ValidationError

Occurs when a validation error is encountered during an edit operation or data binding.

Declaration
public event EventHandler ValidationError
Event Type
System.EventHandler

ViewTypeChanged

Occurs when the ViewType of the RadListView has changed to a different view mode such as ListView or DetailsView.

Declaration
public virtual event EventHandler ViewTypeChanged
Event Type
System.EventHandler

ViewTypeChanging

Occurs when the ViewType of the RadListView is about to change to a different view mode. This event is cancelable.

Declaration
public virtual event ViewTypeChangingEventHandler ViewTypeChanging
Event Type
ViewTypeChangingEventHandler

VisualItemCreating

Occurs when a new BaseListViewVisualItem needs to be created for visual representation of data items.

Declaration
public event ListViewVisualItemCreatingEventHandler VisualItemCreating
Event Type
ListViewVisualItemCreatingEventHandler

VisualItemFormatting

Occurs when a ListViewDataItem changes its visual state and requires custom formatting to be applied.

Declaration
public event ListViewVisualItemEventHandler VisualItemFormatting
Event Type
ListViewVisualItemEventHandler

Explicit Interface Implementations

IFilterable.DataSource

Gets the data source object used for filtering operations when the control implements the IFilterable interface.

Declaration
object IFilterable.DataSource { get; }
Returns
System.Object

Implements
IFilterable.DataSource

IFilterable.FilterDescriptors

Gets the filter descriptors collection used for filtering operations when the control implements the IFilterable interface.

Declaration
FilterDescriptorCollection IFilterable.FilterDescriptors { get; }
Returns
FilterDescriptorCollection

Implements
IFilterable.FilterDescriptors

Extension Methods

SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)
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.