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

Represents a list control that displays data in a list layout similar to the standard ListBox control, providing advanced features such as data binding, virtualization, and custom item rendering.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[TelerikToolboxCategory("Data Controls")]
[ComplexBindingProperties("DataSource", "ValueMember")]
[LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "SelectedValue")]
[ClassInterface(ClassInterfaceType.AutoDispatch)]
[ComVisible(true)]
public class RadListControl : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadListControl...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetBackColorThemeOverrides()RadControl.ResetBackColorThemeOverrides()RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnKeyPress(KeyPressEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnLostFocus(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.OnInvalidated(RadElement)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.GetInputElement()RadControl.BeginInit()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)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(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

Initializes a new instance of the RadListControl class with default settings.

C#
public RadListControl()

Fields

Identifies handlers registered for the CreatingVisualListItem event.

C#
public static readonly object CreatingVisualListItemEventKey

Identifies handlers registered for the ListItemDataBinding event.

C#
public static readonly object ListItemDataBindingEventKey

Identifies handlers registered for the ListItemDataBound event.

C#
public static readonly object ListItemDataBoundEventKey

Identifies handlers registered for the SelectedIndexChanged event in the control's event list.

C#
public static readonly object SelectedIndexChangedEventKey

Identifies handlers registered for the cancelable SelectedIndexChanging event.

C#
public static readonly object SelectedIndexChangingEventKey

Identifies handlers registered for the SelectedValueChanged event.

C#
public static readonly object SelectedValueChangedEventKey

Identifies handlers registered for the SortStyleChanged event.

C#
public static readonly object SortStyleChangedEventKey

Identifies handlers registered for the VisualItemFormatting event.

C#
public static readonly object VisualItemFormattingEventKey

Properties

Gets or sets the active item that receives focus for keyboard navigation in multi-selection modes.

C#
[Browsable(false)]
public RadListDataItem ActiveItem { get; set; }

Gets or sets a value indicating whether users can reorder items using drag and drop operations.

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

Gets or sets a value that indicates whether items will be sized according to their content. If this property is true the user can set the Height property of each individual RadListDataItem in the Items collection in order to override the automatic sizing.

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

Gets or sets a value indicating whether text case sensitivity is considered during sorting operations.

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

Gets or sets the name of the data member to bind to when the DataSource contains multiple tables or lists.

C#
[Browsable(true)]
public string DataMember { get; set; }

Gets or sets the data source that provides the items to be displayed in the RadListControl.

C#
[Browsable(true)]
public object DataSource { get; set; }

Gets the default control size used when no size has been specified.

C#
protected override Size DefaultSize { get; }
Property Value:

A size of 120 by 95 pixels.

Overrides: Control.DefaultSize

Gets or sets the property name used to extract description text from data items for additional item information display.

C#
[Browsable(true)]
public string DescriptionTextMember { get; set; }

Gets or sets the property name used to extract display text from data items for visual representation in the list.

C#
[TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[Browsable(true)]
public string DisplayMember { get; set; }

Gets or sets a value indicating whether alternating background colors are applied to list items for improved readability.

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

Gets or sets a value indicating whether kinetic scrolling is enabled for smooth touch-based scrolling interactions.

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

Gets or sets whether UI Automation is enabled for the control. Changing the value notifies the UI Automation manager.

C#
public override bool EnableUIAutomation { get; set; }

Overrides: RadControl.EnableUIAutomation

Implements: ISupportRootUIAutomation.EnableUIAutomation

Gets or sets a predicate which filters which items can be visible.

C#
[Browsable(false)]
public Predicate<RadListDataItem> Filter { get; set; }

Gets or sets a filter expression string that determines which items are visible in the list based on the specified criteria.

C#
[Browsable(true)]
public string FilterExpression { get; set; }

Gets or sets an implementation of IFindStringComparer used for customizing string comparison behavior in the FindString method.

C#
[Browsable(false)]
public IFindStringComparer FindStringComparer { get; set; }

Gets or sets a value indicating whether items are automatically resized to fit the control's width.

C#
public bool FitItemsToSize { get; set; }

Gets or sets a format string which will be used for visual formatting of the items text.

C#
[Browsable(true)]
public string FormatString { get; set; }

Gets or sets a value that indicates whether the FormatString and FormatInfo properties will be used to format the items text. Setting this property to false may improve performance.

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

Gets a value indicating whether any filtering is currently active, either through a Filter delegate or FilterExpression.

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

Gets or sets the height of individual list items in pixels.

C#
[Browsable(true)]
public int ItemHeight { get; set; }

Gets the collection of data items contained in the RadListControl. Items cannot be modified in data bound mode.

C#
[Browsable(true)]
public RadListDataItemCollection Items { get; }

Gets or sets the text comparison mode that determines whether the FindString method searches using user-specified text or data-bound text from the DisplayMember.

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

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

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

Gets or sets the time interval in milliseconds that the user must wait before the keyboard search functionality is reset.

C#
[Browsable(true)]
public int KeyboardSearchResetInterval { get; set; }

Gets the main element that provides the list functionality and serves as the core component of the RadListControl.

C#
[Browsable(false)]
public RadListElement ListElement { get; set; }

Gets or set the scroll mode.

C#
[Browsable(true)]
public ItemScrollerScrollModes ScrollMode { get; set; }

Gets or sets the currently selected index.

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

Gets or sets the currently selected item.

C#
[Browsable(false)]
[Bindable(true)]
public RadListDataItem SelectedItem { get; set; }

Gets a read-only collection of the currently selected items in the RadListControl.

C#
[Browsable(false)]
public IReadOnlyCollection<RadListDataItem> SelectedItems { get; }

Gets or sets the value of the currently selected item based on the ValueMember property.

C#
[Browsable(false)]
[Bindable(true)]
public object SelectedValue { get; set; }

Gets or sets the selection mode that determines how items can be selected in the RadListControl.

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

Gets or sets the sorting behavior applied to the list items.

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

Gets or sets a value indicating whether the ItemsChanging and ItemsChanged events are temporarily suspended from firing.

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

Gets or sets a value that determines whether to stop the selection events from firing. These are SelectedIndexChanged, SelectedIndexChanging and SelectedValueChanged.

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

Gets or sets the property name used to extract values from data items, which will be accessible through the Value property of each RadListDataItem.

C#
[Browsable(true)]
public string ValueMember { get; set; }

Methods

Suspends internal notifications and processing to improve performance during bulk operations. This method is cumulative, requiring matching calls to EndUpdate().

C#
public void BeginUpdate()

Prevents list visual items from being edited directly in the designer.

C#
protected override bool CanEditElementAtDesignTime(RadElement element)
Parameters:elementRadElement

The element the designer is attempting to edit.

Returns:

bool

false for a RadListVisualItem; otherwise, the base implementation's result.

Overrides: RadControl.CanEditElementAtDesignTime(RadElement)

Clears cached measured sizes so list items are measured again during layout.

C#
protected virtual void ClearMeasuredSize()

Creates the list's accessible object when Rad accessibility is enabled, otherwise uses the base implementation.

C#
protected override AccessibleObject CreateAccessibilityInstance()
Returns:

AccessibleObject

The accessible object for this control.

Overrides: Control.CreateAccessibilityInstance()

Creates the child elements for the RadListControl.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent element that will contain the child elements.

Overrides: RadControl.CreateChildItems(RadElement)

Creates and returns a new instance of the RadListElement that provides the core list functionality.

C#
protected virtual RadListElement CreateListElement()
Returns:

RadListElement

A new RadListElement instance.

Creates a disposable object that defers refresh operations until disposed, allowing multiple changes to be batched together.

C#
public virtual IDisposable DeferRefresh()
Returns:

IDisposable

An IDisposable object that resumes refresh operations when disposed.

Releases the UI Automation provider and disconnects from the list element before disposing the control.

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

true to release managed and unmanaged resources; false to release only unmanaged resources.

Overrides: RadControl.Dispose(bool)

Completes initialization and synchronizes items already marked selected with the list element's selection collection.

C#
public override void EndInit()

Overrides: RadControl.EndInit()

Resumes internal notifications and processing previously suspended by BeginUpdate().

C#
public void EndUpdate()
C#
public RadListDataItem FindItemExact(string text, bool caseSensitive)
Parameters:textstringcaseSensitiveboolReturns:

RadListDataItem

Searches for an item that matches the specified string using the configured FindStringComparer, starting from the specified index.

C#
public int FindString(string s, int startIndex)
Parameters:sstring

The string to search for.

startIndexint

The index to start searching from.

Returns:

int

The index of the first matching item, or -1 if no match is found.

Searches for an item that matches the specified string using the configured FindStringComparer, starting from the beginning of the list.

C#
public int FindString(string s)
Parameters:sstring

The string to search for.

Returns:

int

The index of the first matching item, or -1 if no match is found.

Searches for an item with text that exactly matches the specified string, starting from the specified index.

C#
public int FindStringExact(string s, int startIndex)
Parameters:sstring

The string to match exactly.

startIndexint

The index to start searching from.

Returns:

int

The index of the matching item, or -1 if no exact match is found.

Searches for an item with text that exactly matches the specified string, starting from the beginning of the list.

C#
public int FindStringExact(string s)
Parameters:sstring

The string to match exactly.

Returns:

int

The index of the matching item, or -1 if no exact match is found.

Searches for an item in the same manner as FindString() but does not start from the beginning when the end of the Items collection is reached.

C#
public int FindStringNonWrapping(string s, int startIndex)
Parameters:sstring

The string that will be used to search for an item.

startIndexint

The index from which to start searching.

Returns:

int

The index of the found item or -1 if no item is found.

Searches for an item in the same manner as FindString() but does not start from the beginning when the end of the Items collection is reached.

C#
public int FindStringNonWrapping(string s)
Parameters:sstring

The string that will be used to search for an item.

Returns:

int

The index of the found item or -1 if no item is found.

Selects the last item in the current item sequence.

C#
protected virtual void HandleEndKey()

Selects the first item in the current item sequence.

C#
protected virtual void HandleHomeKey()

Scrolls the list down by one page.

C#
protected virtual void HandlePageDownKey()

Scrolls the list up by one page.

C#
protected virtual void HandlePageUpKey()

Treats letters and digits as input characters so they do not activate mnemonics.

C#
protected override bool IsInputChar(char charCode)
Parameters:charCodechar

The character being processed.

Returns:

bool

true if the base control treats it as input or it is a letter or digit; otherwise, false.

Overrides: Control.IsInputChar(char)

Reserves the arrow keys for list navigation.

C#
protected override bool IsInputKey(Keys keyData)
Parameters:keyDataKeys

The key and any modifier flags being processed.

Returns:

bool

true for arrow keys or keys accepted by the base control; otherwise, false.

Overrides: RadControl.IsInputKey(Keys)

Raises the event that allows handlers to replace the visual item created for a data item.

C#
protected virtual void OnCreatingVisualItem(object sender, CreatingVisualListItemEventArgs args)
Parameters:senderobject

The list element creating the visual item.

argsCreatingVisualListItemEventArgs

The event data containing the data item and replaceable visual item.

Raises the DataBindingComplete event.

C#
protected virtual void OnDataBindingComplete(object sender, ListBindingCompleteEventArgs e)
Parameters:senderobjecteListBindingCompleteEventArgs

An ListBindingCompleteEventArgs instance that contains the event data.

Notifies the UI Automation provider when the control's enabled state changes.

C#
protected override void OnEnabledChanged(EventArgs e)
Parameters:eEventArgs

The event data.

Overrides: RadControl.OnEnabledChanged(EventArgs)

Focuses the list element and raises a UI Automation focus event when UI Automation requests are enabled.

C#
protected override void OnGotFocus(EventArgs e)
Parameters:eEventArgs

The focus event data.

Overrides: RadControl.OnGotFocus(EventArgs)

Raises the event that lets handlers supply a custom data item before a bound row is initialized.

C#
protected virtual void OnItemDataBinding(object sender, ListItemDataBindingEventArgs args)
Parameters:senderobject

The list element processing the bound row.

argsListItemDataBindingEventArgs

The event data, including the optional replacement item.

Raises the event after a data item has been associated with a bound data record.

C#
protected virtual void OnItemDataBound(object sender, ListItemDataBoundEventArgs args)
Parameters:senderobject

The list element that completed binding the row.

argsListItemDataBoundEventArgs

The event data containing the bound item.

Routes Page Up, Page Down, Home, and End keys to the list's navigation handlers.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

The key event data.

Overrides: RadControl.OnKeyDown(KeyEventArgs)

Enables pan gestures after the control has loaded.

C#
protected override void OnLoad(Size desiredSize)
Parameters:desiredSizeSize

The size requested for the loaded control.

Overrides: RadControl.OnLoad(Size)

Gives the list element first opportunity to process a mouse-down event before calling the base implementation.

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

The mouse event data.

Overrides: RadControl.OnMouseDown(MouseEventArgs)

Gives the list element first opportunity to process a mouse-move event before calling the base implementation.

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

The mouse event data.

Overrides: RadControl.OnMouseMove(MouseEventArgs)

Gives the list element first opportunity to process a mouse-up event before calling the base implementation.

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

The mouse event data.

Overrides: RadControl.OnMouseUp(MouseEventArgs)

Forwards the wheel delta to the list element and marks handled mouse events as handled.

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

The mouse-wheel event data.

Overrides: RadControl.OnMouseWheel(MouseEventArgs)

Raises the selection-changed event with the new selected index.

C#
protected virtual void OnSelectedIndexChanged(object sender, int newIndex)
Parameters:senderobject

The element that initiated the selection change.

newIndexint

The new selected index.

Raises the cancelable selection-changing event and reports whether the change was canceled.

C#
protected virtual bool OnSelectedIndexChanging(object sender, int newIndex)
Parameters:senderobject

The element that requested the selection change.

newIndexint

The index requested for selection.

Returns:

bool

true if an event handler cancels the change; otherwise, false.

Raises the selected-value event with the new index and old and new values.

C#
protected virtual void OnSelectedValueChanged(object sender, int newIndex, object newValue, object oldValue)
Parameters:senderobject

The element that initiated the value change.

newIndexint

The selected index associated with the new value.

newValueobject

The new selected value.

oldValueobject

The previous selected value.

Raises the event after the list's sort style changes.

C#
protected virtual void OnSortStyleChanged(object sender, SortStyleChangedEventArgs args)
Parameters:senderobject

The list element whose sort style changed.

argsSortStyleChangedEventArgs

The event data containing the new sort style.

Raises the event that lets handlers customize a realized visual list item.

C#
protected virtual void OnVisualItemFormatting(object sender, VisualItemFormattingEventArgs args)
Parameters:senderobject

The list element that owns the visual item.

argsVisualItemFormattingEventArgs

The event data containing the visual item to customize.

Handles coded UI property requests for item count, selection, multiple-selection mode, and data source.

C#
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters:requestIPCMessage

The coded UI message to process or pass to the base implementation.

Overrides: RadControl.ProcessCodedUIMessage(ref IPCMessage)

Forces re-evaluation of the current data source (if any).

C#
public void Rebind()

Scrolls the view by the specified number of pages.

C#
public void ScrollByPage(int pageCount)
Parameters:pageCountint

The number of pages to scroll. Positive values scroll down, negative values scroll up.

Scrolls the view to make the specified item visible, positioning it appropriately within the visible area.

C#
public void ScrollToItem(RadListDataItem item)
Parameters:itemRadListDataItem

The RadListDataItem to scroll to.

Selects all items in the list if the current SelectionMode allows multiple selection.

C#
public void SelectAll()
Exceptions: InvalidOperationException

Thrown when SelectionMode is One or None.

Clears current selection and selects all items within the specified index range.

C#
public void SelectRange(int startIndex, int endIndex)
Parameters:startIndexint

The starting index of the range to select.

endIndexint

The ending index of the range to select (inclusive).

Unsubscribes from the relevant events of the underlying RadListElement.

C#
protected virtual void UnwireEvents()

Subscribes to the relevant events of the underlying RadListElement.

C#
protected virtual void WireEvents()

Handles UI Automation provider requests and releases the provider when the control is destroyed.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

The Windows message to process.

Overrides: RadControl.WndProc(ref Message)

Events

Occurs when custom visual items need to be created, allowing users to provide custom visual representations for list items.

C#
public event CreatingVisualListItemEventHandler CreatingVisualListItem

Fires after data binding operation has finished.

C#
[Browsable(true)]
public event ListBindingCompleteEventHandler DataBindingComplete

Occurs before a RadListDataItem is data bound, allowing customization of the data binding process and providing custom item instances.

C#
public event ListItemDataBindingEventHandler ItemDataBinding

Occurs after a RadListDataItem has been data bound, providing an opportunity to modify the bound item.

C#
public event ListItemDataBoundEventHandler ItemDataBound

This event fires when the selected index property changes.

C#
public event PositionChangedEventHandler SelectedIndexChanged

This event fires before SelectedIndex changes. This event allows the operation to be cancelled.

C#
public event PositionChangingEventHandler SelectedIndexChanging

Occurs when the SelectedItems collection changes due to selection modifications.

C#
public event NotifyCollectionChangedEventHandler SelectedItemsChanged

This event fires before the SelectedItems collection changes.

C#
public event NotifyCollectionChangingEventHandler SelectedItemsChanging

This event fires only if the SelectedValue has really changed. For example it will not fire if the previously selected item has the same value as the newly selected item.

C#
public event EventHandler SelectedValueChanged

Occurs when the SortStyle property value changes.

C#
public event SortStyleChangedEventHandler SortStyleChanged

Occurs when visual item formatting is needed, allowing customization of the appearance of visible list items.

C#
public event VisualListItemFormattingEventHandler VisualItemFormatting
In this article
DefinitionConstructorsRadListControl()FieldsCreatingVisualListItemEventKeyListItemDataBindingEventKeyListItemDataBoundEventKeySelectedIndexChangedEventKeySelectedIndexChangingEventKeySelectedValueChangedEventKeySortStyleChangedEventKeyVisualItemFormattingEventKeyPropertiesActiveItemAllowDragDropAutoSizeItemsCaseSensitiveSortDataMemberDataSourceDefaultSizeDescriptionTextMemberDisplayMemberEnableAlternatingItemColorEnableKineticScrollingEnableUIAutomationFilterFilterExpressionFindStringComparerFitItemsToSizeFormatStringFormattingEnabledIsFilterActiveItemHeightItemsItemTextComparisonModeKeyboardSearchEnabledKeyboardSearchResetIntervalListElementScrollModeSelectedIndexSelectedItemSelectedItemsSelectedValueSelectionModeSortStyleSuspendItemsChangeEventsSuspendSelectionEventsValueMemberMethodsBeginUpdate()CanEditElementAtDesignTime(RadElement)ClearMeasuredSize()CreateAccessibilityInstance()CreateChildItems(RadElement)CreateListElement()DeferRefresh()Dispose(bool)EndInit()EndUpdate()FindItemExact(string, bool)FindString(string, int)FindString(string)FindStringExact(string, int)FindStringExact(string)FindStringNonWrapping(string, int)FindStringNonWrapping(string)HandleEndKey()HandleHomeKey()HandlePageDownKey()HandlePageUpKey()IsInputChar(char)IsInputKey(Keys)OnCreatingVisualItem(object, CreatingVisualListItemEventArgs)OnDataBindingComplete(object, ListBindingCompleteEventArgs)OnEnabledChanged(EventArgs)OnGotFocus(EventArgs)OnItemDataBinding(object, ListItemDataBindingEventArgs)OnItemDataBound(object, ListItemDataBoundEventArgs)OnKeyDown(KeyEventArgs)OnLoad(Size)OnMouseDown(MouseEventArgs)OnMouseMove(MouseEventArgs)OnMouseUp(MouseEventArgs)OnMouseWheel(MouseEventArgs)OnSelectedIndexChanged(object, int)OnSelectedIndexChanging(object, int)OnSelectedValueChanged(object, int, object, object)OnSortStyleChanged(object, SortStyleChangedEventArgs)OnVisualItemFormatting(object, VisualItemFormattingEventArgs)ProcessCodedUIMessage(ref IPCMessage)Rebind()ScrollByPage(int)ScrollToItem(RadListDataItem)SelectAll()SelectRange(int, int)UnwireEvents()WireEvents()WndProc(ref Message)EventsCreatingVisualListItemDataBindingCompleteItemDataBindingItemDataBoundSelectedIndexChangedSelectedIndexChangingSelectedItemsChangedSelectedItemsChangingSelectedValueChangedSortStyleChangedVisualItemFormatting
Not finding the help you need?
Contact Support