ListView

Wisej.Web.ListView

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.5.0.0)

Represents a list view control, which displays a collection of items that can be displayed using one of four different views.

public class ListView : Control, IWisejDataStore

Constructors

Initializes a new instance of the ListView class.

Properties

Boolean: Returns or sets whether the user can drag column headers to reorder columns in the control. (Default: False)

Boolean: Returns or sets whether the user can sort columns by clicking on the header. (Default: False)

BorderStyle: Returns or sets the border style of the control. (Default: Solid)

Boolean: Returns or sets whether a check box appears next to each item. (Default: False)

CheckedIndexCollection: Returns the indexes of the currently checked items in the control.

CheckedListViewItemCollection: Returns the currently checked items in the control.

Int32: Returns the number of columns without creating the columns collection.

ColumnHeaderCollection: Returns the collection of all column headers that appear in the control.

String: Returns or sets the name of the list or table in the data source for which the ListView is displaying data. (Default: "")

Object: Returns or sets the data source for this ListView. (Default: null)

Throws:

String: Returns or sets the property to display in the Items. (Default: "")

ListViewItem: Returns or sets the item that currently has the focus.

Boolean: Returns or sets whether grid lines appear between the rows and columns containing the items and subitems in the control. (Default: True)

GridLineStyle: Returns or sets the cell border style for the ListView control when its View property is set to Details and the GridLines property is set to true. (Default: Vertical)

ColumnHeaderStyle: Returns or sets the column header style. (Default: Clickable)

Boolean: Returns whether the horizontal scroll bar is visible.

String: Returns or sets the property to use as the icon for the Items. (Default: "")

Padding: Returns or sets the padding inside ListViewItem objects in any View mode.

ListViewItemCollection: Returns a collection containing all items in the control.

Size: Returns or sets the size of the items in the list view. If left empty (0, 0), the control uses the item size set in the current theme.

IComparer<ListViewItem>: Returns or sets the sorting comparer for the control.

Boolean: Returns or sets whether the user can edit the labels of items in the control. (Default: False)

Boolean: Returns or sets whether the text in the ListViewItem item can wrap. (Default: False)

ImageList: Returns or sets the ImageList to use to display the icon in the ListViewItem elements when the View is set to LargeIcon or Tile. (Default: null)

If LargeImageList is not set, Wisej will use SmallImageList and scale the icons.

Boolean: Returns or sets whether the column and row resizing should be updated as the user resizes the row or the column. (Default: False)

Boolean: Returns or sets whether multiple items can be selected. (Default: False)

Int32: Returns or sets the number of items to prefetch outside of the visible area. The default is 0 (disabled). (Default: 0)

Setting the property PrefetchItems to a value greater than 0 allows the virtual view to prefetch the specified number of items outside of the visible area to enable smoother scrolling.

Boolean: Returns or sets whether a scroll bar is added to the control when there is not enough room to display all items. (Default: True)

Int32: Returns or sets the index of the focused ListViewItem.

SelectedIndexCollection: Returns the indexes of the selected items in the control.

SelectedListViewItemCollection: Returns the items that are selected in the control.

SelectionMode: Returns or sets the current selection mode determining how items are selected in the ListView. (Default: One)

When in Details view, the MultiSimple behaves as the MultiExtended. The DataGridView that renders the details view supports only the MultiSelect property true or false and uses the SelectionMode property to determine how elements of the grid are selected, which is always set to FullRowSelect when use inside the ListView.

Boolean: Returns or sets whether ToolTips are shown for the ListViewItem objects contained in the ListView. (Default: False)

ImageList: Returns or sets the ImageList to use to display the icon in the ListViewItem elements when the View is set to SmallIcon or Details. (Default: null)

If SmallImageList is not set, Wisej will use LargeImageList and scale the icons.

ColumnHeader: Returns the column by which the ListView contents are currently sorted.

SortOrder: Returns or sets the sort order for items in the control. (Default: None)

SortOrder: Returns a value indicating whether the items in the ListView control are sorted in ascending or descending order, or are not sorted.

ImageList: Returns or sets the ImageList associated with states set for each ListViewItem. (Default: null)

ComponentToolCollection: Returns the collection of the ComponentTool items associated with this control.

Position: Returns or sets the position of the ComponentTool items associated with this control. (Default: Top)

View: Returns or sets how items are displayed in the control. (Default: LargeIcon)

Int32: Returns or sets the number of ListViewItem objects contained in the list when in virtual mode. (Default: 0)

Throws:

Boolean: Returns or sets whether you have provided your own data-management operations for the ListView control. (Default: False)

Boolean: Returns whether the vertical scroll bar is visible.

Methods

Populates the DataGridView from the data appending the rows to the existing rows.

ParameterTypeDescription

data

The object that contains data for the ListView to display.

The name of the table or list in the data object for which the DataGridView should load the items.

Returns: Int32. Numbers of items appended.

Use this method to fill a ListView without binding it to the data source.

Resizes the width of the given column as indicated by the resize style.

ParameterTypeDescription

columnIndex

The zero-based index of the column to resize.

headerAutoResize

One of the ColumnHeaderAutoResizeStyle values.

Throws:

Resizes the width of the columns as indicated by the resize style.

ParameterTypeDescription

headerAutoResize

One of the ColumnHeaderAutoResizeStyle values.

Throws:

Prevents the control from updating until the EndUpdate method is called.

Removes all items and columns from the control.

Clears the current selection.

Resumes updating of the list view control after suspending it by the BeginUpdate method.

Ensures that the specified item is visible within the control, scrolling the contents of the control if necessary.

ParameterTypeDescription

index

The zero-based index of the item to scroll into view.

Throws:

Populates the ListView from the data .

ParameterTypeDescription

data

The object that contains data for the ListView to display.

The name of the table or list in the data object for which the ListView should load the items.

Returns: Int32. Numbers of items added.

Use this method to fill a ListView without binding it to the data source.

Finds the first ListViewItem that begins with the specified text value.

ParameterTypeDescription

text

The text to search for.

Returns: ListViewItem. The first ListViewItem that begins with the specified text value.

Finds the first ListViewItem or ListViewSubItem, if indicated, that begins with the specified text value. The search starts at the specified index.

ParameterTypeDescription

text

The text to search for.

includeSubItemsInSearch

true to include sub-items in the search; otherwise, false.

startIndex

The index of the item at which to start the search.

Returns: ListViewItem. The first ListViewItem that begins with the specified text value.

Throws:

Finds the first ListViewItem or ListViewSubItem, if indicated, that begins with the specified text value. The search starts at the specified index.

ParameterTypeDescription

text

The text to search for.

includeSubItemsInSearch

true to include sub-items in the search; otherwise, false.

startIndex

The index of the item at which to start the search.

isPrefixSearch

true to allow partial matches; otherwise, false.

Returns: ListViewItem. The first ListViewItem that begins with the specified text value.

Throws:

Verifies that the column index refer to a valid column.

ParameterTypeDescription

colIndex

The index of the column to verify.

Returns: Boolean. true if the column index corresponds to a valid column.

Forces a full reload of the data displayed by this ListView.

Forces a full reload of the data displayed by this ListView.

ParameterTypeDescription

refreshChildren

True to also refresh all the children of this control.

Scrolls the specified column into view.

ParameterTypeDescription

column

The ColumnHeaderto scroll into view.

Throws:

Scrolls the specified item into view.

ParameterTypeDescription

item

The item to scroll into view.

Throws:

Selects all items in the ListView.

Sorts the items of the list view.

ParameterTypeDescription

The comparison expression to use when sorting the items. It's optional - if not specified or null, the ItemSorter instance or a default internal comparer is used to compare the items and sort the list.

Causes the control to update the corresponding client side widget. When in design mode, causes the rendered control to update its entire surface in the designer.

Events

LabelEditEventHandler Fired when the label for an item is edited by the user.

LabelEditEventHandler Fired when the user starts editing the label of an item.

CacheVirtualItemsEventHandler Fired when the contents of the display area for a ListView in virtual mode has changed, and the ListView determines that a new range of items is needed.

ColumnClickEventHandler Fired when the user clicks a column header within the list view control.

ColumnClickEventHandler Fired when the user double clicks a column header within the list view control.

ColumnReorderedEventHandler Fired when the column header order is changed.

ColumnWidthChangedEventHandler Fired after the width of a column is successfully changed .

ListViewBindingCompleteEventEventHandler Occurs after a data-binding operation has finished.

EventHandler Fired when value of the DataMember property changes.

EventHandler Fired when the DataSource property changes.

ListViewDataUpdatedEventHandler Fired when the client has updated one or more items in the view.

This event is fired only if the application has attached at least one handler to the event. Otherwise, simply overriding OnDataUpdated won't work.

ItemCheckEventHandler Fired when the check state of an item changes.

ItemCheckedEventHandler Fired when the checked state of an item changes.

ItemClickEventHandler Fired when the item is clicked or tapped.

ItemClickEventHandler Fired when the item is double clicked or tapped.

ListViewItemDragEventHandler Fired when the user begins dragging a ListViewItem.

ItemMouseHoverEventHandler Fired when the pointer hovers over an item.

ItemMouseHoverEventHandler Fired when the pointer leaves an item.

ItemSelectionChangedEventHandler Fired when the selection state of an item changes.

RetrieveVirtualItemEventHandler Fired when the ListView is in virtual mode and requires a ListViewItem.

Throws:

ScrollEventHandler Fired when the user or code scrolls the ListView.

This event fires only if there is an handler attached to it. A simple overload of the On[Event] method in a derived class will not be invoked unless there is at least one handler attached to the event.

SearchForVirtualItemEventHandler Fired when the ListView is in virtual mode and a search is requested.

EventHandler Fired when the SelectedIndices collection changes.

ToolClickEventHandler Fired when a ComponentTool is clicked.

ListViewVirtualItemsSelectionRangeChangedEventHandler Fired when a ListView is in virtual mode and the selection state of a range of items has changed.

Implements

NameDescription

Bindable components implement this interface.

Controls that support drag & drop operations implement this interface.

All wisej components implement this interface.

All wisej controls derived from the Control class must implement this interface.

All wisej data stores implement this interface.

Allows an object to serialize itself.

Last updated