CheckedListBox.CheckedItems CheckedListBox.CheckedItems CheckedListBox.CheckedItems CheckedListBox.CheckedItems Property

定義

この CheckedListBox 内でチェックされている項目のコレクション。Collection of checked items in this CheckedListBox.

public:
 property System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ CheckedItems { System::Windows::Forms::CheckedListBox::CheckedItemCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.CheckedListBox.CheckedItemCollection CheckedItems { get; }
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollection
Public ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollection

プロパティ値

次の例では、内のチェックCheckedListBox.CheckedIndexCollectionされた項目を列挙して、項目がどのような状態であるかを確認します。The following example enumerates the checked items in the CheckedListBox.CheckedIndexCollection to see what check state an item is in. この例では、 CheckedIndicesプロパティを使用しCheckedListBox.CheckedIndexCollectionてを取得CheckedItemsする方法と、 CheckedListBox.CheckedItemCollectionプロパティを使用してを取得する方法を示します。The example 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.

この例を実行するには、次の手順を実行します。To run this example, perform the following steps:

  1. 新しい Windows フォーム アプリケーションを作成します。Create a new Windows Forms application.

  2. フォームに CheckedListBox および Button を追加します。Add a CheckedListBox and a Button to the form.

  3. ボタンWhatIsCheckedに名前を指定し、そのClickイベントのハンドラーを追加して、次のハンドラーの本文からコードをコピーします。Name the button WhatIsChecked, add a handler for its Click event, and copy in the code from the body of the following handler.

  4. にいくつかのCheckedListBox項目を追加します。Add some items to the CheckedListBox.

  5. 例を実行し、リストボックスの一部のチェックボックスをオンにします。Run the example and check some of the check boxes in the list box.

  6. ボタンをクリックします。Click the button.

    チェックされた項目を示す一連のメッセージボックスが表示されます。You will see a series of message boxes that indicate which items were checked.

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

注釈

コレクションItemsは、 System.Windows.Forms.CheckStateCheckedまたはIndeterminateである項目だけを表す、コレクション内のオブジェクトのサブセットです。The collection is a subset of the objects in the Items collection, representing only those items whose System.Windows.Forms.CheckState is Checked or Indeterminate. このコレクション内のインデックスは、昇順で並べ替えられます。The indexes in this collection are in ascending order.

適用対象

こちらもご覧ください