ListView

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

The Wisej.Web.ListView is a control used to display a list of items through one of four predefined views.

For a full list of properties, methods and events see the API documentation.

Features

Data Binding

Data binding is fully supported, including formatting and conversion of the value, through the default data binding infrastructure.

Virtual Mode

Setting the VirtualMode property to true puts the ListView into virtual mode. In Virtual mode, the normal Items collection is unused. Instead, items are created dynamically as the ListView requires them.

Virtual mode can be useful under many circumstances. If a ListView object must be populated from a very large collection already in memory, creating a ListViewItem object for each entry can be wasteful. In virtual mode, only the items required are created. In other cases, the values of the ListViewItem objects may need to be recalculated frequently, and doing this for the whole collection would produce unacceptable performance. In virtual mode, only the required items are calculated.

In order to use virtual mode, you must handle the RetrieveVirtualItem event, which is raised every time the ListView requires an item. This event handler should create the ListViewItem object that belongs at the specified index. In addition, the VirtualListSize property must be set to the size of the virtual list.

Views

The ListView control contains four main views for displaying list items: LargeIcon, SmallIcon, Details, and Tile.

LargeIcon

  • Each item appears as a fully-sized icon with a label below it.

SmallIcon

  • Each item appears as a small icon with a label to its right.

Details

  • Each item appears on a separate line with further information about each item arranged in columns.

Tile

  • Each item appears as a full-sized icon with the item label and sub item information below the label.

Advanced

JavaScript Widget

ItemDescription

Class name

wisej.web.ListView

Theme appearance

"listview" is the entire widget, "item-view" is the container for the items, "grid-view" is the container for the items when the view is "Details", "grid-row" is the item when the view is "Details", "grid-cell" is one cell in the grid when view is "Details", "item" is the list item, "tools" is the container for the tool icons. See Themes.

Child components

ToolContainer state

"listview", see Embedded Tools.

Source code

Last updated