ListView
Wisej.Web.ListView
Last updated
Was this helpful?
Wisej.Web.ListView
Last updated
Was this helpful?
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.
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
)
ColumnHeaderStyle: Returns or sets the column header style. (Default: Clickable
)
Boolean: Returns whether the horizontal scroll bar is visible.
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
)
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
)
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
)
Boolean: Returns or sets whether ToolTips are shown for the ListViewItem objects contained in the ListView. (Default: False
)
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.
Populates the DataGridView from the data appending the rows to the existing rows.
data
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.
columnIndex
The zero-based index of the column to resize.
headerAutoResize
Throws:
Resizes the width of the columns as indicated by the resize style.
headerAutoResize
Throws:
Removes all items and columns from the control.
Clears the current selection.
Ensures that the specified item is visible within the control, scrolling the contents of the control if necessary.
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 .
data
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.
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.
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.
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.
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.
refreshChildren
True to also refresh all the children of this control.
Scrolls the specified column into view.
column
Throws:
ArgumentNullException column is null.
ArgumentException column belong to a different ListView.
Scrolls the specified item into view.
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.
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.
ListViewDataUpdatedEventHandler Fired when the client has updated one or more items in the view.
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.
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.
Bindable components implement this interface.
Controls that support drag & drop operations implement this interface.
All wisej components implement this interface.
All wisej data stores implement this interface.
Allows an object to serialize itself.
String: Returns or sets the property to display in the . (Default: ""
)
GridLineStyle: Returns or sets the cell border style for the ListView control when its property is set to Details and the property is set to true. (Default: Vertical
)
String: Returns or sets the property to use as the icon for the . (Default: ""
)
Padding: Returns or sets the padding inside ListViewItem objects in any mode.
ImageList: Returns or sets the ImageList to use to display the icon in the ListViewItem elements when the is set to or . (Default: null
)
If is not set, Wisej will use and scale the icons.
Setting the property 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.
When in view, the behaves as the . The DataGridView that renders the details view supports only the property true or false and uses the property to determine how elements of the grid are selected, which is always set to when use inside the ListView.
ImageList: Returns or sets the ImageList to use to display the icon in the ListViewItem elements when the is set to or . (Default: null
)
If is not set, Wisej will use and scale the icons.
ArgumentException is set to a value less than 0.
The object that contains data for the to display.
dataMember
The name of the table or list in the data object for which the should load the items.
One of the values.
ArgumentOutOfRangeException columnIndex is greater than 0 when is null-or- columnIndex is less than 0 or greater than the number of columns set.
One of the values.
InvalidOperationException is called with a value other than when is not set to .
Prevents the control from updating until the method is called.
Resumes updating of the list view control after suspending it by the method.
The object that contains data for the to display.
dataMember
The name of the table or list in the data object for which the should load the items.
The to scroll into view.
comparison
The comparison expression to use when sorting the items. It's optional - if not specified or null, the instance or a default internal comparer is used to compare the items and sort the list.
EventHandler Fired when value of the property changes.
EventHandler Fired when the property changes.
This event is fired only if the application has attached at least one handler to the event. Otherwise, simply overriding won't work.
InvalidOperationException The property is not set to an item when the event is handled.
EventHandler Fired when the collection changes.
All wisej controls derived from the class must implement this interface.