ListViewItem Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public ref class ListViewItem : ICloneable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))]
[System.Serializable]
public class ListViewItem : ICloneable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewItemConverter))>]
[<System.Serializable>]
type ListViewItem = class
    interface ICloneable
    interface ISerializable

Public Class ListViewItem
Implements ICloneable, ISerializable

Héritage: Object
ListViewItem

Attributs: TypeConverterAttribute SerializableAttribute

Implémente: ICloneable ISerializable

Exemples

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 ColumnHeader également des 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 aux propriétés et SmallImageList aux LargeImageList propriétés. L’exemple utilise les propriétés suivantes pour créer le ListView contrôle :

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

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::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 = gcnew 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 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew 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.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew 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 );
   }

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

Private Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As 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.
    Dim item1 As 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")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As 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.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As 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.
    Me.Controls.Add(listView1)
End Sub

Remarques

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

La plupart des propriétés de la ListViewItem classe fournissent des moyens de modifier l’affichage de l’élément dans le ListView contrôle auquel il est associé. Les BackColorpropriétés et Font les propriétés ForeColorvous permettent de modifier la façon dont le texte de l’élément est affiché dans le ListView contrôle. La ImageIndex propriété vous permet de spécifier l’image à charger à partir de l’objet ImageList affecté au ListView contrôle (en définissant les propriétés ou SmallImageList les LargeImageList ListViewpropriétés du contrôle). Les éléments peuvent afficher des cases à cocher afin d’obtenir des choix d’éléments de l’utilisateur d’une manière similaire à un CheckedListBox contrôle. Vous pouvez utiliser la Checked propriété pour déterminer si un élément est activé, ou pour activer ou décochez la case au moment de l’exécution. Les éléments peuvent afficher n’importe quel nombre de sous-éléments lorsque la View propriété du contrôle associé ListView est définie Details et que les colonnes sont définies dans le ListView.ColumnHeaderCollection ListView contrôle. Vous pouvez ajouter des sous-éléments à un élément en appelant la Add méthode de la ListViewItem.ListViewSubItemCollection classe. La SubItems propriété vous permet d’accéder à la ListViewItem.ListViewSubItemCollection classe et à ses membres.

Certaines des propriétés et méthodes de la ListViewItem classe sont des versions spécifiques à l’élément des propriétés et des méthodes dans le ListView contrôle. Par exemple, la 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. La BeginEdit méthode place le texte de l’élément en mode édition afin que l’utilisateur puisse modifier le texte de l’élément (lorsque la LabelEdit propriété du ListView contrôle est définie truesur ). La Clone méthode vous permet de créer des copies d’objets existants ListViewItem à réutiliser dans d’autres ListView contrôles.

Constructeurs

ListViewItem()	Initialise une nouvelle instance de la classe ListViewItem avec des valeurs par défaut.
ListViewItem(ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem et l'assigne au groupe spécifié.
ListViewItem(ListViewItem+ListViewSubItem[], Int32)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément et un tableau d'objets ListViewItem.ListViewSubItem.
ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément ListViewItem.ListViewSubItem et assigne l'élément au groupe spécifié.
ListViewItem(ListViewItem+ListViewSubItem[], String)	Initialise une nouvelle instance de la classe ListViewItem avec les sous-éléments et l'image spécifiés.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec les sous-éléments, l'image et le groupe spécifiés.
ListViewItem(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.
ListViewItem(String)	Initialise une nouvelle instance de la classe ListViewItem avec le texte de l'élément spécifié.
ListViewItem(String, Int32)	Initialise une nouvelle instance de la classe ListViewItem avec le texte de l'élément spécifié et la position d'index de l'image de l'icône de l'élément.
ListViewItem(String, Int32, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec le texte de l'élément spécifié et la position d'index de l'image de l'icône de l'élément et assigne l'élément au groupe spécifié.
ListViewItem(String, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec le texte d'élément spécifié et l'assigne au groupe spécifié.
ListViewItem(String, String)	Initialise une nouvelle instance de la classe ListViewItem avec le texte et l'image spécifiés.
ListViewItem(String, String, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec le texte, l'image et le groupe spécifiés.
ListViewItem(String[])	Initialise une nouvelle instance de la classe ListViewItem avec un tableau de chaînes représentant des sous-éléments.
ListViewItem(String[], Int32)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément et un tableau de chaînes représentant les sous-éléments.
ListViewItem(String[], Int32, Color, Color, Font)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément ; les couleurs de premier plan et d'arrière-plan, la police de l'élément et un tableau de chaînes représentant les sous-éléments.
ListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément ; les couleurs de premier plan et d'arrière-plan, 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é.
ListViewItem(String[], Int32, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec la position d'index de l'image de l'icône de l'élément et un tableau de chaînes représentant les sous-éléments et assigne l'élément au groupe spécifié.
ListViewItem(String[], ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec un tableau de chaînes représentant des sous-éléments et assigne l'élément au groupe spécifié.
ListViewItem(String[], String)	Initialise une nouvelle instance de la classe ListViewItem avec l'élément, le texte du sous-élément et l'image spécifiés.
ListViewItem(String[], String, Color, Color, Font)	Initialise une nouvelle instance de la classe ListViewItem avec les sous-éléments contenant le texte, l'image les couleurs et la police spécifiés.
ListViewItem(String[], String, Color, Color, Font, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec les sous-éléments contenant le texte, l'image les couleurs, la police et le groupe spécifiés.
ListViewItem(String[], String, ListViewGroup)	Initialise une nouvelle instance de la classe ListViewItem avec les sous-éléments contenant le texte, l'image et le groupe spécifiés.

Propriétés

BackColor	Obtient ou définit la couleur d'arrière-plan du texte de l'élément.
Bounds	Obtient le rectangle englobant de l'élément, y compris des sous-éléments.
Checked	Obtient ou définit une valeur indiquant si l'élément est coché.
Focused	Obtient ou définit une valeur indiquant si l'élément a le focus dans le contrôle ListView.
Font	Obtient ou définit la police du texte de l'élément.
ForeColor	Obtient ou définit la couleur de premier plan du texte de l'élément.
Group	Obtient ou définit le groupe auquel l'élément est assigné.
ImageIndex	Obtient ou définit l'index de l'image qui s'affiche pour l'élément.
ImageKey	Obtient ou définit la clé de l'image qui s'affiche pour l'élément.
ImageList	Obtient le ImageList qui contient l'image affichée avec l'élément.
IndentCount	Obtient ou définit le nombre de largeurs de petite image à utiliser pour mettre en retrait ListViewItem.
Index	Obtient l'index de base zéro de l'élément au sein du contrôle ListView.
ListView	Obtient le contrôle ListView qui contient l'élément.
Name	Obtient ou définit le nom associé à ce ListViewItem.
Position	Obtient ou définit la position de l'angle supérieur gauche de ListViewItem.
Selected	Obtient ou définit une valeur indiquant si l'élément est sélectionné.
StateImageIndex	Obtient ou définit l'index de l'image d'état (par exemple, l'image d'une case à cocher activée ou désactivée indiquant l'état de l'élément) qui s'affiche avec l'élément.
SubItems	Obtient une collection contenant tous les sous-éléments de l'élément.
Tag	Obtient ou définit un objet qui contient les données à associer à l'élément.
Text	Obtient ou définit le texte de l'élément.
ToolTipText	Obtient ou définit le texte indiqué lorsque le pointeur de la souris se trouve sur ListViewItem.
UseItemStyleForSubItems	Obtient ou définit une valeur indiquant si les propriétés Font, ForeColor et BackColor de l'élément sont utilisées pour tous ses sous-éléments.

Méthodes

BeginEdit()	Fait passer le texte de l'élément en mode édition.
Clone()	Crée une copie identique de l'élément.
Deserialize(SerializationInfo, StreamingContext)	Désérialise l'élément.
EnsureVisible()	Garantit que l'élément est visible dans le contrôle en faisant défiler le contenu du contrôle si nécessaire.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindNearestItem(SearchDirectionHint)	Recherche l'élément suivant depuis ListViewItem, en recherchant dans la direction spécifiée.
GetBounds(ItemBoundsPortion)	Récupère la partie spécifiée du rectangle englobant de l'élément.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetSubItemAt(Int32, Int32)	Retourne le sous-ensemble de ListViewItem aux coordonnées spécifiées.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove()	Supprime l'élément de son contrôle ListView associé.
Serialize(SerializationInfo, StreamingContext)	Sérialise l'élément.
ToString()	Retourne une chaîne qui représente l'objet actuel.

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Sérialise l'élément.

S’applique à

Partager via