ListView.TopItem Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListView.cs

Získá nebo nastaví první viditelnou položku v ovládacím prvku.

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.ListViewItem? TopItem { get; set; }

Hodnota vlastnosti

ListViewItem

A ListViewItem , který představuje první viditelnou položku v ovládacím prvku.

Atributy

BrowsableAttribute

Výjimky

InvalidOperationException

Vlastnost View je nastavená na LargeIcon, SmallIconnebo Tile.

Příklady

Následující příklad kódu ukazuje resetování stylu ListViewItem podnabídky objektu pomocí TopItem vlastnosti a ListViewItem.ListViewSubItem.ResetStyle metody. Pokud chcete spustit příklad, vložte následující kód do formuláře obsahujícího tlačítko s názvem Button1 a zavolejte metodu InitializeListView v konstruktoru formuláře nebo Load obslužné rutině události.

// Declare the Listview object.
internal System.Windows.Forms.ListView myListView;

// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
private void InitializeListView()
{

    // Set the Location, View and Width properties for the 
    // ListView object. 
    myListView = new ListView();
    myListView.Location = new System.Drawing.Point(20, 20);
    myListView.Width = 250;

    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.View = View.Details;
    
    // Each SubItem object requires a column, so add three columns.
    this.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.Columns.Add("A", 100, HorizontalAlignment.Left);
    this.myListView.Columns.Add("B", 100, HorizontalAlignment.Left);

    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.Items.Add("Items");

    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.UseItemStyleForSubItems = false;

    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem = 
        entryListItem.SubItems.Add("Expense");

    // Change the expenseItem object's color and font.
    expenseItem.ForeColor = System.Drawing.Color.Red;
    expenseItem.Font = new System.Drawing.Font(
        "Arial", 10, System.Drawing.FontStyle.Italic);

    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem = 
        entryListItem.SubItems.Add("Revenue");

    // Change the revenueItem object's color and font.
    revenueItem.ForeColor = System.Drawing.Color.Blue;
    revenueItem.Font = new System.Drawing.Font(
        "Times New Roman", 10, System.Drawing.FontStyle.Bold);

    // Add the ListView to the form.
    this.Controls.Add(this.myListView);
}

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Use the ListView.TopItem property to access the SubItems
    // and then reset their appearance.
    myListView.TopItem.SubItems[1].ResetStyle();
    myListView.TopItem.SubItems[2].ResetStyle();
}

Poznámky

Zpočátku je položka s indexovou pozicí nula (0) v horní části ListView ovládacího prvku. Pokud se ListView obsah ovládacího prvku posune, může být v horní části ovládacího prvku jiná položka. Tuto vlastnost můžete použít k označení nebo určení položky, která je viditelná v horní části ListView ovládacího prvku. Hodnota TopItem vlastnosti nebude vždy zachovaná v závislosti na tom, kde se v zobrazení seznamu nachází požadovaná horní položka.

Počet položek viditelných v ovládacím ListView prvku kdykoli závisí na výšce zobrazení seznamu a velikosti položek, které obsahuje. Pokud položky překročí výšku zobrazení seznamu, budou pokračovat na více stránkách, které uživatel může procházet. Pokud nastavíte TopItem vlastnost na položku na poslední stránce ListView, položka se automaticky posune do zobrazení, TopItem ale nastaví se na skutečnou horní položku poslední stránky.

Pokud chcete zajistit, aby se konkrétní položka nachází ve viditelné oblasti ovládacího prvku (ale ne nutně na nejvyšší pozici), použijte metodu EnsureVisible .

Poznámka

Nastavení této vlastnosti nemá žádný vliv, Scrollable pokud je falsehodnota vlastnosti .

Nastavení této vlastnosti není podporováno ve verzích rozhraní .NET Framework starších než 2.0.

Platí pro

Viz také

• ListViewItem
• EnsureVisible(Int32)