Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListView.TopItem propriété

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public ListViewItem TopItem { get; set; }

Valeur de propriété

Type: System.Windows.Forms.ListViewItem

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

Exception Condition
InvalidOperationException

Le View est définie sur LargeIcon, SmallIcon, ou Tile.

Initialement, l’élément ayant la position d’index zéro (0) est en haut de la ListView contrôle. Si le ListView défile vers le contenu du contrôle, un élément différent peut être en haut du contrôle. Vous pouvez utiliser cette propriété pour indiquer ou déterminer l’élément visible en haut de la ListView contrôle. La valeur de la TopItem propriété n’est pas toujours persistante, selon l’emplacement l’élément supérieur souhaité dans la liste.

Le nombre d’éléments visibles dans un ListView le contrôle à tout moment dépend de la hauteur de la vue liste et la taille des éléments qu’il contient. Si les éléments dépassent la hauteur de la vue liste, les éléments seront affichent sur plusieurs pages auxquelles l’utilisateur peut faire défiler. Si vous définissez le TopItem propriété à un élément dans la dernière page de le ListView, l’élément sera automatiquement défiler dans l’affichage ; Toutefois, TopItem est défini sur l’élément supérieur réel de la dernière page.

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

System_CAPS_noteRemarque

Cette propriété n’a aucun effet lorsque la Scrollable est de valeur de la propriété false.

Cette propriété n’est pas pris en charge dans les versions de le .NET Framework avant la version 2.0.

L’exemple de code suivant illustre la redéfinition du style d’un ListViewItem sous-éléments de l’objet à l’aide de la TopItem propriété et la ListViewItem.ListViewSubItem.ResetStyle (méthode). Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant un bouton nommé Button1 appelez le InitializeListView méthode dans le constructeur du formulaire ou Load Gestionnaire d’événements.


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

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: