CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection CheckedListBox.CheckedItemCollection Class

定義

チェックされた項目 (不定状態の項目を含む) のコレクションを CheckedListBox コントロール内にカプセル化します。Encapsulates the collection of checked items, including items in an indeterminate state, in a CheckedListBox control.

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.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollectionCheckedListBox.CheckedItemCollection
実装

次の例では、内のチェック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

注釈

チェックされた項目のコレクションは、 CheckedListBoxコントロール内のすべての項目のサブセットであり、checked または未確定の状態にある項目のみが含まれています。The checked items collection is a subset of all items in the CheckedListBox control; it contains only those items that are 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 the checked items.

インデックスIndex アイテムItem
00 オブジェクト2object 2
11 オブジェクト4object 4
22 オブジェクト5object 5

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

前の例に基づいて、パラメーター値がItem[Int32] 1 のプロパティを呼び出すと、オブジェクト4が返されます。Based on the previous example, a call to the Item[Int32] property with a parameter value of 1 returns object 4. Object 4 のIndexOfパラメーターを指定してを呼び出すと、値1が返されます。A call to IndexOf with a parameter of object 4 returns a value of 1.

プロパティ

Count Count Count Count

コレクション内の項目の数を取得します。Gets the number of items in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

チェックされている項目のコレクション内のオブジェクトを取得します。Gets an object in the checked items collection.

メソッド

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

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

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Object) IndexOf(Object) IndexOf(Object) IndexOf(Object)

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

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

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

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

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

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

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

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

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

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

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

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

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

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

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

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

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

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

拡張メソッド

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

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

適用対象