Export (0) Print
Expand All

ListView.CheckedListViewItemCollection Class

Represents the collection of checked items in a list view control.

System.Object
  System.Windows.Forms.ListView.CheckedListViewItemCollection

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[ListBindableAttribute(false)]
public class CheckedListViewItemCollection : IList, 
	ICollection, IEnumerable

The ListView.CheckedListViewItemCollection type exposes the following members.

  NameDescription
Public methodListView.CheckedListViewItemCollectionInitializes a new instance of the ListView.CheckedListViewItemCollection class.
Top

  NameDescription
Public propertyCountGets the number of items in the collection.
Public propertyIsReadOnlyGets a value indicating whether the collection is read-only.
Public propertyItem[Int32]Gets the item at the specified index within the collection.
Public propertyItem[String]Gets an item with the specified key within the collection.
Top

  NameDescription
Public methodContainsDetermines whether the specified item is located in the collection.
Public methodContainsKeyDetermines if a column with the specified key is contained in the collection.
Public methodCopyToCopies the entire collection into an existing array at a specified location within the array.
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetEnumeratorReturns an enumerator that can be used to iterate through the checked item collection.
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodIndexOfReturns the index within the collection of the specified item.
Public methodIndexOfKeyDetermines the index for an item with the specified key.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public Extension MethodAsParallelEnables parallelization of a query. (Defined by ParallelEnumerable.)
Public Extension MethodAsQueryableConverts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension MethodCast<TResult>Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension MethodOfType<TResult>Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)
Top

  NameDescription
Explicit interface implemetationPrivate propertyICollection.IsSynchronizedInfrastructure. Gets a value indicating whether access to the ListView.CheckedListViewItemCollection is synchronized (thread safe).
Explicit interface implemetationPrivate propertyICollection.SyncRootInfrastructure. Gets an object that can be used to synchronize access to the collection of controls.
Explicit interface implemetationPrivate methodIList.AddInfrastructure. Adds an item to the collection.
Explicit interface implemetationPrivate methodIList.ClearInfrastructure. Removes all items from the collection.
Explicit interface implemetationPrivate methodIList.ContainsInfrastructure. Verifies whether the item is checked.
Explicit interface implemetationPrivate methodIList.IndexOfInfrastructure. Returns the index within the collection of the specified item.
Explicit interface implemetationPrivate methodIList.InsertInfrastructure. Inserts an item into the collection at a specified index.
Explicit interface implemetationPrivate propertyIList.IsFixedSizeInfrastructure. Gets a value indicating whether the collection has a fixed size.
Explicit interface implemetationPrivate propertyIList.ItemInfrastructure. Gets or sets an object from the collection.
Explicit interface implemetationPrivate methodIList.RemoveInfrastructure. Removes the first occurrence of an item from the collection.
Explicit interface implemetationPrivate methodIList.RemoveAtInfrastructure. Removes an item from the collection at the specified index.
Top

A ListView.CheckedListViewItemCollection stores the checked items in a ListView control. Items can only be checked if the CheckBoxes property of the ListView control is set to true. The items stored in the ListView.CheckedListViewItemCollection are items contained in the ListView.ListViewItemCollection. The ListView.ListViewItemCollection class stores all items displayed in the ListView control.

The following table shows an example of how the ListView.ListViewItemCollection stores the items of the ListView as well as their selection states in an example ListView control.

Index

Item

Checked state in the ListView

0

Item1

Unchecked

1

Item2

Checked

2

Item3

Unchecked

3

Item4

Checked

4

Item5

Checked

Based on the ListView.ListViewItemCollection example in the previous table, the following table demonstrates how the ListView.CheckedListViewItemCollection would appear.

Index

Checked item in ListViewItemCollection

0

Item2

1

Item4

2

Item5

You can use the properties and methods of this class to perform a variety of tasks with the collection. The Contains method enables you to determine whether an item from the ListView.ListViewItemCollection class is a member of the ListView.CheckedListViewItemCollection. Once you know that the item is in the collection, you can use the IndexOf method to determine the position of the item in the ListView.CheckedListViewItemCollection.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft