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.CheckedIndexCollectionCheckedItems 屬性,以取得 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 Forms 應用程式Create a new Windows Forms application.

  2. CheckedListBoxButton 加入表單。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. 將一些專案新增至 CheckedListBoxAdd 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.

適用於

另請參閱