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
Item | Description |
---|---|
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 | See JavaScript. |
ToolContainer state | "listview", see Embedded Tools. |
Source code |
Last updated