ListView
Wisej.Web.ListView
Last updated
Was this helpful?
Wisej.Web.ListView
Last updated
Was this helpful?
Namespace: Wisej.Web
Assembly: Wisej.Framework (4.0.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
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.
Padding: Returns the default value for the ItemPadding property.
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:
ArgumentExceptionVirtualListSize 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.
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:
ArgumentOutOfRangeExceptioncolumnIndex 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.
headerAutoResize
Throws:
InvalidOperationExceptionAutoResizeColumn 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.
Disposes the control and all the owned columns.
disposing
true when this method is called by the application rather than a finalizer.
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.
index
The zero-based index of the item to scroll into view.
Throws:
ArgumentOutOfRangeExceptionindex 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:
ArgumentOutOfRangeExceptionstartIndex 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:
ArgumentOutOfRangeExceptionstartIndex 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.
Returns a collection of referenced components or collection of components.
items
Fires the AfterLabelEdit event.
e
Fires the BeforeLabelEdit event.
e
Fires the BindingContextChanged event.
e
Fires the CacheVirtualItems event.
e
Fires the ColumnClick event.
e
Fires the ColumnDoubleClick event.
e
Fires the ColumnReordered event.
e
Fires the ColumnWidthChanged event.
e
Fires the DataBindingComplete event.
e
Fires the DataMemberChanged event.
e
Fires the DataSourceChanged event.
e
Fires the DataUpdated event.
e
Fires the ItemCheck event.
e
Fires the ItemChecked event.
e
Fires the ItemClick event.
e
Fires the ItemDoubleClick event.
e
Fires the ItemDrag event.
e
Fires the ItemMouseHover event.
e
Fires the ItemMouseLeave event.
e
Fires the ItemSelectionChanged event.
e
Fires the KeyDown event.
e
Fires the MouseUp event.
e
Fires the RetrieveVirtualItem event.
e
Fires the Scroll event.
e
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.
Fires the SearchForVirtualItem event.
e
Fires the SelectedIndexChanged event.
e
Fires the ToolClick event.
e
Fires the VirtualItemsSelectionRangeChanged event.
e
Returns the number of available data rows.
Returns: Int32.
Returns the data requested by the client.
firstIndex
The index of the first requested row.
lastIndex
The index of the last requested row.
sortDirection
The sort direction.
sortIndex
The index of the sorted column. Can be -1 if there is no sorted column.
Returns: Object.
Processes the event from the client.
e
Event arguments.
Renders the client component.
config
Dynamic configuration object.
Updates the client component using the state information.
state
Dynamic state object.
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.
Resynchronizes the item data with the contents of the data source.
index
Resynchronizes the item data with the contents of the data source.
Scrolls the specified column into view.
column
Throws:
ArgumentNullExceptioncolumn is null.
ArgumentExceptioncolumn belong to a different ListView.
Scrolls the specified item into view.
item
The item to scroll into view.
Throws:
ArgumentNullExceptionitem is null.
ArgumentExceptionitem 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.
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.
Provides access to the UserData
and Tag
properties associated to the component implementing this interface.
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.
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.
One of the values.
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.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
The that contains the event data.
A that contains the event data.
A that contains the event data.
An that contains the event data.
A that contains the event data.
A that contains the event data.
An that contains the event data.
An that contains the event data.
A that contains the event data.
A that contains the event data.
An that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
A that contains the event data.
An that contains the event data.
A that contains the event data.
A that contains the event data.
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.
All wisej controls derived from the class must implement this interface.