ListView.ListViewItemCollection

Wisej.Web.ListView ListViewItemCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents the collection of items in a ListView control.

C#

public class ListViewItemCollection : IList, ICollection, IEnumerable, IList<ListViewItem>, ICollection<ListViewItem>, IEnumerable<ListViewItem>

VB.NET

Public Class ListViewItemCollection
    Inherits IList
    Implements ICollection, IEnumerable, IList(Of ListViewItem), ICollection(Of ListViewItem), IEnumerable(Of ListViewItem)

Properties

Count

Int32: Returns the total number of items in the collection.

IsReadOnly

Boolean: Returns a value indicating whether the collection is read-only.

Item(index)

ListViewItem: Returns or sets the item at the specified index in the collection.

Throws:

• ArgumentOutOfRangeException The index value is less than 0 or is greater than the number of items in the collection.

Item(key)

ListViewItem: Returns the item with the specified key from the collection.

Methods

Add(text)

Adds a new item with the specified label text to the end of the current collection.

Parameter	Type	Description
text	String	The label text displayed by the ListViewItem.

Returns: ListViewItem. A ListViewItem that represents the item being added to the collection.

Add(key, text)

Creates a new item with the specified key and text, and adds it to the collection.

Parameter	Type	Description
key	String	The name of the ListViewItem.
text	String	The text to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was added to the collection.

Add(key, text, imageIndex)

Creates a new item with the specified key, text, and image, and adds it to the collection.

Parameter	Type	Description
key	String	The name of the ListViewItem.
text	String	The text to display in the ListViewItem.
imageIndex	Int32	The index of the image to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was added to the collection.

Add(key, text, imageKey)

Creates a new item with the specified key, text, and image, and adds it to the collection.

Parameter	Type	Description
key	String	The name of the item.
text	String	The text to display in the ListViewItem.
imageKey	String	The image to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was added to the collection.

Add(item)

Adds a previously created item to the end of the collection.

Parameter	Type	Description
item	ListViewItem	The ListViewItem to add to the collection.

Returns: Int32. The zero-based index value of the ListViewItem added to the collection.

Throws:

• ArgumentException The item is currently assigned to another ListView.

AddRange(items)

Adds an array of previously created items to the collection.

Parameter	Type	Description
items	ListViewItem[]	An array of ListViewItem objects representing the items to add to the collection.

Throws:

• ArgumentNullExceptionitems is null.
• ArgumentExceptionitems is the child of another ListViewItem.

Clear()

Removes all items from the collection.

Clear(dispose)

Removes all items from the collection and optionally disposes them.

Parameter	Type	Description
dispose	Boolean	Indicates whether the removed items should be disposed.

Contains(item)

Determines whether the specified item is a member of the collection.

Parameter	Type	Description
item	ListViewItem	The ListViewItem to locate in the collection.

Returns: Boolean. true if the ListViewItem is a member of the collection; otherwise, false.

ContainsKey(key)

Determines whether the collection contains an item with the specified key.

Parameter	Type	Description
key	String	The name of the ListViewItem to search for.

Returns: Boolean. true to indicate the collection contains a ListViewItem with the specified key; otherwise, false.

CopyTo(dest, index)

Copies the entire collection into an existing array at a specified location within the array.

Parameter	Type	Description
dest	Array	The destination array.
index	Int32	The index in the destination array at which storing begins.

GetEnumerator()

Returns an enumerator that can be used to iterate through the collection.

Returns: IEnumerator<ListViewItem>. An IEnumerator that represents the ListViewItemCollection.

IndexOf(item)

Returns the index of the specified item in the collection.

Parameter	Type	Description
item	ListViewItem	The ListViewItem to locate in the collection.

Returns: Int32. The zero-based index of the item found in the ListViewItemCollection; otherwise, -1.

IndexOfKey(key)

Returns the index of the first occurrence of a item with the specified key.

Parameter	Type	Description
key	String	The name of the ListViewItem to search for.

Returns: Int32. The zero-based index of the first occurrence of a ListViewItem with the specified key, if found; otherwise, -1.

Insert(index, item)

Inserts an existing item into the collection at the specified location.

Parameter	Type	Description
index	Int32	The indexed location within the collection to insert the item.
item	ListViewItem	The ListViewItemCollection to insert into the collection.

Throws:

• ArgumentException The item is currently assigned to another ListView.

Insert(index, text)

Creates a new item with the specified text and inserts it at the specified index.

Parameter	Type	Description
index	Int32	The location within the collection to insert the ListViewItem.
text	String	The text to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was inserted in the collection.

Insert(index, key, text)

Creates a new item with the specified text and key, and inserts it into the collection.

Parameter	Type	Description
index	Int32	The location within the collection to insert the ListViewItem.
key	String	The name of the ListViewItem.
text	String	The text to display in theListViewItem.

Returns: ListViewItem. The ListViewItem that was inserted in the collection.

Insert(index, key, text, imageIndex)

Creates a new item with the specified key, text, and image, and inserts it into the collection at the specified index.

Parameter	Type	Description
index	Int32	The location within the collection to insert the ListViewItem.
key	String	The name of the ListViewItem.
text	String	The text to display in the ListViewItem.
imageIndex	Int32	The index of the image to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was inserted in the collection.

Insert(index, key, text, imageKey)

Creates a new item with the specified key, text, and image, and inserts it into the collection at the specified index.

Parameter	Type	Description
index	Int32	The location within the collection to insert the ListViewItem.
key	String	The name of the ListViewItem.
text	String	The text to display in the ListViewItem.
imageKey	String	The key of the image to display in the ListViewItem.

Returns: ListViewItem. The ListViewItem that was inserted in the collection.

OnCollectionChanged(action, element)

Fires the CollectionChanged event.

Parameter	Type	Description
action	CollectionChangeAction	One of CollectionChangeAction indicating the reason the collection has changed.
element	Object	The element that was added or removed from the collection, or null.

Remove(item)

Removes the specified item from the collection.

Parameter	Type	Description
item	ListViewItem	The ListViewItem to remove.

RemoveAt(index)

Removes the item from the collection at a specified index.

Parameter	Type	Description
index	Int32	The index of the ListViewItem to remove.

RemoveByKey(key)

Removes the item with the specified key from the collection.

Parameter	Type	Description
key	String	The name of the ListViewItem to remove from the collection.

Events

CollectionChanged

CollectionChangeEventHandler Fired when the collection changes.