ListView.CheckedItems Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ListView.cs

Denetimde şu anda denetlenen öğeleri alır.

C#

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.ListView.CheckedListViewItemCollection CheckedItems { get; }

Özellik Değeri

ListView.CheckedListViewItemCollection

ListView.CheckedListViewItemCollection Şu anda denetlenen öğeleri içeren bir. Şu anda hiçbir öğe işaretlenmediyse boş ListView.CheckedListViewItemCollection bir değer döndürülür.

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, olayı işleyen ItemChecked bir denetimi ListView gösterir. Örnek, bir öğe her işaretlendiğinde veya işaretsiz olduğunda yeni bir fiyatın tally değerini almak için özelliğini kullanır CheckedItems . Bu örneği çalıştırmak için, aşağıdaki kodu adlandırılmış ve TextBox adlandırılmış ListView1Textbox1bir içeren bir ListView forma yapıştırın. Formun InitializeListView oluşturucusundan veya Load yönteminden yöntemini çağırın.

C#

private void InitializeListView()
{
    this.ListView1 = new System.Windows.Forms.ListView();

    // Set properties such as BackColor and DockStyle and Location.
    this.ListView1.BackColor = System.Drawing.SystemColors.Control;
    this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
    this.ListView1.Location = new System.Drawing.Point(0, 0);
    this.ListView1.Size = new System.Drawing.Size(292, 130);
    this.ListView1.View = System.Windows.Forms.View.Details;
    this.ListView1.HideSelection = false;

    // Allow the user to select multiple items.
    this.ListView1.MultiSelect = true;

    // Show CheckBoxes in the ListView.
    this.ListView1.CheckBoxes = true;
    
    //Set the column headers and populate the columns.
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
    
    ColumnHeader columnHeader1 = new ColumnHeader();
    columnHeader1.Text = "Breakfast Choices";
    columnHeader1.TextAlign = HorizontalAlignment.Left;
    columnHeader1.Width = 146;

    ColumnHeader columnHeader2 = new ColumnHeader();
    columnHeader2.Text = "Price Each";
    columnHeader2.TextAlign = HorizontalAlignment.Center;
    columnHeader2.Width = 142;

    this.ListView1.Columns.Add(columnHeader1);
    this.ListView1.Columns.Add(columnHeader2);

    string[] foodList = new string[]{"Juice", "Coffee", 
        "Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
        "Bagel & Cream Cheese"};

    string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
        "2.79", "2.09", "2.69"};
    
    int count;

    // Members are added one at a time, so call BeginUpdate to ensure 
    // the list is painted only once, rather than as each list item is added.
    ListView1.BeginUpdate();

    for(count = 0; count < foodList.Length; count++)
    {
        ListViewItem listItem = new ListViewItem(foodList[count]);
        listItem.SubItems.Add(foodPrice[count]);
        ListView1.Items.Add(listItem);
    }

    //Call EndUpdate when you finish adding items to the ListView.
    ListView1.EndUpdate();
    this.Controls.Add(this.ListView1);
}

C#

// Handles the ItemChecked event.  The method loops through all the 
// checked items and tallies a new price each time an item is 
// checked or unchecked. It outputs the price to TextBox1.
private void ListView1_ItemCheck2(object sender, 
    System.Windows.Forms.ItemCheckEventArgs e)
{
    double price = 0.0;
    ListView.CheckedListViewItemCollection checkedItems = 
        ListView1.CheckedItems;
    
    foreach ( ListViewItem item in checkedItems )
    {
        price += Double.Parse(item.SubItems[1].Text);
    }
    if (e.CurrentValue==CheckState.Unchecked)
    {
        price += Double.Parse(
            this.ListView1.Items[e.Index].SubItems[1].Text);
    }
    else if((e.CurrentValue==CheckState.Checked))
    {
        price -= Double.Parse(
            this.ListView1.Items[e.Index].SubItems[1].Text);
    }
    // Output the price to TextBox1.
    TextBox1.Text = price.ToString();
}

Açıklamalar

Bu özellik yalnızca denetimin CheckBoxesListView özelliği olarak trueayarlandığında yararlıdır. özelliği, CheckedItems denetimde denetlenen tüm öğeleri içeren bir koleksiyon döndürür. Koleksiyondaki öğeleri işleme hakkında daha fazla bilgi için bkz ListView.CheckedListViewItemCollection. .

Denetimde denetlenen öğelerin içindeki ListView.ListViewItemCollection dizin konumlarının bir koleksiyonunu almak istiyorsanız, denetlenen öğeler yerine özelliğini kullanınCheckedIndices.ListView

Şunlara uygulanır

Ayrıca bkz.

• ListView.CheckedListViewItemCollection
• CheckedIndices