Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ListView.TopItem, propriété

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
ListViewItem qui représente le premier élément visible dans le contrôle.

ExceptionCondition
InvalidOperationException

La propriété View a la valeur LargeIcon, SmallIcon ou Tile.

Initialement, l'élément ayant la position d'index zéro (0) se trouve en haut du contrôle ListView. Si vous faites défiler le contenu du contrôle ListView, un élément différent peut se trouver en haut du contrôle. Vous pouvez utiliser cette propriété pour indiquer ou déterminer l'élément visible en haut du contrôle ListView. La valeur de la propriété TopItem n'est pas toujours persistante, selon l'endroit où figure l'élément supérieur souhaité dans la vue Liste.

Le nombre d'éléments visibles à tout moment dans un contrôle ListView dépend de la hauteur de la vue Liste et de la taille des éléments qu'il contient. Si les éléments dépassent la hauteur de la vue Liste, ils s'affichent sur plusieurs pages que l'utilisateur peut faire défiler. Si vous affectez à la propriété TopItem un élément contenu dans la dernière page de ListView, l'élément fait l'objet d'un défilement automatique dans l'affichage ; toutefois, TopItem a la valeur de l'élément supérieur réel de la dernière page.

Pour vérifier qu'un élément spécifique figure dans la zone visible du contrôle (mais pas nécessairement dans la position supérieure), utilisez la méthode EnsureVisible.

RemarqueRemarque

La définition de cette propriété n'a aucun effet lorsque la valeur de propriété Scrollable 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.

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



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



To run the example, paste the following code


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft