CheckedListBox.CheckedItems 属性

定义

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.CheckedItemCollectionThe 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. 第二个循环也使用 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. 向窗体添加 CheckedListBoxButtonAdd 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.CheckState CheckedIndeterminate的项。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.

适用于

另请参阅