ListView.TopItem Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le premier élément visible dans le contrôle.

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

Valeur de propriété

ListViewItem

ListViewItem qui représente le premier élément visible dans le contrôle.

Attributs

BrowsableAttribute

Exceptions

InvalidOperationException

La View propriété a la LargeIconvaleur , SmallIconou Tile.

Exemples

L’exemple de code suivant illustre la réinitialisation du style des sous-éléments d’un ListViewItem objet via l’utilisation de la TopItem propriété et de la ListViewItem.ListViewSubItem.ResetStyle méthode . Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant un bouton nommé Button1 et appelez la InitializeListView méthode dans le constructeur ou Load le gestionnaire d’événements du formulaire.

// 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();
}

Remarques

Initialement, l’élément dont la position d’index est zéro (0) se trouve en haut du ListView contrôle. Si le contenu du ListView contrôle est défilé, un autre élément peut se trouver en haut du contrôle. Vous pouvez utiliser cette propriété pour indiquer ou déterminer quel élément est visible en haut du ListView contrôle. La valeur de la TopItem propriété ne sera pas toujours conservée, selon l’emplacement où se trouve l’élément supérieur souhaité dans l’affichage de liste.

Le nombre d’éléments visibles dans un ListView contrôle à tout moment dépend de la hauteur de l’affichage de liste et de la taille des éléments qu’il contient. Si les éléments dépassent la hauteur de l’affichage de liste, les éléments continuent sur plusieurs pages, que l’utilisateur peut parcourir. Si vous définissez la TopItem propriété sur un élément dans la dernière page du ListView, l’élément sera automatiquement défilé dans l’affichage; toutefois, TopItem sera défini sur l’élément en haut réel de la dernière page.

Pour vous assurer qu’un élément spécifique se trouve dans la zone visible du contrôle (mais pas nécessairement dans la position supérieure), utilisez la EnsureVisible méthode .

Note

La définition de cette propriété n’a aucun effet lorsque la valeur de la Scrollable propriété est false.

La définition de cette propriété n’est pas prise en charge dans les versions du .NET Framework antérieures à la version 2.0.

S’applique à

Voir aussi

• ListViewItem
• EnsureVisible(Int32)