ListView
Wisej.Web.ListView
Last updated
Wisej.Web.ListView
Last updated
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.
Initializes a new instance of the ListView class.
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:
ArgumentException The assigned value does not implement the IList or IListSource interfaces.
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:
ArgumentException VirtualListSize is set to a value less than 0.
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.
Populates the DataGridView from the data appending the rows to the existing rows.
| Parameter | Type | Description |
|---|---|---|
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.
| Parameter | Type | Description |
|---|---|---|
columnIndex | The zero-based index of the column to resize. | |
headerAutoResize | One of the ColumnHeaderAutoResizeStyle values. |
Throws:
ArgumentOutOfRangeException columnIndex is greater than 0 when Columns is null-or- columnIndex is less than 0 or greater than the number of columns set.
Resizes the width of the columns as indicated by the resize style.
| Parameter | Type | Description |
|---|---|---|
headerAutoResize | One of the ColumnHeaderAutoResizeStyle values. |
Throws:
InvalidOperationException AutoResizeColumn is called with a value other than None when View is not set to Details.
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.
| Parameter | Type | Description |
|---|---|---|
index | The zero-based index of the item to scroll into view. |
Throws:
ArgumentOutOfRangeException index is less than 0 or greater than the last item's index.
Populates the ListView from the data .
| Parameter | Type | Description |
|---|---|---|
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.
| Parameter | Type | Description |
|---|---|---|
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.
| Parameter | Type | Description |
|---|---|---|
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:
ArgumentOutOfRangeException startIndex is less 0 or more than the number items in the ListView.
Finds the first ListViewItem or ListViewSubItem, if indicated, that begins with the specified text value. The search starts at the specified index.
| Parameter | Type | Description |
|---|---|---|
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:
ArgumentOutOfRangeException startIndex is less than 0 or more than the number of items in the ListView.
Verifies that the column index refer to a valid column.
| Parameter | Type | Description |
|---|---|---|
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.
| Parameter | Type | Description |
|---|---|---|
refreshChildren | True to also refresh all the children of this control. |
Scrolls the specified column into view.
| Parameter | Type | Description |
|---|---|---|
column | The ColumnHeaderto scroll into view. |
Throws:
ArgumentNullException column is null.
ArgumentException column belong to a different ListView.
Scrolls the specified item into view.
| Parameter | Type | Description |
|---|---|---|
item | The item to scroll into view. |
Throws:
ArgumentNullException item is null.
ArgumentException item belong to a different ListView.
Selects all items in the ListView.
Sorts the items of the list view.
| Parameter | Type | Description |
|---|---|---|
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.
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:
InvalidOperationException The Item property is not set to an item when the RetrieveVirtualItem event is handled.
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.
| Name | Description |
|---|---|
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. |
dataMember
dataMember
comparison
