CheckedListBox.CheckedItemCollection クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CheckedListBox.CheckedItemCollection クラス

CheckedListBox コントロールでチェックされている項目 (中間状態の項目を含む) のコレクションをカプセル化します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class CheckedItemCollection
    Implements IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As CheckedItemCollection

public class CheckedItemCollection : IList,
 ICollection, IEnumerable

C++

public ref class CheckedItemCollection : IList,
 ICollection, IEnumerable

public class CheckedItemCollection implements
 IList, ICollection, 
    IEnumerable

JScript

public class CheckedItemCollection implements
 IList, ICollection, 
    IEnumerable

解説

チェックされている項目のコレクションは、CheckedListBox コントロール内のすべての項目のサブセットです。チェックされている項目、または中間状態の項目だけを格納しています。

コントロールの項目 (コントロールに含まれるすべての項目) のインデックス付きコレクションの例を次の表に示します。

インデックス	項目	チェックの状態
0	オブジェクト 1	Unchecked
1	オブジェクト 2	Checked
2	オブジェクト 3	Unchecked
3	オブジェクト 4	Indeterminate
4	オブジェクト 5	Checked

前の例に基づいて、チェックされている項目のインデックス付きコレクションを次の表に示します。

インデックス	項目
0	オブジェクト 2
1	オブジェクト 4
2	オブジェクト 5

CheckedListBox クラスは、格納されたインデックス、Item プロパティ、および IndexOf メソッドにアクセスできる 2 つのメンバを保持しています。

上の例に基づいて、パラメータを値 1 に設定して Item プロパティを呼び出すと、オブジェクト 4 が返されます。オブジェクト 4 のパラメータを設定して IndexOf を呼び出すと、値 1 が返されます。

使用例

CheckedListBox.CheckedIndexCollection 内のチェック項目を列挙して各項目のチェック状態を調べる方法を次の例に示します。この例では、GetItemCheckState メソッドを使用して項目のチェック状態を取得します。この例では、CheckedIndices プロパティを使用して CheckedListBox.CheckedIndexCollection を取得し、CheckedItems プロパティを使用して CheckedListBox.CheckedItemCollection を取得する方法についても示します。

最初のループでは、項目のインデックスを基に、GetItemCheckState メソッドを使用して、各チェック項目の CheckState を取得します。2 番目のループでは GetItemCheckState も使用しますが、項目のインデックスの取得には ListBox.ObjectCollection.IndexOf メソッドを使用します。

Visual Basic

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

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()
 + ".");
    }

}

C++

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.
    IEnumerator objEnum = checkedListBox1.get_CheckedIndices().
        GetEnumerator();

    while (objEnum.MoveNext()) {
        int indexChecked = (int)(Int32)(objEnum.get_Current());

        // The indexChecked variable contains the index of the item.
        MessageBox.Show("Index#: " + (Int32)indexChecked 
            + ", is checked. Checked state is:" 
            + checkedListBox1.GetItemCheckState(indexChecked).ToString() 
            + ".");
    }

    // Next show the object title and check state for each item selected.
    for (int iCtr = 0; 
        iCtr < checkedListBox1.get_CheckedItems().get_Count(); 
        iCtr++) {
        Object itemChecked = 
            checkedListBox1.get_CheckedItems().get_Item(iCtr);

        // 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.get_Items().IndexOf(itemChecked)).ToString() 
            + ".");
    }
} //whatIsChecked_Click