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.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

cs-api-definition

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

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>BaseListViewElementSimpleListViewElement

Implements: IBindableComponentIBorderElementIBoxElementIBoxStyleIComponentICustomTypeDescriptorIDisposableIDrawFillElementIFillElementIImageElementINotifyPropertyChangedIPrimitiveElementIShapedElementIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkinITextPrimitiveITextProvider

Constructors

SimpleListViewElement(RadListViewElement)

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

Declaration

cs-api-definition

public SimpleListViewElement(RadListViewElement owner)

Parameters

owner

RadListViewElement

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

cs-api-definition

protected override VirtualizedStackContainer<ListViewDataItem> CreateViewElement()

Returns

VirtualizedStackContainer<ListViewDataItem>

A new SimpleListViewContainer instance for this list view element.

Overrides BaseListViewElement.CreateViewElement()

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

cs-api-definition

protected override void EnsureItemVisibleHorizontal(ListViewDataItem item)

Parameters

item

ListViewDataItem

The ListViewDataItem to make visible horizontally.

Overrides BaseListViewElement.EnsureItemVisibleHorizontal(ListViewDataItem)

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

cs-api-definition

protected override void HScrollBar_ValueChanged(object sender, EventArgs e)

Parameters

sender

object

The source of the event.

EventArgs

The EventArgs containing event data.

Overrides VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>.HScrollBar_ValueChanged(object, 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

cs-api-definition

protected override void OnNotifyPropertyChanged(string propertyName)

Parameters

propertyName

string

The name of the property that changed.

Overrides RadObject.OnNotifyPropertyChanged(string)

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

cs-api-definition

protected override void OnPanGesture(PanGestureEventArgs args)

Parameters

args

PanGestureEventArgs

The PanGestureEventArgs containing gesture information and offset values.

Overrides RadItem.OnPanGesture(PanGestureEventArgs)

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

cs-api-definition

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

RadPropertyChangedEventArgs

The RadPropertyChangedEventArgs containing information about the property change.

Overrides BaseListViewElement.OnPropertyChanged(RadPropertyChangedEventArgs)

SupportsOrientation(Orientation)

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

Declaration

cs-api-definition

protected override bool SupportsOrientation(Orientation orientation)

Parameters

orientation

Orientation

The Orientation to check for support.

Returns

bool

True if the orientation is vertical; otherwise, false.

Overrides BaseListViewElement.SupportsOrientation(Orientation)

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

cs-api-definition

public override void UpdateHScrollbarMaximum()

Overrides BaseListViewElement.UpdateHScrollbarMaximum()

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

cs-api-definition

protected override void UpdateHScrollbarVisibility()

Overrides BaseListViewElement.UpdateHScrollbarVisibility()

ClassSimpleListViewElement

Class
SimpleListViewElement