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 核取的專案，以查看專案所在的檢查狀態。 此範例示範如何使用 CheckedIndices 屬性來取得 CheckedListBox.CheckedIndexCollection ，以及 CheckedItems 取得 CheckedListBox.CheckedItemCollection 的 屬性。

第一個迴圈會 GetItemCheckState 使用 方法來取得 CheckState 每個已核取專案的 ，指定專案的索引。 第二個迴圈也會使用 GetItemCheckState ，但會使用 ListBox.ObjectCollection.IndexOf 方法來擷取專案的索引。

若要執行此範例，請執行下列步驟：

1. 建立新的 Windows Form 應用程式。

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 物件的子集，只代表其 System.Windows.Forms.CheckState 為 Checked 或 Indeterminate 的專案。 這個集合中的索引會以遞增順序排列。

另請參閱

• CheckedListBox.CheckedItemCollection