CheckedListBox.CheckedIndexCollection クラス

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

CheckedListBox でチェックされた項目 (不定状態の項目を含む) のインデックスのコレクションをカプセル化します。

public: ref class CheckedListBox::CheckedIndexCollection : System::Collections::IList

public class CheckedListBox.CheckedIndexCollection : System.Collections.IList

type CheckedListBox.CheckedIndexCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class CheckedListBox.CheckedIndexCollection
Implements IList

継承: Object
CheckedListBox.CheckedIndexCollection

実装: ICollection IEnumerable IList

例

次の例では、アイテムのチェック状態を CheckedListBox.CheckedIndexCollection 確認するために、チェックされている項目を列挙します。この例では、メソッドを GetItemCheckState 使用して項目のチェック状態を設定する方法を示します。また、この例では、プロパティをCheckedIndices使用して、を取得CheckedListBox.CheckedIndexCollectionするプロパティを示CheckedListBox.CheckedItemCollectionしますCheckedItems。

最初のループでは、項目の 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	1
1	3
2	4

この CheckedListBox クラスには、格納されているインデックス、プロパティ、 Item[] およびメソッドにアクセスできる 2 つのメンバーがあります IndexOf 。

前の例に基づいて、パラメーター値が 1 のプロパティを Item[] 呼び出すと、値 3 が返されます。パラメーターが 3 の呼び出し IndexOf では、値 1 が返されます。

プロパティ

Count	チェックされている項目の数を取得します。
IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。
Item[Int32]	CheckedListBox コントロール内でチェックされている項目のインデックスを取得します。

メソッド

Contains(Int32)	指定したインデックスがコレクション内にあるかどうかを判断します。
CopyTo(Array, Int32)	コレクション全体を既存の配列内の指定した位置にコピーします。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetEnumerator()	CheckedIndices コレクションを反復処理するために使用できる列挙子を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IndexOf(Int32)	チェックされているインデックスのコレクションへのインデックスを返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

ICollection.IsSynchronized	CheckedListBox.CheckedIndexCollection へのアクセスが同期されている (スレッドセーフである) かどうかを示す値を取得します。
ICollection.SyncRoot	コントロールのコレクションへのアクセスを同期するために使用するオブジェクトを取得します。このメンバーの詳細については、「SyncRoot」をご覧ください。
IList.Add(Object)	この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 CheckedListBox.CheckedIndexCollection に項目を追加します。このメンバーの詳細については、「Add(Object)」をご覧ください。
IList.Clear()	CheckedListBox.CheckedIndexCollection からすべての項目を削除します。このメンバーの詳細については、「Clear()」をご覧ください。
IList.Contains(Object)	指定したインデックスが CheckedListBox.CheckedIndexCollection 内にあるかどうかを確認します。このメンバーの詳細については、「Contains(Object)」をご覧ください。
IList.IndexOf(Object)	このメンバーの詳細については、「IndexOf(Object)」をご覧ください。
IList.Insert(Int32, Object)	このメンバーの詳細については、「Insert(Int32, Object)」をご覧ください。
IList.IsFixedSize	このメンバーの詳細については、「IsFixedSize」をご覧ください。
IList.Item[Int32]	このメンバーの詳細については、「Item[Int32]」をご覧ください。
IList.Remove(Object)	このメンバーの詳細については、「Remove(Object)」をご覧ください。
IList.RemoveAt(Int32)	このメンバーの説明については、RemoveAt(Int32) のトピックを参照してください。

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象