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.
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
Initializes a new instance of the IconListViewElement class with the specified owner.
public IconListViewElement(RadListViewElement owner)The RadListViewElement that owns this icon view element.
Properties
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.
public override bool FullRowSelect { get; set; }Overrides:
Methods
Creates and configures the child elements for the icon view, setting the default item size for icon display.
protected override void CreateChildElements()Overrides:
Creates and returns a specialized item scroller optimized for icon view scrolling behavior.
protected override ItemScroller<ListViewDataItem> CreateItemScroller()ItemScroller<ListViewDataItem>
An IconListViewScroller instance for managing icon view scrolling.
Overrides:
Creates and returns a specialized view element container optimized for icon-based layout and arrangement.
protected override VirtualizedStackContainer<ListViewDataItem> CreateViewElement()VirtualizedStackContainer<ListViewDataItem>
An IconListViewContainer instance configured for icon view functionality.
Overrides:
Ensures the specified item is visible within the horizontal viewport, handling column-based scrolling in horizontal orientation.
protected override void EnsureItemVisibleHorizontal(ListViewDataItem item)The ListViewDataItem to make horizontally visible.
Overrides:
Ensures the specified item is visible within the vertical viewport, handling both vertical and horizontal orientations with appropriate scrolling behavior.
protected override void EnsureItemVisibleVertical(ListViewDataItem item)The ListViewDataItem to make visible.
Overrides:
Core implementation for ensuring vertical item visibility in icon view, handling row-based scrolling for both orientations.
protected override void EnsureItemVisibleVerticalCore(ListViewDataItem item)The ListViewDataItem to ensure visibility for.
Overrides:
Finds the data item positioned below the specified current item in the icon grid layout, considering flow arrangement and item positioning.
protected virtual ListViewDataItem GetDownerItem(ListViewDataItem currentItem)The ListViewDataItem to find the lower item for.
Returns:The ListViewDataItem positioned below the current item, or null if none exists.
Gets the location for displaying drag hints during drag operations, considering orientation and drop position logic.
public override Point GetDragHintLocation(BaseListViewVisualItem visualItem, Point mouseLocation)The BaseListViewVisualItem being dragged.
mouseLocationPointThe current mouse location relative to the visual item.
Returns:The screen coordinates for positioning the drag hint.
Overrides:
Gets the size for drag hint display based on target element dimensions and current orientation.
public override Size GetDragHintSize(ISupportDrop target)The ISupportDrop target for the drag operation.
Returns:The Size for the drag hint display.
Overrides:
Finds the data item positioned above the specified current item in the icon grid layout, considering flow arrangement and item positioning.
protected virtual ListViewDataItem GetUpperItem(ListViewDataItem currentItem)The ListViewDataItem to find the upper item for.
Returns:The ListViewDataItem positioned above the current item, or null if none exists.
Handles down arrow key navigation by moving to the item below the current item, considering orientation and grid layout.
protected override void HandleDownKey(KeyEventArgs e)The KeyEventArgs containing key event data.
Overrides:
Handles left arrow key navigation by collapsing groups or moving to the previous item, considering orientation and layout.
protected override void HandleLeftKey(KeyEventArgs e)The KeyEventArgs containing key event data.
Overrides:
Handles right arrow key navigation by expanding groups or moving to the next item, considering orientation and layout.
protected override void HandleRightKey(KeyEventArgs e)The KeyEventArgs containing key event data.
Overrides:
Handles up arrow key navigation by moving to the item above the current item, considering orientation and grid layout.
protected override void HandleUpKey(KeyEventArgs e)The KeyEventArgs containing key event data.
Overrides:
Handles property change notifications, specifically updating scroll states when horizontal or vertical scroll properties change.
protected override void OnNotifyPropertyChanged(string propertyName)The name of the property that changed.
Overrides:
Handles orientation changes by reconfiguring scrollbars, scroll services, and updating layout to match the new orientation.
protected override void OnOrientationChanged()Overrides:
Handles pan gesture events for touch scrolling, supporting scrolling in the direction appropriate for current orientation.
protected override void OnPanGesture(PanGestureEventArgs args)The PanGestureEventArgs containing gesture data.
Overrides:
Handles property change events, specifically updating scroll range when bounds change.
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)The RadPropertyChangedEventArgs containing property change information.
Overrides:
Handles scroller update notifications by invalidating view element measurement and visual state.
protected override void OnScrollerUpdated()Overrides:
Processes lasso selection within the icon view, calculating item positions in grid layout and determining selection intersections.
protected override void ProcessLassoSelection(Rectangle selectionRect)The selection rectangle for lasso operations.
Overrides:
Determines whether a drop operation should occur after the target element based on drop location and orientation.
public override bool ShouldDropAfter(BaseListViewVisualItem targetElement, Point dropLocation)The BaseListViewVisualItem being targeted for drop.
dropLocationPointThe drop location relative to the target element.
Returns:True if the drop should occur after the target element; otherwise, false.
Overrides:
Updates the fit-to-size mode by resetting the appropriate scrollbar maximum based on current orientation.
protected override void UpdateFitToSizeMode()Overrides:
Updates scrollbar visibility and properties during measurement, considering orientation and fit-to-size settings.