ClassIconListViewElement
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.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class IconListViewElement : BaseListViewElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProviderInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>BaseListViewElementIconListViewElement
Derived Classes:
Implements:
Inherited Members
Constructors
IconListViewElement(RadListViewElement)
Initializes a new instance of the IconListViewElement class with the specified owner.
Declaration
public IconListViewElement(RadListViewElement owner)Parameters
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
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
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
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
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
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
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
currentItem
The ListViewDataItem to find the lower item for.
Returns
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
visualItem
The BaseListViewVisualItem being dragged.
mouseLocation
The current mouse location relative to the visual item.
Returns
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
target
The ISupportDrop target for the drag operation.
Returns
The 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
currentItem
The ListViewDataItem to find the upper item for.
Returns
The ListViewDataItem positioned above the current item, or null if none exists.
HScrollBar_ValueChanged(object, EventArgs)
Handles horizontal scrollbar value changes by updating the view element scroll offset according to orientation.
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
e
The 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
e
The 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
e
The 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
e
The KeyEventArgs containing key event data.
Overrides
OnLassoTimerTick(object, EventArgs)
Handles lasso timer tick events to scroll during lasso selection operations, considering current orientation.
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
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
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
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
selectionRect
The selection rectangle for lasso operations.
Overrides
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
targetElement
The BaseListViewVisualItem being targeted for drop.
dropLocation
The drop location relative to the target element.
Returns
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
UpdateOnMeasure(SizeF)
Updates scrollbar visibility and properties during measurement, considering orientation and fit-to-size settings.
scroller_ScrollerUpdated(object, EventArgs)
Handles scroller update events by adjusting the view element scroll offset based on current orientation.