CheckedListBox.CheckedItemCollection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
チェックされた項目 (不定状態の項目を含む) のコレクションを CheckedListBox コントロール内にカプセル化します。
public: ref class CheckedListBox::CheckedItemCollection : System::Collections::IList
public class CheckedListBox.CheckedItemCollection : System.Collections.IList
type CheckedListBox.CheckedItemCollection = class
interface IList
interface ICollection
interface IEnumerable
Public Class CheckedListBox.CheckedItemCollection
Implements IList
- 継承
-
CheckedListBox.CheckedItemCollection
- 実装
例
次の例では、項目のチェック状態を確認するために、 CheckedListBox.CheckedIndexCollection チェック された項目を列挙します。 この例では、メソッドを GetItemCheckState 使用して項目のチェック状態を設定する方法を示します。 この例では、プロパティをCheckedIndices使用して 、およびプロパティをCheckedItems取得CheckedListBox.CheckedIndexCollectionCheckedListBox.CheckedItemCollectionする方法も示しています。
最初のループでは、項目の GetItemCheckState インデックスを指定して、チェックされた各項目のメソッドを使用して取得 CheckState します。 2 番目のループも使用 GetItemCheckStateしますが、メソッドを ListBox.ObjectCollection.IndexOf 使用して項目のインデックスを取得します。
void WhatIsChecked_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Display in a message box all the items that are checked.
// First show the index and check state of all selected items.
IEnumerator^ myEnum1 = checkedListBox1->CheckedIndices->GetEnumerator();
while ( myEnum1->MoveNext() )
{
Int32 indexChecked = *safe_cast<Int32^>(myEnum1->Current);
// The indexChecked variable contains the index of the item.
MessageBox::Show( String::Concat( "Index#: ", indexChecked, ", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( indexChecked ), "." ) );
}
// Next show the Object* title and check state for each item selected.
IEnumerator^ myEnum2 = checkedListBox1->CheckedItems->GetEnumerator();
while ( myEnum2->MoveNext() )
{
Object^ itemChecked = safe_cast<Object^>(myEnum2->Current);
// Use the IndexOf method to get the index of an item.
MessageBox::Show( String::Concat( "Item with title: \"", itemChecked, "\", is checked. Checked state is: ", checkedListBox1->GetItemCheckState( checkedListBox1->Items->IndexOf( itemChecked ) ), "." ) );
}
}
private void WhatIsChecked_Click(object sender, System.EventArgs e) {
// Display in a message box all the items that are checked.
// First show the index and check state of all selected items.
foreach(int indexChecked in checkedListBox1.CheckedIndices) {
// The indexChecked variable contains the index of the item.
MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" +
checkedListBox1.GetItemCheckState(indexChecked).ToString() + ".");
}
// Next show the object title and check state for each item selected.
foreach(object itemChecked in checkedListBox1.CheckedItems) {
// Use the IndexOf method to get the index of an item.
MessageBox.Show("Item with title: \"" + itemChecked.ToString() +
"\", is checked. Checked state is: " +
checkedListBox1.GetItemCheckState(checkedListBox1.Items.IndexOf(itemChecked)).ToString() + ".");
}
}
Private Sub WhatIsChecked_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles WhatIsChecked.Click
' Display in a message box all the items that are checked.
Dim indexChecked As Integer
Dim itemChecked As Object
Const quote As String = """"
' First show the index and check state of all selected items.
For Each indexChecked In CheckedListBox1.CheckedIndices
' The indexChecked variable contains the index of the item.
MessageBox.Show("Index#: " + indexChecked.ToString() + ", is checked. Checked state is:" + _
CheckedListBox1.GetItemCheckState(indexChecked).ToString() + ".")
Next
' Next show the object title and check state for each item selected.
For Each itemChecked In CheckedListBox1.CheckedItems
' Use the IndexOf method to get the index of an item.
MessageBox.Show("Item with title: " + quote + itemChecked.ToString() + quote + _
", is checked. Checked state is: " + _
CheckedListBox1.GetItemCheckState(CheckedListBox1.Items.IndexOf(itemChecked)).ToString() + ".")
Next
End Sub
注釈
チェックされたアイテム コレクションは、コントロール内 CheckedListBox のすべての項目のサブセットであり、チェック状態または不確定状態のアイテムのみが含まれます。
次の表は、コントロール内の項目 (コントロールに含まれるすべての項目) のインデックス付きコレクションの例です。
インデックス | 項目 | 状態の確認 |
---|---|---|
0 | オブジェクト 1 | Unchecked |
1 | オブジェクト 2 | Checked |
2 | オブジェクト 3 | Unchecked |
3 | オブジェクト 4 | Indeterminate |
4 | オブジェクト 5 | Checked |
前の例に基づいて、次の表に、チェック された項目のインデックス付きコレクションを示します。
インデックス | アイテム |
---|---|
0 | オブジェクト 2 |
1 | オブジェクト 4 |
2 | オブジェクト 5 |
この CheckedListBox クラスには、格納されているインデックス、プロパティ、 Item[] およびメソッドにアクセスできる 2 つのメンバーがあります IndexOf 。
前の例に基づいて、パラメーター値が 1 のプロパティを Item[] 呼び出すと、オブジェクト 4 が返されます。 オブジェクト 4 のパラメーターを IndexOf 持つ呼び出しは、値 1 を返します。
プロパティ
Count |
コレクション内の項目の数を取得します。 |
IsReadOnly |
コレクションが読み取り専用かどうかを示す値を取得します。 |
Item[Int32] |
チェックされている項目のコレクション内のオブジェクトを取得します。 |
メソッド
Contains(Object) |
指定した項目がコレクション内にあるかどうかを判断します。 |
CopyTo(Array, Int32) |
コレクション全体を既存の配列内の指定した位置にコピーします。 |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetEnumerator() |
CheckedItems コレクションを反復処理するために使用できる列挙子を返します。 |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
IndexOf(Object) |
チェックされている項目のコレクションへのインデックスを返します。 |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
ICollection.IsSynchronized |
このメンバーの詳細については、「IsSynchronized」をご覧ください。 |
ICollection.SyncRoot |
このメンバーの詳細については、「SyncRoot」をご覧ください。 |
IList.Add(Object) |
このメンバーの詳細については、「Add(Object)」をご覧ください。 |
IList.Clear() |
このメンバーの詳細については、「Clear()」をご覧ください。 |
IList.Insert(Int32, Object) |
このメンバーの詳細については、「Insert(Int32, Object)」をご覧ください。 |
IList.IsFixedSize |
このメンバーの詳細については、「IsFixedSize」をご覧ください。 |
IList.Remove(Object) |
このメンバーの詳細については、「Remove(Object)」をご覧ください。 |
IList.RemoveAt(Int32) |
このメンバーの詳細については、「RemoveAt(Int32)」をご覧ください。 |
拡張メソッド
Cast<TResult>(IEnumerable) |
IEnumerable の要素を、指定した型にキャストします。 |
OfType<TResult>(IEnumerable) |
指定された型に基づいて IEnumerable の要素をフィルター処理します。 |
AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
AsQueryable(IEnumerable) |
IEnumerable を IQueryable に変換します。 |