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 classe

 

Date de publication : novembre 2016

Représente un élément dans un contrôle ListView.

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

System.Object
  System.Windows.Forms.ListViewItem

[SerializableAttribute]
[TypeConverterAttribute(typeof(ListViewItemConverter))]
public class ListViewItem : ICloneable, ISerializable

NomDescription
System_CAPS_pubmethodListViewItem()

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

System_CAPS_pubmethodListViewItem(ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe et l’affecte au groupe spécifié.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], Int32)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index image de l’icône de l’élément et un tableau de ListViewItem.ListViewSubItem objets.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], Int32, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index image de l’icône de l’élément et un tableau de ListViewItem.ListViewSubItem et assigne l’élément au groupe spécifié.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], String)

Initialise une nouvelle instance de la ListViewItem classe avec les sous-éléments spécifiés et l’image.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], String, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec les sous-éléments spécifiées, l’image et groupe.

System_CAPS_protmethodListViewItem(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe ListViewItem avec les informations de sérialisation et le contexte de diffusion en continu spécifiés.

System_CAPS_pubmethodListViewItem(String)

Initialise une nouvelle instance de la ListViewItem classe avec le texte de l’élément spécifié.

System_CAPS_pubmethodListViewItem(String, Int32)

Initialise une nouvelle instance de la ListViewItem classe avec le texte de l’élément spécifié et la position d’index de l’icône de l’élément image.

System_CAPS_pubmethodListViewItem(String, Int32, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec le texte de l’élément spécifié et la position d’index image de l’icône de l’élément et assigne l’élément au groupe spécifié.

System_CAPS_pubmethodListViewItem(String, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec le texte de l’élément spécifié et l’affecte au groupe spécifié.

System_CAPS_pubmethodListViewItem(String, String)

Initialise une nouvelle instance de la ListViewItem classe avec le texte spécifié et l’image.

System_CAPS_pubmethodListViewItem(String, String, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec le texte spécifié, une image et un groupe.

System_CAPS_pubmethodListViewItem(String[])

Initialise une nouvelle instance de la ListViewItem classe avec un tableau de chaînes représentant les sous-éléments.

System_CAPS_pubmethodListViewItem(String[], Int32)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index image de l’icône de l’élément et un tableau de chaînes représentant les sous-éléments.

System_CAPS_pubmethodListViewItem(String[], Int32, Color, Color, Font)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index de l’icône de l’élément image ; la couleur de premier plan, couleur d’arrière-plan et la police de l’élément ; et un tableau de chaînes représentant les sous-éléments.

System_CAPS_pubmethodListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index de l’icône de l’élément image ; la couleur de premier plan, couleur d’arrière-plan et la police de l’élément ; et un tableau de chaînes représentant les sous-éléments. Assigne l’élément au groupe spécifié.

System_CAPS_pubmethodListViewItem(String[], Int32, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec la position d’index image de l’icône de l’élément et un tableau de chaînes représentant des sous-éléments et assigne l’élément au groupe spécifié.

System_CAPS_pubmethodListViewItem(String[], ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec un tableau de chaînes représentant des sous-éléments et assigne l’élément au groupe spécifié.

System_CAPS_pubmethodListViewItem(String[], String)

Initialise une nouvelle instance de la ListViewItem classe avec le texte spécifié d’éléments et sous-éléments et l’image.

System_CAPS_pubmethodListViewItem(String[], String, Color, Color, Font)

Initialise une nouvelle instance de la ListViewItem classe avec les sous-éléments contenant le texte spécifié, image, des couleurs et la police.

System_CAPS_pubmethodListViewItem(String[], String, Color, Color, Font, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec les sous-éléments contenant le texte spécifié, image, des couleurs, polices et groupe.

System_CAPS_pubmethodListViewItem(String[], String, ListViewGroup)

Initialise une nouvelle instance de la ListViewItem classe avec les sous-éléments contenant le texte spécifié, une image et un groupe.

NomDescription
System_CAPS_pubpropertyBackColor

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

System_CAPS_pubpropertyBounds

Obtient le rectangle englobant de l’élément, y compris ses sous-éléments.

System_CAPS_pubpropertyChecked

Obtient ou définit une valeur indiquant si l’élément est activé.

System_CAPS_pubpropertyFocused

Obtient ou définit une valeur indiquant si l’élément a le focus dans le ListView contrôle.

System_CAPS_pubpropertyFont

Obtient ou définit la police du texte de l'élément.

System_CAPS_pubpropertyForeColor

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

System_CAPS_pubpropertyGroup

Obtient ou définit le groupe auquel l’article est affecté.

System_CAPS_pubpropertyImageIndex

Obtient ou définit l’index de l’image qui est affiché pour l’élément.

System_CAPS_pubpropertyImageKey

Obtient ou définit la clé de l’image qui est affiché pour l’élément.

System_CAPS_pubpropertyImageList

Obtient les ImageList qui contient l’image affichée avec l’élément.

System_CAPS_pubpropertyIndentCount

Obtient ou définit le nombre de largeurs de petite image permettant de mettre en retrait le ListViewItem.

System_CAPS_pubpropertyIndex

Obtient l’index de base zéro de l’élément dans le ListView contrôle.

System_CAPS_pubpropertyListView

Obtient le ListView contrôle qui contient l’élément.

System_CAPS_pubpropertyName

Obtient ou définit le nom associé à ce ListViewItem.

System_CAPS_pubpropertyPosition

Obtient ou définit la position de l’angle supérieur gauche de la ListViewItem.

System_CAPS_pubpropertySelected

Obtient ou définit une valeur indiquant si l'élément est sélectionné.

System_CAPS_pubpropertyStateImageIndex

Obtient ou définit l’index de l’image d’état (une image par exemple, une case à cocher activée ou désactivée indiquant l’état de l’élément) qui est affiché pour l’élément.

System_CAPS_pubpropertySubItems

Obtient une collection contenant tous les sous-éléments de l’élément.

System_CAPS_pubpropertyTag

Obtient ou définit un objet qui contient les données à associer à l’élément.

System_CAPS_pubpropertyText

Obtient ou définit le texte de l’élément.

System_CAPS_pubpropertyToolTipText

Obtient ou définit le texte affiché quand le pointeur de la souris se positionne sur le ListViewItem.

System_CAPS_pubpropertyUseItemStyleForSubItems

Obtient ou définit une valeur indiquant si le Font, ForeColor, et BackColor Propriétés de l’élément sont utilisées pour tous ses sous-éléments.

NomDescription
System_CAPS_pubmethodBeginEdit()

Place le texte de l’élément en mode édition.

System_CAPS_pubmethodClone()

Crée une copie identique de l’élément.

System_CAPS_protmethodDeserialize(SerializationInfo, StreamingContext)

Désérialise l’élément.

System_CAPS_pubmethodEnsureVisible()

Garantit que l’élément est visible dans le contrôle, en faisant défiler le contenu du contrôle, si nécessaire.

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_pubmethodFindNearestItem(SearchDirectionHint)

Recherche l’élément suivant à partir de la ListViewItem, en recherchant dans la direction spécifiée.

System_CAPS_pubmethodGetBounds(ItemBoundsPortion)

Récupère la partie spécifiée du rectangle englobant pour l’élément.

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetSubItemAt(Int32, Int32)

Retourne le sous-ensemble de la ListViewItem aux coordonnées spécifiées.

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_pubmethodRemove()

Supprime l’élément qui lui sont associés ListView contrôle.

System_CAPS_protmethodSerialize(SerializationInfo, StreamingContext)

Sérialise l’élément.

System_CAPS_pubmethodToString()

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

Le ListView contrôle est semblable à un ListBox car il affiche une liste d’éléments. La principale différence est que le ListView contrôle fournit un nombre d’éléments de différentes manières peut être affiché par l’utilisateur. La ListViewItem classe définit l’apparence, le comportement et les données associées à un élément qui est affiché dans la ListView contrôle. ListViewItem les objets peuvent être affichés dans le ListView contrôle de l’une des quatre vues différentes. Les éléments peuvent être affichés sous forme de petites ou grandes icônes ou de petites icônes dans une liste verticale. Éléments peuvent aussi contenir des sous-éléments qui contiennent des informations relatives à l’élément parent. Le quatrième style d’affichage, affichage des détails, vous permet de pour afficher l’élément et ses sous-éléments dans une grille avec des en-têtes de colonne qui peut être utilisé pour identifier les informations affichées dans un sous-élément.

La plupart des propriétés de la ListViewItem classe offrent des moyens de modifier l’affichage de l’élément dans le ListView contrôle lui est associée. Le BackColor, ForeColor, et Font Propriétés permettent de modifier le mode d’affichage du texte de l’élément dans le ListView contrôle. Le ImageIndex propriété permet de spécifier l’image à charger à partir de la ImageList affecté à la ListView contrôle (en définissant le LargeImageList ou SmallImageList Propriétés de la ListView). Les éléments peuvent afficher des cases à cocher afin de recueillir le choix de l’utilisateur d’une manière similaire à un CheckedListBox contrôle. Vous pouvez utiliser le Checked propriété pour déterminer si un élément est activé, ou activez ou désactivez la case à cocher au moment de l’exécution. Éléments peuvent afficher un nombre quelconque de sous-éléments lorsque la View propriété associé au ListView contrôle est défini sur Details et les colonnes sont définies dans le ListView.ColumnHeaderCollection de le ListView contrôle. Vous pouvez ajouter des sous-éléments à un élément en appelant le Add Procédé de la ListViewItem.ListViewSubItemCollection classe. Le SubItems propriété vous permet d’accéder à la ListViewItem.ListViewSubItemCollection classe et ses membres.

Certaines propriétés et méthodes de la ListViewItem classe sont des versions spécifiques aux éléments de propriétés et méthodes de le ListView contrôle. Par exemple, le EnsureVisible méthode est similaire à la ListView version de la méthode, mais la ListViewItem version affecte uniquement l’élément actuel.

La ListViewItem classe fournit également des méthodes qui ne sont pas des versions de ListView méthodes. Le BeginEdit méthode place le texte de l’élément en mode édition pour l’utilisateur peut modifier le texte de l’élément (lorsque le LabelEdit propriété de la ListView contrôle est défini sur true). La Clone permet de créer des copies existant ListViewItem à réutiliser dans d’autres objets ListView contrôles.

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: