Export (0) Print
Expand All

ListViewItem.Selected Property

Gets or sets a value indicating whether the item is selected.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public bool Selected { get; set; }
/** @property */
public boolean get_Selected ()

/** @property */
public void set_Selected (boolean value)

public function get Selected () : boolean

public function set Selected (value : boolean)

Property Value

true if the item is selected; otherwise, false.

If the MultiSelect property of the ListView control the item is contained in is set to true, setting the value of this property adds or removes the item from the set of selected items. If the MultiSelect property is set to false, setting the value of this property to select an item automatically cancels the selection for any other items in the ListView control. You can use this property to determine if an item is selected or to select an item at run time. You can access all items that are selected in a ListView control by using the ListView.SelectedItems property.

NoteNote

Items appear selected only when the ListView control has focus. To select items in response to a user action such as a button click, be sure to call the Focus method in addition to setting this property.

The following code " demonstrates how to use the ListView.Clear and Selected members. To run the ", place the following code in a form containing a ListView named ListView1 and a Button, located toward the bottom of the form, named Button1. Call the InitializeListView method from the form's constructor or Load event-handling method.

private void InitializeListView()
{
    // Set up the inital values for the ListView and populate it.
    this.ListView1 = new ListView();
    this.ListView1.Dock = DockStyle.Top;
    this.ListView1.Location = new System.Drawing.Point(0, 0);
    this.ListView1.Size = new System.Drawing.Size(292, 130);
    this.ListView1.View = View.Details;
    this.ListView1.FullRowSelect = true;

    string[] breakfast = new string[]{"Continental Breakfast", 
        "Pancakes and Sausage", "Denver Omelet", "Eggs & Bacon", 
        "Bagel & Cream Cheese"};

    string[] breakfastPrices = new string[]{"3.09", "4.09", 
        "4.19", "4.79", "2.09"};

    PopulateMenu("Breakfast", breakfast, breakfastPrices);
}

private void PopulateMenu(string meal, 
    string[] menuItems, string[] menuPrices)
{
    ColumnHeader columnHeader1 = new ColumnHeader();
    columnHeader1.Text = meal + " Choices";
    columnHeader1.TextAlign = HorizontalAlignment.Left;
    columnHeader1.Width = 146;

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

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

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

    // Use the Selected property to select the first item on 
    // the list.
    ListView1.Focus();
    ListView1.Items[0].Selected = true;
}


private void Button1_Click(System.Object sender, System.EventArgs e)
{
    // Create new values for the ListView, clear the list, 
    // and repopulate it.
    string[] lunch = new string[]{"Hamburger", "Grilled Cheese",
        "Soup & Salad", "Club Sandwich", "Hotdog"};

    string[] lunchPrices = new string[]{"4.09", "5.09", "5.19", 
        "4.79", "2.09"};

    ListView1.Clear();

    PopulateMenu("Lunch", lunch, lunchPrices);
    Button1.Enabled = false;
}

private void InitializeListView()
{
    // Set up the inital values for the ListView and populate it.
    this.listView1 = new ListView();
    this.listView1.set_Dock(DockStyle.Top);
    this.listView1.set_Location(new System.Drawing.Point(0, 0));
    this.listView1.set_Size(new System.Drawing.Size(292, 130));
    this.listView1.set_View(View.Details);
    this.listView1.set_FullRowSelect(true);

    String breakfast[] = new String[] { "Continental Breakfast",
        "Pancakes and Sausage", "Denver Omelet", "Eggs & Bacon",
        "Bagel & Cream Cheese" };

    String breakfastPrices[] = new String[] { "3.09", "4.09", "4.19",
        "4.79", "2.09" };

    PopulateMenu("Breakfast", breakfast, breakfastPrices);
} //InitializeListView

private void PopulateMenu(String meal,String menuItems[],String menuPrices[])
{
    ColumnHeader columnHeader1 = new ColumnHeader();
    columnHeader1.set_Text(meal + " Choices");
    columnHeader1.set_TextAlign(HorizontalAlignment.Left);
    columnHeader1.set_Width(146);

    ColumnHeader columnHeader2 = new ColumnHeader();
    columnHeader2.set_Text("Price");
    columnHeader2.set_TextAlign(HorizontalAlignment.Center);
    columnHeader2.set_Width(142);

    this.listView1.get_Columns().Add(columnHeader1);
    this.listView1.get_Columns().Add(columnHeader2);

    for (int count = 0; count < menuItems.length; count++) {
        ListViewItem listItem =
            new ListViewItem((String)menuItems.get_Item(count));
        listItem.get_SubItems().Add((String)menuPrices.get_Item(count));
        listView1.get_Items().Add(listItem);
    }
    // Use the Selected property to select the first item on 
    // the list.
    listView1.Focus();
    listView1.get_Items().get_Item(0).set_Selected(true);
} //PopulateMenu

private void button1_Click(System.Object sender, System.EventArgs e)
{
    // Create new values for the ListView, clear the list, 
    // and repopulate it.
    String lunch[] = new String[] { "Hamburger", "Grilled Cheese",
        "Soup & Salad", "Club Sandwich", "Hotdog" };

    String lunchPrices[] = new String[] { "4.09", "5.09", "5.19",
        "4.79", "2.09" };

    listView1.Clear();

    PopulateMenu("Lunch", lunch, lunchPrices);
    button1.set_Enabled(false);
} //button1_Click

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft