CheckedListBox.CheckedItems 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

该 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; }

[<System.ComponentModel.Browsable(false)>]
member this.CheckedItems : System.Windows.Forms.CheckedListBox.CheckedItemCollection

Public ReadOnly Property CheckedItems As CheckedListBox.CheckedItemCollection

属性值

CheckedListBox.CheckedItemCollection

CheckedListBox.CheckedItemCollection 的 CheckedListBox 集合。

属性

BrowsableAttribute

示例

以下示例枚举 中CheckedListBox.CheckedIndexCollection选中的项，以查看项处于检查状态。 该示例演示如何使用 属性获取 ，并使用 CheckedIndicesCheckedItems 属性获取 CheckedListBox.CheckedItemCollection。CheckedListBox.CheckedIndexCollection

给定项的索引，第一个循环使用 GetItemCheckState 方法获取 CheckState 每个已检查项的 。 第二个循环也使用 GetItemCheckState，但使用 ListBox.ObjectCollection.IndexOf 方法检索项的索引。

若要运行此示例，请执行以下步骤：

1. 创建新的 Windows 窗体应用程序。

2. 向窗体添加 CheckedListBox 和 Button 。

3. 将按钮 WhatIsChecked命名为 ，为其 Click 事件添加处理程序，并从以下处理程序的正文复制代码。

4. 将一些项添加到 CheckedListBox。

5. 运行示例并检查列表框中的一些检查框。

6. 单击按钮。

   你将看到一系列消息框，这些消息框指示已选中哪些项目。

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对象的子集，仅表示其 为 Checked 或 Indeterminate的System.Windows.Forms.CheckState项。 此集合中的索引按升序排列。

另请参阅

• CheckedListBox.CheckedItemCollection