CheckedListBox.CheckedIndexCollection クラス

定義

CheckedListBox でチェックされた項目 (不定状態の項目を含む) のインデックスのコレクションをカプセル化します。Encapsulates the collection of indexes of checked items (including items in an indeterminate state) in a 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
継承
CheckedListBox.CheckedIndexCollection
実装

次の例では、CheckedListBox.CheckedIndexCollection 内のチェックされた項目を列挙して、項目がどのような状態にあるかを確認します。The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. この例では、GetItemCheckState メソッドを使用して項目のチェック状態を設定する方法を示します。The example demonstrates using the GetItemCheckState method to set the check state of an item. また、この例では、CheckedIndices プロパティを使用して CheckedListBox.CheckedIndexCollectionを取得し、CheckedItems プロパティを使用して CheckedListBox.CheckedItemCollectionを取得する方法も示しています。The example also demonstrates using the CheckedIndices property to get the CheckedListBox.CheckedIndexCollection, and the CheckedItems property to get the CheckedListBox.CheckedItemCollection.

最初のループでは、GetItemCheckState メソッドを使用して、項目のインデックスが指定された各チェック項目の CheckState を取得します。The first loop uses the GetItemCheckState method to get the CheckState of each checked item, given the index of the item. 2番目のループでは GetItemCheckStateも使用しますが、ListBox.ObjectCollection.IndexOf メソッドを使用して項目のインデックスを取得します。The second loop also uses GetItemCheckState, but uses the ListBox.ObjectCollection.IndexOf method to retrieve the index for the item.

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

注釈

Checked indexes コレクションは、CheckedListBox コントロール内のすべての項目のコレクションに含まれるインデックスのサブセットです。The checked indexes collection is a subset of the indexes into the collection of all items in the CheckedListBox control. これらのインデックスは、チェックされた状態または未確定の状態の項目を指定します。These indexes specify items in a checked or indeterminate state.

次の表に、コントロール内の項目のインデックス付きコレクション (コントロールに含まれるすべての項目) の例を示します。The following table is an example of the indexed collection of items in the control (all items contained in the control).

インデックスIndex アイテムItem 状態の確認Check State
00 オブジェクト1object 1 Unchecked
11 オブジェクト2object 2 Checked
22 オブジェクト3object 3 Unchecked
33 オブジェクト4object 4 Indeterminate
44 オブジェクト5object 5 Checked

次の表は、前の例に基づいて、チェックされた項目のインデックスのインデックス付きコレクションを示しています。Based on the previous example, the following table shows the indexed collection of indexes of checked items.

インデックスIndex 項目のインデックスIndex of Item
00 11
11 33
22 44

CheckedListBox クラスには、格納されているインデックス、Item[] プロパティ、および IndexOf メソッドにアクセスできる2つのメンバーがあります。The CheckedListBox class has two members that allow you to access the stored indexes, the Item[] property and the IndexOf method.

前の例に基づいて、パラメーター値が1の Item[] プロパティを呼び出すと、値3が返されます。Based on the previous example, a call to the Item[] property with a parameter value of 1 returns a value of 3. パラメーターが3の IndexOf を呼び出すと、値1が返されます。A call to IndexOf with a parameter of 3 returns a value of 1.

プロパティ

Count

チェックされている項目の数を取得します。Gets the number of checked items.

IsReadOnly

コレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the collection is read-only.

Item[Int32]

CheckedListBox コントロール内でチェックされている項目のインデックスを取得します。Gets the index of a checked item in the CheckedListBox control.

メソッド

Contains(Int32)

指定したインデックスがコレクション内にあるかどうかを判断します。Determines whether the specified index is located in the collection.

CopyTo(Array, Int32)

コレクション全体を既存の配列内の指定した位置にコピーします。Copies the entire collection into an existing array at a specified location within the array.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetEnumerator()

CheckedIndices コレクションを反復処理するために使用できる列挙子を返します。Returns an enumerator that can be used to iterate through the CheckedIndices collection.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IndexOf(Int32)

チェックされているインデックスのコレクションへのインデックスを返します。Returns an index into the collection of checked indexes.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

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

ICollection.IsSynchronized

CheckedListBox.CheckedIndexCollection へのアクセスが同期されるかどうか (スレッド セーフかどうか) を示す値を取得します。Gets a value indicating whether access to the CheckedListBox.CheckedIndexCollection is synchronized (thread safe).

ICollection.SyncRoot

コントロールのコレクションへのアクセスを同期するために使用できるオブジェクトを取得します。Gets an object that can be used to synchronize access to the collection of controls. このメンバーの詳細については、「SyncRoot」をご覧ください。For a description of this member, see SyncRoot.

IList.Add(Object)

CheckedListBox.CheckedIndexCollection にアイテムを追加します。Adds an item to the CheckedListBox.CheckedIndexCollection. このメンバーの詳細については、「Add(Object)」をご覧ください。For a description of this member, see Add(Object).

IList.Clear()

CheckedListBox.CheckedIndexCollection からすべての項目を削除します。Removes all items from the CheckedListBox.CheckedIndexCollection. このメンバーの詳細については、「Clear()」をご覧ください。For a description of this member, see Clear().

IList.Contains(Object)

指定したインデックスが CheckedListBox.CheckedIndexCollection 内にあるかどうかを確認します。Determines whether the specified index is located within the CheckedListBox.CheckedIndexCollection. このメンバーの詳細については、「Contains(Object)」をご覧ください。For a description of this member, see Contains(Object).

IList.IndexOf(Object)

このメンバーの詳細については、「IndexOf(Object)」をご覧ください。For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

このメンバーの詳細については、「Insert(Int32, Object)」をご覧ください。For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

このメンバーの詳細については、「IsFixedSize」をご覧ください。For a description of this member, see IsFixedSize.

IList.Item[Int32]

このメンバーの詳細については、「Item[Int32]」をご覧ください。For a description of this member, see Item[Int32].

IList.Remove(Object)

このメンバーの詳細については、「Remove(Object)」をご覧ください。For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

このメンバーの説明については、RemoveAt(Int32) のトピックを参照してください。or a description of this member, see RemoveAt(Int32).

拡張メソッド

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください