ListViewItem Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListViewItem.cs

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

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

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

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

Public Class ListViewItem
Implements ICloneable, ISerializable

Héritage

Object

ListViewItem

Attributs

TypeConverterAttribute SerializableAttribute DynamicallyAccessedMembersAttribute

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 dans la création du ListView contrôle :

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

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 plusieurs façons différentes 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 sous forme de petites icônes dans une liste verticale. Les éléments peuvent également contenir des sous-éléments qui contiennent des informations liées à 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 celle ImageList qui est affectée au ListView contrôle (en définissant les propriétés ou SmallImageList les LargeImageList propriétés du ListView). Les éléments peuvent afficher des cases à cocher pour obtenir les 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.ColumnHeaderCollectionListView 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 aux éléments 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 actif.

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

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

Propriétés

Nom	Description
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 les sous-éléments.
Checked	Obtient ou définit une valeur indiquant si l’élément est activé.
Focused	Obtient ou définit une valeur indiquant si l’élément a le focus dans le ListView contrôle.
Font	Obtient ou définit la police du texte affiché par 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 affecté.
ImageIndex	Obtient ou définit l’index de l’image affichée pour l’élément.
ImageKey	Obtient ou définit la clé de l’image affichée pour l’élément.
ImageList	Obtient l’image ImageList affichée avec l’élément.
IndentCount	Obtient ou définit le nombre de petites largeurs d’image par lesquelles mettre en retrait le ListViewItem.
Index	Obtient l’index de base zéro de l’élément dans le ListView contrôle.
ListView	Obtient le ListView contrôle qui contient l’élément.
Name	Obtient ou définit le nom associé à ce ListViewItem.
Position	Obtient ou définit la position du coin supérieur gauche du 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 (image telle qu’une case à cocher sélectionnée ou désactivée qui indique l’état de l’élément) affichée pour 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 des données à associer à l’élément.
Text	Obtient ou définit le texte de l’élément.
ToolTipText	Obtient ou définit le texte affiché lorsque le pointeur de la souris se trouve sur le ListViewItem.
UseItemStyleForSubItems	Obtient ou définit une valeur indiquant si les propriétés et BackColor les FontForeColorpropriétés de l’élément sont utilisées pour tous ses sous-éléments.

Méthodes

Nom	Description
BeginEdit()	Place 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.
FindNearestItem(SearchDirectionHint)	Recherche l’élément suivant à partir de la ListViewItemrecherche dans la direction spécifiée.
GetBounds(ItemBoundsPortion)	Récupère la partie spécifiée du rectangle englobant de l’élément.
GetSubItemAt(Int32, Int32)	Retourne le sous-élément des ListViewItem coordonnées spécifiées.
Remove()	Supprime l’élément de son contrôle associé ListView .
Serialize(SerializationInfo, StreamingContext)	Sérialise l’élément.
ToString()	Retourne une chaîne qui représente l’objet actuel.

Implémentations d’interfaces explicites

Nom	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Sérialise l’élément.

Voir aussi

• ListView
• ListViewItem.ListViewSubItem
• Contrôle ListView (Windows Forms)