ListView::CheckedListViewItemCollection::IndexOfKey Method (String^)
.NET Framework (current version)
Determines the index for an item with the specified key.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- key
-
Type:
System::String^
The name of the item to retrieve the index for.
Return Value
Type: System::Int32The zero-based index for the ListViewItem with the specified name, if found; otherwise, -1.
| Exception | Condition |
|---|---|
| InvalidOperationException | The owner ListView is in virtual mode. |
The Name property of a ListViewItem corresponds to the key for an item in a ListView::CheckedListViewItemCollection.
The key comparison is not case-sensitive. If the key parameter is null or an empty string, IndexOfKey returns -1.
If IndexOfKey is called successively, the last returned index will be checked for a key match first, and if there is no match, the search starts at the beginning of the collection.
.NET Framework
Available since 2.0
Available since 2.0
Show: