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

ListViewItem.ListViewSubItem classe

 

Date de publication : novembre 2016

Représente un sous-élément d’un ListViewItem.

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

System.Object
  System.Windows.Forms.ListViewItem.ListViewSubItem

[SerializableAttribute]
public class ListViewSubItem

NomDescription
System_CAPS_pubmethodListViewItem.ListViewSubItem()

Initialise une nouvelle instance de la classe ListViewItem.ListViewSubItem avec des valeurs par défaut.

System_CAPS_pubmethodListViewItem.ListViewSubItem(ListViewItem, String)

Initialise une nouvelle instance de la ListViewItem.ListViewSubItem classe avec le propriétaire spécifié et le texte.

System_CAPS_pubmethodListViewItem.ListViewSubItem(ListViewItem, String, Color, Color, Font)

Initialise une nouvelle instance de la ListViewItem.ListViewSubItem classe avec le propriétaire spécifié, du texte, couleur de premier plan, couleur d’arrière-plan et les valeurs de police.

NomDescription
System_CAPS_pubpropertyBackColor

Obtient ou définit la couleur d’arrière-plan du texte du sous-élément.

System_CAPS_pubpropertyBounds

Obtient le rectangle englobant de le ListViewItem.ListViewSubItem.

System_CAPS_pubpropertyFont

Obtient ou définit la police du texte affiché par le sous-élément.

System_CAPS_pubpropertyForeColor

Obtient ou définit la couleur de premier plan du texte du sous-élément.

System_CAPS_pubpropertyName

Obtient ou définit le nom de l'objet ListViewItem.ListViewSubItem.

System_CAPS_pubpropertyTag

Obtient ou définit un objet qui contient des données sur le ListViewItem.ListViewSubItem.

System_CAPS_pubpropertyText

Obtient ou définit le texte du sous-élément.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodResetStyle()

Réinitialise les styles appliqués au sous-élément police par défaut et les couleurs.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Remplace Object.ToString().)

Un ListView contrôle affiche une liste d’éléments qui sont définis par la ListViewItem classe. Chaque ListViewItem peut stocker des objets de sous-élément définis par la ListViewItem.ListViewSubItem classe. Les sous-éléments sont affichés lorsque la View propriété de la ListView contrôle est défini sur Details. En règle générale, sous-éléments contiennent des informations relatives à leur élément parent. Par exemple, si un ListView contrôle affiche des éléments représentant des commandes, chaque élément peut afficher le numéro de commande. Sous-éléments peuvent être ajoutés à chaque élément pour afficher des informations telles que le produit commandé, la quantité d’articles commandés et le prix total des articles commandés. Contrairement aux ListViewItem objets, ListViewItem.ListViewSubItem objets ne peuvent pas être modifiées directement par l’utilisateur (l’utilisateur peut modifier ListViewItem objets si les LabelEdit propriété de la ListView contrôle est défini sur true).

Sous-éléments ne peut pas être modifiés directement par l’utilisateur et n’affichent pas les images, les propriétés sont limitées à celles qui affectent le style du texte du sous-élément lorsqu’il est affiché dans la ListView contrôle. Si le UseItemStyleForSubItems propriété de la ListView qui contient les sous-éléments a la valeur false, vous pouvez utiliser le Font, BackColor, et ForeColor Propriétés pour modifier les styles appliqués à l’affichage du texte. En règle générale, les styles de l’élément et des sous-éléments sont identiques dans un ListView contrôle, mais si vous souhaitez modifier le style de son propre ListViewItem.ListViewSubItem pour mettre en surbrillance, vous pouvez utiliser ces propriétés sur les éléments que vous souhaitez afficher différemment.

L’exemple de code suivant crée un ListView contrôle avec trois ListViewItem objets spécifiés et trois ListViewItem.ListViewSubItem objets spécifiés pour chaque élément. L’exemple crée également ColumnHeader objets pour afficher les sous-éléments en mode Détails. Deux ImageList objets sont également créés dans l’exemple de code pour fournir des images pour les ListViewItem objets. Ces ImageList objets sont ajoutés à la LargeImageList et SmallImageList Propriétés. L’exemple utilise les propriétés suivantes pour créer la ListView contrôle.

Vous devez ajouter le code à un Form appelez la méthode créée dans l’exemple à partir du constructeur ou une autre méthode sur le formulaire. L’exemple suppose que les images nommées MySmallImage1, MySmallImage2, MyLargeImage1, et MyLargeImage2 se trouvent dans le répertoire racine du lecteur C.

private void CreateMyListView()
{
	// Create a new ListView control.
	ListView listView1 = new ListView();
	listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

	// Set the view to show details.
	listView1.View = View.Details;
	// Allow the user to edit item text.
	listView1.LabelEdit = true;
	// Allow the user to rearrange columns.
	listView1.AllowColumnReorder = true;
	// Display check boxes.
	listView1.CheckBoxes = true;
	// Select the item and subitems when selection is made.
	listView1.FullRowSelect = true;
	// Display grid lines.
	listView1.GridLines = true;
	// Sort the items in the list in ascending order.
	listView1.Sorting = SortOrder.Ascending;

	// Create three items and three sets of subitems for each item.
	ListViewItem item1 = new ListViewItem("item1",0);
	// Place a check mark next to the item.
	item1.Checked = true;
	item1.SubItems.Add("1");
	item1.SubItems.Add("2");
	item1.SubItems.Add("3");
	ListViewItem item2 = new ListViewItem("item2",1);
	item2.SubItems.Add("4");
	item2.SubItems.Add("5");
	item2.SubItems.Add("6");
	ListViewItem item3 = new ListViewItem("item3",0);
	// Place a check mark next to the item.
	item3.Checked = true;
	item3.SubItems.Add("7");
	item3.SubItems.Add("8");
	item3.SubItems.Add("9");

	// Create columns for the items and subitems.
	// Width of -2 indicates auto-size.
	listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

	//Add the items to the ListView.
          		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

	// Create two ImageList objects.
	ImageList imageListSmall = new ImageList();
	ImageList imageListLarge = new ImageList();

	// Initialize the ImageList objects with bitmaps.
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

	//Assign the ImageList objects to the ListView.
	listView1.LargeImageList = imageListLarge;
	listView1.SmallImageList = imageListSmall;

	// Add the ListView to the control collection.
	this.Controls.Add(listView1);
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: