Class SimpleListViewElement

Represents a simple list view element that provides vertical scrolling and basic list functionality for RadListView. This class implements a straightforward list view layout with support for horizontal scrolling, grouping with indentation, and touch gesture handling for scrolling operations.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
UIItemBase
LightVisualElement
ScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>
VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>
BaseListViewElement
SimpleListViewElement
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.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class SimpleListViewElement : BaseListViewElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Constructors

SimpleListViewElement(RadListViewElement)

Initializes a new instance of the SimpleListViewElement class with the specified owner.

Declaration
public SimpleListViewElement(RadListViewElement owner)
Parameters
RadListViewElement owner

The RadListViewElement that owns this simple list view element.

Methods

CreateViewElement()

Creates and returns a new SimpleListViewContainer that serves as the virtualized container for managing list view data items in the simple list view layout.

Declaration
protected override VirtualizedStackContainer<ListViewDataItem> CreateViewElement()
Returns
VirtualizedStackContainer<ListViewDataItem>

A new SimpleListViewContainer instance for this list view element.
Overrides

EnsureItemVisibleHorizontal(ListViewDataItem)

Ensures the specified item is visible horizontally by adjusting the horizontal scrollbar value to the item's left position. This method scrolls the view to bring the item into the visible area.

Declaration
protected override void EnsureItemVisibleHorizontal(ListViewDataItem item)
Parameters
ListViewDataItem item

The ListViewDataItem to make visible horizontally.
Overrides

HScrollBar_ValueChanged(Object, EventArgs)

Handles the horizontal scrollbar value changed event by ending any active edit operations before proceeding with the base scrollbar handling logic.

Declaration
protected override void HScrollBar_ValueChanged(object sender, EventArgs e)
Parameters
System.Object sender

The source of the event.
System.EventArgs e

The System.EventArgs containing event data.
Overrides
Telerik.WinControls.UI.VirtualizedScrollPanel<Telerik.WinControls.UI.ListViewDataItem, Telerik.WinControls.UI.BaseListViewVisualItem>.HScrollBar_ValueChanged(System.Object, System.EventArgs)

OnNotifyPropertyChanged(String)

Handles property change notifications for specific properties and performs corresponding updates. Manages vertical and horizontal scroll state changes by updating scroller settings and visibility.

Declaration
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters
System.String propertyName

The name of the property that changed.
Overrides

OnPanGesture(PanGestureEventArgs)

Handles pan gesture events for touch scrolling functionality. Processes both vertical and horizontal scrolling gestures while respecting scrollbar boundaries and ensuring values remain within valid ranges.

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

The PanGestureEventArgs containing gesture information and offset values.
Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

Handles property change notifications and performs additional processing for the BoundsProperty. Ensures the horizontal scrollbar value remains within valid bounds when the element's bounds change.

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

The RadPropertyChangedEventArgs containing information about the property change.
Overrides

SupportsOrientation(Orientation)

Determines whether this simple list view element supports the specified orientation. This implementation only supports vertical orientation for list item arrangement.

Declaration
protected override bool SupportsOrientation(Orientation orientation)
Parameters
System.Windows.Forms.Orientation orientation

The System.Windows.Forms.Orientation to check for support.
Returns
System.Boolean

True if the orientation is vertical; otherwise, false.
Overrides

UpdateHScrollbarMaximum()

Updates the maximum value of the horizontal scrollbar based on the widest item in the list view. Calculates the maximum width considering item sizes and group indentation when grouping is enabled.

Declaration
public override void UpdateHScrollbarMaximum()
Overrides

UpdateHScrollbarVisibility()

Updates the visibility of the horizontal scrollbar based on the current HorizontalScrollState and whether scrolling is needed. Shows the scrollbar when content exceeds the visible area in auto-hide mode.

Declaration
protected override void UpdateHScrollbarVisibility()
Overrides

Extension Methods