Class

BaseListViewElement

Initializes a new instance of the BaseListViewElement class with the specified owner. Configures scrolling behavior, timers for editing and selection, drag-drop support, and keyboard navigation functionality.

Declaration

public BaseListViewElement(RadListViewElement owner)

Parameters

Declaration

public static RadProperty AllowArbitraryItemHeightProperty

Field Value

Declaration

public static RadProperty AllowArbitraryItemWidthProperty

Field Value

Declaration

public static RadProperty DragHintProperty

Field Value

Declaration

public static RadProperty FullRowSelectProperty

Field Value

Declaration

public static RadProperty GroupIndentProperty

Field Value

Declaration

public static RadProperty GroupItemSizeProperty

Field Value

Declaration

public static RadProperty ItemSizeProperty

Field Value

Declaration

public static RadProperty SelectionRectangleBorderColorProperty

Field Value

Declaration

public static RadProperty SelectionRectangleColorProperty

Field Value

Declaration

protected ListViewDataItem anchor

Field Value

Declaration

protected Timer beginEditTimer

Field Value

Declaration

protected bool disableEditOnMouseUp

Field Value

Declaration

protected bool disableGroupSelectOnMouseUp

Field Value

Declaration

protected Point endPoint

Field Value

Declaration

protected Timer groupSelectionTimer

Field Value

Declaration

protected bool isLassoSelection

Field Value

Declaration

protected Dictionary<ListViewDataItem, bool> lassoInitialSelection

Field Value

Declaration

protected ListViewDataItem lastClickedItem

Field Value

Declaration

protected Keys lastModifierKeys

Field Value

Declaration

protected Point pointerOffset

Field Value

Declaration

protected BaseListViewVisualItem pressedItem

Field Value

Declaration

protected Point startPoint

Field Value

Gets or sets a value indicating whether the items can have different height.

Declaration

public virtual bool AllowArbitraryItemHeight { get; set; }

Property Value

Gets or sets a value indicating whether the items can have different width.

Declaration

public virtual bool AllowArbitraryItemWidth { get; set; }

Property Value

Gets or sets the RadImageShape instance which describes the hint that indicates where a column will be dropped after a drag operation.

Declaration

[Browsable(false)]
[VsbBrowsable(true)]
public RadImageShape DragHint { get; set; }

Property Value

Gets or sets an object that implements IFindStringComparer. The value of this property is used in the keyboard search functionality.

Declaration

public IFindStringComparer FindStringComparer { get; set; }

Property Value

Gets or sets a value indicating whether the full row should be selected.

Declaration

public virtual bool FullRowSelect { get; set; }

Property Value

Gets or sets the indent of the items when they are displayed in a group.

Declaration

public virtual int GroupIndent { get; set; }

Property Value

Gets or sets the default group item size.

Declaration

public Size GroupItemSize { get; set; }

Property Value

Gets or sets the display state of the horizontal scrollbar.

Declaration

public ScrollState HorizontalScrollState { get; set; }

Property Value

Gets or sets the default item size.

Declaration

public virtual Size ItemSize { get; set; }

Property Value

Gets or sets the orientation of the view element.

Declaration

public override Orientation Orientation { get; set; }

Property Value

Overrides VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>.Orientation

Gets the RadListViewElement that owns the view.

Declaration

public virtual RadListViewElement Owner { get; }

Property Value

Gets the ScrollServiceBehavior that is responsible for the kinetic scrolling option.

Declaration

public ScrollServiceBehavior ScrollBehavior { get; }

Property Value

Determines if the group items can be selected.

Declaration

public bool SelectGroupItems { get; set; }

Property Value

Gets or sets the border color of the lasso selection rectangle.

Declaration

[VsbBrowsable(true)]
public Color SelectionRectangleBorderColor { get; set; }

Property Value

Gets or sets the fill color of the lasso selection rectangle.

Declaration

[VsbBrowsable(true)]
public Color SelectionRectangleColor { get; set; }

Property Value

Gets or sets the display state of the vertical scrollbar.

Declaration

public ScrollState VerticalScrollState { get; set; }

Property Value

Begins the lasso selection.

Declaration

protected virtual void BeginLassoSelection()

Clears the selection.

Declaration

public void ClearSelection()

Creates the element provider responsible for managing the creation and recycling of visual list view items.

Declaration

protected override IVirtualizedElementProvider<ListViewDataItem> CreateElementProvider()

Returns

Overrides VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>.CreateElementProvider()

Creates the item traverser responsible for navigating through the list view data items including group support.

Declaration

protected override ITraverser<ListViewDataItem> CreateItemTraverser(IList<ListViewDataItem> items)

Parameters

Returns

Overrides VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>.CreateItemTraverser(IList<ListViewDataItem>)

Creates the view element container responsible for arranging and displaying list view items.

Declaration

protected override VirtualizedStackContainer<ListViewDataItem> CreateViewElement()

Returns

Overrides ScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>.CreateViewElement()

Disposes managed resources including timers used for editing, group selection, and lasso operations. Ensures proper cleanup of event handlers and timer resources.

Declaration

protected override void DisposeManagedResources()

Overrides VirtualizedScrollPanel<ListViewDataItem, BaseListViewVisualItem>.DisposeManagedResources()

Ends the lasso selection.

Declaration

protected virtual void EndLassoSelection()

Ensures that a given ListViewDataItem is visible on the client area.

Declaration

public virtual void EnsureItemVisible(ListViewDataItem item)

Parameters

Ensures that a given ListViewDataItem is visible on the client area.

Declaration

public virtual void EnsureItemVisible(ListViewDataItem item, bool ensureHorizontally)

Parameters

Ensures that a given ListViewDataItem is visible by scrolling the view horizontally.

Declaration

protected virtual void EnsureItemVisibleHorizontal(ListViewDataItem item)

Parameters

Ensures that a given ListViewDataItem is visible by scrolling the view vertically.

Declaration

protected virtual void EnsureItemVisibleVertical(ListViewDataItem item)

Parameters

Ensures that a given ListViewDataItem is visible when it is below the last visible item in the view.

Declaration

protected virtual void EnsureItemVisibleVerticalCore(ListViewDataItem item)

Parameters

Gets the drag hint location according to the specified item.

Declaration

public virtual Point GetDragHintLocation(BaseListViewVisualItem visualItem, Point mouseLocation)

Parameters

Returns

Gets the size of the drag hint according to the speficied target.

Declaration

public virtual Size GetDragHintSize(ISupportDrop target)

Parameters

Returns

This method traverses through the items in the control and fills a queue with these items that start with the searchCriteria.

Declaration

protected virtual ListViewDataItem GetFirstMatch(string searchCriteria)

Parameters

Returns

Gets the ListViewDataItem at a specified location.

Declaration

public ListViewDataItem GetItemAt(Point location)

Parameters

Returns

Declaration

protected int GetItemIndex(ListViewDataItem item)

Parameters

Returns

Gets the next visible item of a given ListViewDataItem.

Declaration

protected virtual ListViewDataItem GetNextItem(ListViewDataItem currentItem)

Parameters

Returns

Gets the previous visible item of a given ListViewDataItem.

Declaration

protected virtual ListViewDataItem GetPreviousItem(ListViewDataItem currentItem)

Parameters

Returns

Gets the BaseListViewVisualItem at a specified location.

Declaration

public virtual BaseListViewVisualItem GetVisualItemAt(Point location)

Parameters

Returns

Handles a press of the Delete key.

Declaration

protected virtual void HandleDeleteKey(KeyEventArgs e)

Parameters

Handles a press of the Down key.

Declaration

protected virtual void HandleDownKey(KeyEventArgs e)

Parameters

Handles a press of the End key.

Declaration

protected virtual void HandleEndKey(KeyEventArgs e)

Parameters

Handles a press of the Escape key.

Declaration

protected virtual void HandleEscapeKey(KeyEventArgs e)

Parameters

Handles a press of the F2 key.

Declaration

protected virtual void HandleF2Key(KeyEventArgs e)

Parameters

Handles a press of the Home key.

Declaration

protected virtual void HandleHomeKey(KeyEventArgs e)

Parameters

Handles a press of the Left key.

Declaration

protected virtual void HandleLeftKey(KeyEventArgs e)

Parameters

Handles navigation upon key press.

Declaration

protected virtual void HandleNavigation(char keyChar)

Parameters

Handles a press of the PageDown key.

Declaration

protected virtual void HandlePageDownKey(KeyEventArgs e)

Parameters

Handles a press of the PageUp key.

Declaration

protected virtual void HandlePageUpKey(KeyEventArgs e)

Parameters

Handles a press of the Right key.

Declaration

protected virtual void HandleRightKey(KeyEventArgs e)

Parameters

Handles a press of the Space key.

Declaration

protected virtual void HandleSpaceKey(KeyEventArgs e)

Parameters

Handles a press of the Up key.

Declaration

protected virtual void HandleUpKey(KeyEventArgs e)

Parameters

Initializes the fields and properties specific to the BaseListViewElement. Configures default values and initializes the find string comparer for keyboard search functionality.

Declaration

protected override void InitializeFields()

Overrides ScrollViewElement<VirtualizedStackContainer<ListViewDataItem>>.InitializeFields()

Declaration

protected virtual void OnLassoTimerTick(object sender, EventArgs e)

Parameters

Called when the orientation of the view has changed.

Declaration

protected virtual void OnOrientationChanged()

Handles property change events and updates the view when display-related properties change. Refreshes the view for properties affecting layout and appearance.

Declaration

protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

Overrides LightVisualElement.OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration

protected virtual void OnScrollerUpdated()

Performs custom painting operations including rendering the lasso selection rectangle when active. Draws the selection rectangle with specified fill and border colors during drag selection.

Declaration

protected override void PaintOverride(IGraphics screenRadGraphics, Rectangle clipRectangle, float angle, SizeF scale, bool useRelativeTransformation)

Parameters

Overrides RadItem.PaintOverride(IGraphics, Rectangle, float, SizeF, bool)

Processes drag over events to determine whether drag-drop operations are allowed.

Declaration

protected override bool ProcessDragOver(Point mousePosition, ISupportDrag dragObject)

Parameters

Returns

Overrides RadItem.ProcessDragOver(Point, ISupportDrag)

Declaration

protected virtual void ProcessItemLassoSelection(ListViewDataItem currentItem, bool isIntersecting)

Parameters

Processes the KeyDown event.

Declaration

protected virtual bool ProcessKeyDown(KeyEventArgs e)

Parameters

Returns

Declaration

protected virtual bool ProcessKeyPress(KeyPressEventArgs e)

Parameters

Returns

Selects all items that are whitin the lasso rectangle.

Declaration

protected void ProcessLassoSelection()

Selects all items that are whitin the specified rectangle.

Declaration

protected virtual void ProcessLassoSelection(Rectangle selectionRect)

Parameters

Processes the MouseDown event.

Declaration

protected virtual bool ProcessMouseDown(MouseEventArgs e)

Parameters

Returns

Processes the MouseMove event.

Declaration

protected virtual bool ProcessMouseMove(MouseEventArgs e)

Parameters

Returns

Processes the MouseUp event.

Declaration

protected virtual bool ProcessMouseUp(MouseEventArgs e)

Parameters

Returns

Processes the MouseWheel event.

Declaration

protected virtual bool ProcessMouseWheel(MouseEventArgs e)

Parameters

Returns

Processes the selection of a specified item.

Declaration

protected virtual void ProcessSelection(ListViewDataItem item, Keys modifierKeys, bool isMouseSelection)

Parameters

Scrolls the view with a given amount.

Declaration

public void ScrollTo(int delta)

Parameters

Declaration

protected void SetScrollValue(RadScrollBarElement scrollbar, int newValue)

Parameters

Indicates whether an item should be dropped after the given target according to the specified location.

Declaration

public virtual bool ShouldDropAfter(BaseListViewVisualItem targetElement, Point dropLocation)

Parameters

Returns

Returns a value indicating whether the current view supports given orientation.

Declaration

protected virtual bool SupportsOrientation(Orientation orientation)

Parameters

Returns

Toggles the CheckState of given item.

Declaration

protected void ToggleItemCheckState(ListViewDataItem item)

Parameters

Updates the horizontal scrollbar.

Declaration

public virtual void UpdateHScrollbarMaximum()

Updates the visibility of the horizontal scrollbar.

Declaration

protected virtual void UpdateHScrollbarVisibility()