Class IconListViewElement

Represents a specialized list view element that displays data items as icons in a grid-like layout. This element provides icon-based data visualization with support for both horizontal and vertical orientations, flow-based item arrangement, keyboard navigation, and drag-drop operations optimized for icon display.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
UIItemBase
LightVisualElement
ScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>
VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>
BaseListViewElement
IconListViewElement
CardListViewElement
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 IconListViewElement : BaseListViewElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Constructors

IconListViewElement(RadListViewElement)

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

Declaration
public IconListViewElement(RadListViewElement owner)
Parameters
RadListViewElement owner

The RadListViewElement that owns this icon view element.

Properties

FullRowSelect

Gets or sets the full row selection mode. For icon view, this property always returns false as full row selection is not applicable to icon-based layouts.

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

Overrides

Methods

CreateChildElements()

Creates and configures the child elements for the icon view, setting the default item size for icon display.

Declaration
protected override void CreateChildElements()
Overrides
Telerik.WinControls.UI.VirtualizedScrollPanel<Telerik.WinControls.UI.ListViewDataItem, Telerik.WinControls.UI.BaseListViewVisualItem>.CreateChildElements()

CreateItemScroller()

Creates and returns a specialized item scroller optimized for icon view scrolling behavior.

Declaration
protected override ItemScroller<ListViewDataItem> CreateItemScroller()
Returns
ItemScroller<ListViewDataItem>

An IconListViewScroller instance for managing icon view scrolling.
Overrides
Telerik.WinControls.UI.VirtualizedScrollPanel<Telerik.WinControls.UI.ListViewDataItem, Telerik.WinControls.UI.BaseListViewVisualItem>.CreateItemScroller()

CreateViewElement()

Creates and returns a specialized view element container optimized for icon-based layout and arrangement.

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

An IconListViewContainer instance configured for icon view functionality.
Overrides

EnsureItemVisibleHorizontal(ListViewDataItem)

Ensures the specified item is visible within the horizontal viewport, handling column-based scrolling in horizontal orientation.

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

The ListViewDataItem to make horizontally visible.
Overrides

EnsureItemVisibleVertical(ListViewDataItem)

Ensures the specified item is visible within the vertical viewport, handling both vertical and horizontal orientations with appropriate scrolling behavior.

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

The ListViewDataItem to make visible.
Overrides

EnsureItemVisibleVerticalCore(ListViewDataItem)

Core implementation for ensuring vertical item visibility in icon view, handling row-based scrolling for both orientations.

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

The ListViewDataItem to ensure visibility for.
Overrides

GetDownerItem(ListViewDataItem)

Finds the data item positioned below the specified current item in the icon grid layout, considering flow arrangement and item positioning.

Declaration
protected virtual ListViewDataItem GetDownerItem(ListViewDataItem currentItem)
Parameters
ListViewDataItem currentItem

The ListViewDataItem to find the lower item for.
Returns
ListViewDataItem

The ListViewDataItem positioned below the current item, or null if none exists.

GetDragHintLocation(BaseListViewVisualItem, Point)

Gets the location for displaying drag hints during drag operations, considering orientation and drop position logic.

Declaration
public override Point GetDragHintLocation(BaseListViewVisualItem visualItem, Point mouseLocation)
Parameters
BaseListViewVisualItem visualItem

The BaseListViewVisualItem being dragged.
System.Drawing.Point mouseLocation

The current mouse location relative to the visual item.
Returns
System.Drawing.Point

The screen coordinates for positioning the drag hint.
Overrides

GetDragHintSize(ISupportDrop)

Gets the size for drag hint display based on target element dimensions and current orientation.

Declaration
public override Size GetDragHintSize(ISupportDrop target)
Parameters
ISupportDrop target

The ISupportDrop target for the drag operation.
Returns
System.Drawing.Size

The System.Drawing.Size for the drag hint display.
Overrides

GetUpperItem(ListViewDataItem)

Finds the data item positioned above the specified current item in the icon grid layout, considering flow arrangement and item positioning.

Declaration
protected virtual ListViewDataItem GetUpperItem(ListViewDataItem currentItem)
Parameters
ListViewDataItem currentItem

The ListViewDataItem to find the upper item for.
Returns
ListViewDataItem

The ListViewDataItem positioned above the current item, or null if none exists.

HandleDownKey(KeyEventArgs)

Handles down arrow key navigation by moving to the item below the current item, considering orientation and grid layout.

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

The System.Windows.Forms.KeyEventArgs containing key event data.
Overrides

HandleLeftKey(KeyEventArgs)

Handles left arrow key navigation by collapsing groups or moving to the previous item, considering orientation and layout.

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

The System.Windows.Forms.KeyEventArgs containing key event data.
Overrides

HandleRightKey(KeyEventArgs)

Handles right arrow key navigation by expanding groups or moving to the next item, considering orientation and layout.

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

The System.Windows.Forms.KeyEventArgs containing key event data.
Overrides

HandleUpKey(KeyEventArgs)

Handles up arrow key navigation by moving to the item above the current item, considering orientation and grid layout.

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

The System.Windows.Forms.KeyEventArgs containing key event data.
Overrides

HScrollBar_ValueChanged(Object, EventArgs)

Handles horizontal scrollbar value changes by updating the view element scroll offset according to orientation.

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

The event sender.
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)

OnLassoTimerTick(Object, EventArgs)

Handles lasso timer tick events to scroll during lasso selection operations, considering current orientation.

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

The event sender.
System.EventArgs e

The System.EventArgs containing event data.
Overrides

OnNotifyPropertyChanged(String)

Handles property change notifications, specifically updating scroll states when horizontal or vertical scroll properties change.

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

The name of the property that changed.
Overrides

OnOrientationChanged()

Handles orientation changes by reconfiguring scrollbars, scroll services, and updating layout to match the new orientation.

Declaration
protected override void OnOrientationChanged()
Overrides

OnPanGesture(PanGestureEventArgs)

Handles pan gesture events for touch scrolling, supporting scrolling in the direction appropriate for current orientation.

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

The PanGestureEventArgs containing gesture data.
Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

Handles property change events, specifically updating scroll range when bounds change.

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

The RadPropertyChangedEventArgs containing property change information.
Overrides

OnScrollerUpdated()

Handles scroller update notifications by invalidating view element measurement and visual state.

Declaration
protected override void OnScrollerUpdated()
Overrides

ProcessLassoSelection(Rectangle)

Processes lasso selection within the icon view, calculating item positions in grid layout and determining selection intersections.

Declaration
protected override void ProcessLassoSelection(Rectangle selectionRect)
Parameters
System.Drawing.Rectangle selectionRect

The selection rectangle for lasso operations.
Overrides

scroller_ScrollerUpdated(Object, EventArgs)

Handles scroller update events by adjusting the view element scroll offset based on current orientation.

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

The event sender.
System.EventArgs e

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

ShouldDropAfter(BaseListViewVisualItem, Point)

Determines whether a drop operation should occur after the target element based on drop location and orientation.

Declaration
public override bool ShouldDropAfter(BaseListViewVisualItem targetElement, Point dropLocation)
Parameters
BaseListViewVisualItem targetElement

The BaseListViewVisualItem being targeted for drop.
System.Drawing.Point dropLocation

The drop location relative to the target element.
Returns
System.Boolean

True if the drop should occur after the target element; otherwise, false.
Overrides

UpdateFitToSizeMode()

Updates the fit-to-size mode by resetting the appropriate scrollbar maximum based on current orientation.

Declaration
protected override void UpdateFitToSizeMode()
Overrides
Telerik.WinControls.UI.VirtualizedScrollPanel<Telerik.WinControls.UI.ListViewDataItem, Telerik.WinControls.UI.BaseListViewVisualItem>.UpdateFitToSizeMode()

UpdateOnMeasure(SizeF)

Updates scrollbar visibility and properties during measurement, considering orientation and fit-to-size settings.

Declaration
protected override bool UpdateOnMeasure(SizeF availableSize)
Parameters
System.Drawing.SizeF availableSize

The available size for update calculations.
Returns
System.Boolean

True if scrollbar visibility changed; otherwise, false.
Overrides

Extension Methods