Partage via


ListViewItem Constructeurs

Définition

Initialise une nouvelle instance de la classe ListViewItem.

Surcharges

ListViewItem()

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

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[], 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[], 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[], 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(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(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(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.

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, String, ListViewGroup)

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

ListViewItem(ListViewItem+ListViewSubItem[], String)

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

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 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[], 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, 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, 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(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(ListViewGroup)

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

ListViewItem(String[])

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

ListViewItem(String)

Initialise une nouvelle instance de la classe ListViewItem avec le texte de l'élément 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()

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

public:
 ListViewItem();
public ListViewItem ();
Public Sub New ()

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 LargeImageList propriétés et SmallImageList . 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 exige 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

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

Paramètres

items
String[]

Tableau de chaînes qui représente le texte des sous-éléments de ListViewItem.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans l'élément.

foreColor
Color

Color représentant la couleur de premier plan de l'élément.

backColor
Color

Color qui représente la couleur d'arrière-plan de l'élément.

font
Font

Font à appliquer au texte de l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

Notes

ListView les groupes sont uniquement disponibles sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

S’applique à

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é.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font, group As ListViewGroup)

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

foreColor
Color

Color représentant la couleur de premier plan de l'élément.

backColor
Color

Color qui représente la couleur d'arrière-plan de l'élément.

font
Font

Font qui représente la police dans laquelle afficher le texte de l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView les groupes sont uniquement disponibles sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Voir aussi

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, string imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, string? imageKey, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * string * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, foreColor As Color, backColor As Color, font As Font)

Paramètres

items
String[]

Tableau de chaînes qui représente le texte des sous-éléments de ListViewItem.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans l'élément.

foreColor
Color

Color représentant la couleur de premier plan de l'élément.

backColor
Color

Color qui représente la couleur d'arrière-plan de l'élément.

font
Font

Font à appliquer au texte de l'élément.

Remarques

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public ListViewItem (string[] items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
public ListViewItem (string[]? items, int imageIndex, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font? font);
new System.Windows.Forms.ListViewItem : string[] * int * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, foreColor As Color, backColor As Color, font As Font)

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

foreColor
Color

Color représentant la couleur de premier plan de l'élément.

backColor
Color

Color qui représente la couleur d'arrière-plan de l'élément.

font
Font

Font qui représente la police dans laquelle afficher le texte de l'élément.

Exemples

L’exemple de code suivant crée un formulaire qui contient un ListView contrôle qui trie manuellement les éléments lorsqu’une colonne du ListView contrôle est cliquée. L’exemple définit une classe appelée ListViewItemComparer qui implémente l’interface System.Collections.IComparer qui effectue la ListViewItem comparaison. L’exemple crée une instance de et l’utilise ListViewItemComparer pour définir la ListViewItemSorter propriété du ListView contrôle. L’appel Sort de méthode dans le ColumnClick gestionnaire d’événements utilise les méthodes définies dans ListViewItemComparer pour effectuer le type d’éléments, en fonction de la colonne sur laquelle on clique.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::Collections;

// Implements the manual sorting of items by columns.
ref class ListViewItemComparer: public IComparer
{
private:
   int col;

public:
   ListViewItemComparer()
   {
      col = 0;
   }

   ListViewItemComparer( int column )
   {
      col = column;
   }

   virtual int Compare( Object^ x, Object^ y )
   {
      return String::Compare( (dynamic_cast<ListViewItem^>(x))->SubItems[ col ]->Text,
                              (dynamic_cast<ListViewItem^>(y))->SubItems[ col ]->Text );
   }
};

public ref class ListViewSortForm: public Form
{
private:
   ListView^ listView1;

public:
   ListViewSortForm()
   {
      // Create ListView items to add to the control.
      array<String^>^temp0 = {"Banana","a","b","c"};
      ListViewItem^ listViewItem1 = gcnew ListViewItem( temp0,-1,Color::Empty,Color::Yellow,nullptr );
      array<String^>^temp1 = {"Cherry","v","g","t"};
      ListViewItem^ listViewItem2 = gcnew ListViewItem( temp1,-1,Color::Empty,Color::Red,
                 gcnew System::Drawing::Font( "Microsoft Sans Serif",8.25F,FontStyle::Regular,GraphicsUnit::Point,0 ) );
      array<String^>^temp2 = {"Apple","h","j","n"};
      ListViewItem^ listViewItem3 = gcnew ListViewItem( temp2,-1,Color::Empty,Color::Lime,nullptr );
      array<String^>^temp3 = {"Pear","y","u","i"};
      ListViewItem^ listViewItem4 = gcnew ListViewItem( temp3,-1,Color::Empty,Color::FromArgb( 192, 128, 156 ),nullptr );

      //Initialize the ListView control and add columns to it.
      this->listView1 = gcnew ListView;

      // Set the initial sorting type for the ListView.
      this->listView1->Sorting = SortOrder::None;

      // Disable automatic sorting to enable manual sorting.
      this->listView1->View = View::Details;

      // Add columns and set their text.
      this->listView1->Columns->Add( gcnew ColumnHeader );
      this->listView1->Columns[ 0 ]->Text = "Column 1";
      this->listView1->Columns[ 0 ]->Width = 100;
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 1 ]->Text = "Column 2";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 2 ]->Text = "Column 3";
      listView1->Columns->Add( gcnew ColumnHeader );
      listView1->Columns[ 3 ]->Text = "Column 4";

      // Suspend control logic until form is done configuring form.
      this->SuspendLayout();

      // Add Items to the ListView control.
      array<ListViewItem^>^temp4 = {listViewItem1,listViewItem2,listViewItem3,listViewItem4};
      this->listView1->Items->AddRange( temp4 );

      // Set the location and size of the ListView control.
      this->listView1->Location = Point(10,10);
      this->listView1->Name = "listView1";
      this->listView1->Size = System::Drawing::Size( 300, 100 );
      this->listView1->TabIndex = 0;

      // Enable editing of the items in the ListView.
      this->listView1->LabelEdit = true;

      // Connect the ListView::ColumnClick event to the ColumnClick event handler.
      this->listView1->ColumnClick += gcnew ColumnClickEventHandler( this, &ListViewSortForm::ColumnClick );

      // Initialize the form.
      this->ClientSize = System::Drawing::Size( 400, 400 );
      array<Control^>^temp5 = {this->listView1};
      this->Controls->AddRange( temp5 );
      this->Name = "ListViewSortForm";
      this->Text = "Sorted ListView Control";

      // Resume lay[Out] of* the form.
      this->ResumeLayout( false );
   }

private:

   // ColumnClick event handler.
   void ColumnClick( Object^ /*o*/, ColumnClickEventArgs^ e )
   {
      // Set the ListViewItemSorter property to a new ListViewItemComparer 
      // object. Setting this property immediately sorts the 
      // ListView using the ListViewItemComparer object.
      this->listView1->ListViewItemSorter = gcnew ListViewItemComparer( e->Column );
   }
};

[System::STAThreadAttribute]
int main()
{
   Application::Run( gcnew ListViewSortForm );
}
using System;
using System.Windows.Forms;
using System.Drawing;
using System.Collections;

namespace ListViewSortFormNamespace
{

    public class ListViewSortForm : Form
    {
        private ListView listView1;
       
        public ListViewSortForm()
        {
            // Create ListView items to add to the control.
            ListViewItem listViewItem1 = new ListViewItem(new string[] {"Banana","a","b","c"}, -1, Color.Empty, Color.Yellow, null);
            ListViewItem listViewItem2 = new ListViewItem(new string[] {"Cherry","v","g","t"}, -1, Color.Empty, Color.Red, new Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, ((System.Byte)(0))));
            ListViewItem listViewItem3 = new ListViewItem(new string[] {"Apple","h","j","n"}, -1, Color.Empty, Color.Lime, null);
            ListViewItem listViewItem4 = new ListViewItem(new string[] {"Pear","y","u","i"}, -1, Color.Empty, Color.FromArgb(((System.Byte)(192)), ((System.Byte)(128)), ((System.Byte)(156))), null);
     
            //Initialize the ListView control and add columns to it.
            this.listView1 = new ListView();

            // Set the initial sorting type for the ListView.
            this.listView1.Sorting = SortOrder.None;
            // Disable automatic sorting to enable manual sorting.
            this.listView1.View = View.Details;
            // Add columns and set their text.
            this.listView1.Columns.Add(new ColumnHeader());
            this.listView1.Columns[0].Text = "Column 1";
            this.listView1.Columns[0].Width = 100;
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[1].Text = "Column 2";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[2].Text = "Column 3";
            listView1.Columns.Add(new ColumnHeader());
            listView1.Columns[3].Text = "Column 4";
            // Suspend control logic until form is done configuring form.
            this.SuspendLayout();
            // Add Items to the ListView control.
            this.listView1.Items.AddRange(new ListViewItem[] {listViewItem1,
                listViewItem2,
                listViewItem3,
                listViewItem4});
            // Set the location and size of the ListView control.
            this.listView1.Location = new Point(10, 10);
            this.listView1.Name = "listView1";
            this.listView1.Size = new Size(300, 100);
            this.listView1.TabIndex = 0;
            // Enable editing of the items in the ListView.
            this.listView1.LabelEdit = true;
            // Connect the ListView.ColumnClick event to the ColumnClick event handler.
            this.listView1.ColumnClick += new ColumnClickEventHandler(ColumnClick);
            
            // Initialize the form.
            this.ClientSize = new Size(400, 400);
            this.Controls.AddRange(new Control[] {this.listView1});
            this.Name = "ListViewSortForm";
            this.Text = "Sorted ListView Control";
            // Resume layout of the form.
            this.ResumeLayout(false);
        }

        // ColumnClick event handler.
        private void ColumnClick(object o, ColumnClickEventArgs e)
        {
            // Set the ListViewItemSorter property to a new ListViewItemComparer 
            // object. Setting this property immediately sorts the 
            // ListView using the ListViewItemComparer object.
            this.listView1.ListViewItemSorter = new ListViewItemComparer(e.Column);
        }

        [System.STAThreadAttribute()]
        public static void Main()
        {
            Application.Run(new ListViewSortForm());
        }
    }

    // Implements the manual sorting of items by columns.
    class ListViewItemComparer : IComparer
    {
        private int col;
        public ListViewItemComparer()
        {
            col = 0;
        }
        public ListViewItemComparer(int column)
        {
            col = column;
        }
        public int Compare(object x, object y)
        {
            return String.Compare(((ListViewItem)x).SubItems[col].Text, ((ListViewItem)y).SubItems[col].Text);
        }
    }
}
Imports System.Windows.Forms
Imports System.Drawing
Imports System.Collections


Namespace ListViewSortFormNamespace

    Public Class ListViewSortForm
        Inherits Form

        Private listView1 As ListView

        Public Sub New()
            ' Create ListView items to add to the control.
            Dim listViewItem1 As New ListViewItem(New String() {"Banana", "a", "b", "c"}, -1, Color.Empty, Color.Yellow, Nothing)
            Dim listViewItem2 As New ListViewItem(New String() {"Cherry", "v", "g", "t"}, -1, Color.Empty, Color.Red, New Font("Microsoft Sans Serif", 8.25F, FontStyle.Regular, GraphicsUnit.Point, CType(0, System.Byte)))
            Dim listViewItem3 As New ListViewItem(New String() {"Apple", "h", "j", "n"}, -1, Color.Empty, Color.Lime, Nothing)
            Dim listViewItem4 As New ListViewItem(New String() {"Pear", "y", "u", "i"}, -1, Color.Empty, Color.FromArgb(CType(192, System.Byte), CType(128, System.Byte), CType(156, System.Byte)), Nothing)

            'Initialize the ListView control and add columns to it.
            Me.listView1 = New ListView

            ' Set the initial sorting type for the ListView.
            Me.listView1.Sorting = SortOrder.None
            ' Disable automatic sorting to enable manual sorting.
            Me.listView1.View = View.Details
            ' Add columns and set their text.
            Me.listView1.Columns.Add(New ColumnHeader)
            Me.listView1.Columns(0).Text = "Column 1"
            Me.listView1.Columns(0).Width = 100
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(1).Text = "Column 2"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(2).Text = "Column 3"
            listView1.Columns.Add(New ColumnHeader)
            listView1.Columns(3).Text = "Column 4"
            ' Suspend control logic until form is done configuring form.
            Me.SuspendLayout()
            ' Add Items to the ListView control.
            Me.listView1.Items.AddRange(New ListViewItem() {listViewItem1, listViewItem2, listViewItem3, listViewItem4})
            ' Set the location and size of the ListView control.
            Me.listView1.Location = New Point(10, 10)
            Me.listView1.Name = "listView1"
            Me.listView1.Size = New Size(300, 100)
            Me.listView1.TabIndex = 0
            ' Enable editing of the items in the ListView.
            Me.listView1.LabelEdit = True
            ' Connect the ListView.ColumnClick event to the ColumnClick event handler.
            AddHandler Me.listView1.ColumnClick, AddressOf ColumnClick

            ' Initialize the form.
            Me.ClientSize = New Size(400, 400)
            Me.Controls.AddRange(New Control() {Me.listView1})
            Me.Name = "ListViewSortForm"
            Me.Text = "Sorted ListView Control"
            ' Resume layout of the form.
            Me.ResumeLayout(False)
        End Sub


        ' ColumnClick event handler.
        Private Sub ColumnClick(ByVal o As Object, ByVal e As ColumnClickEventArgs)
            ' Set the ListViewItemSorter property to a new ListViewItemComparer 
            ' object. Setting this property immediately sorts the 
            ' ListView using the ListViewItemComparer object.
            Me.listView1.ListViewItemSorter = New ListViewItemComparer(e.Column)
        End Sub

    End Class

    ' Implements the manual sorting of items by columns.
    Class ListViewItemComparer
        Implements IComparer

        Private col As Integer

        Public Sub New()
            col = 0
        End Sub

        Public Sub New(ByVal column As Integer)
            col = column
        End Sub

        Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer _
           Implements IComparer.Compare
            Return [String].Compare(CType(x, ListViewItem).SubItems(col).Text, CType(y, ListViewItem).SubItems(col).Text)
        End Function
    End Class
End Namespace

Voir aussi

S’applique à

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.

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String, group As ListViewGroup)

Paramètres

subItems
ListViewItem.ListViewSubItem[]

Tableau d'objets ListViewItem.ListViewSubItem qui représentent les sous-éléments de ListViewItem.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur est utile lorsque vous créez ListViewItem.ListViewSubItem des objets avant de les ajouter à un ListViewItem (par exemple, pour indiquer une mise en forme spéciale ou utiliser les sous-éléments dans plusieurs éléments). Il vous permet également de spécifier le groupe auquel appartient un élément.

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

S’applique à

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é.

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer, group As ListViewGroup)

Paramètres

subItems
ListViewItem.ListViewSubItem[]

Tableau de ListViewItem.ListViewSubItem type qui représentent les sous-éléments de l'élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur est utile lorsque vous créez ListViewItem.ListViewSubItem des objets avant de les ajouter à un ListViewItem objet (par exemple, pour indiquer une mise en forme spéciale ou pour utiliser les sous-éléments dans plusieurs éléments). Il vous permet également de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Voir aussi

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String, group As ListViewGroup)

Paramètres

items
String[]

Tableau de chaînes qui représente le texte pour les sous-éléments de ListViewItem.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

S’applique à

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é.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer, group As ListViewGroup)

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Voir aussi

S’applique à

ListViewItem(String, String, ListViewGroup)

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

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, string imageKey, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, string? imageKey, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String, group As ListViewGroup)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

S’applique à

ListViewItem(ListViewItem+ListViewSubItem[], String)

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

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, System::String ^ imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string imageKey);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, string? imageKey);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageKey As String)

Paramètres

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans ListViewItem.

Remarques

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

S’applique à

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é.

public:
 ListViewItem(System::String ^ text, int imageIndex, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, int imageIndex, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, int imageIndex, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * int * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer, group As ListViewGroup)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

Voir aussi

S’applique à

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é.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string[] items, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string[]? items, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string[] * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), group As ListViewGroup)

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Voir aussi

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, System::String ^ imageKey);
public ListViewItem (string[] items, string imageKey);
public ListViewItem (string[]? items, string? imageKey);
new System.Windows.Forms.ListViewItem : string[] * string -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageKey As String)

Paramètres

items
String[]

Tableau contenant le texte des sous-éléments de ListViewItem.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans ListViewItem.

Remarques

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

S’applique à

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.

public:
 ListViewItem(cli::array <System::String ^> ^ items, int imageIndex);
public ListViewItem (string[] items, int imageIndex);
public ListViewItem (string[]? items, int imageIndex);
new System.Windows.Forms.ListViewItem : string[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (items As String(), imageIndex As Integer)

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

Voir aussi

S’applique à

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é.

public:
 ListViewItem(System::String ^ text, System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (string text, System.Windows.Forms.ListViewGroup group);
public ListViewItem (string? text, System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : string * System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, group As ListViewGroup)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

Voir aussi

S’applique à

ListViewItem(String, String)

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

public:
 ListViewItem(System::String ^ text, System::String ^ imageKey);
public ListViewItem (string text, string imageKey);
public ListViewItem (string? text, string? imageKey);
new System.Windows.Forms.ListViewItem : string * string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageKey As String)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

imageKey
String

Nom de l'image dans ImageList de ListView propriétaire à afficher dans ListViewItem.

Remarques

Le imageKey paramètre spécifie une image dans le ImageList associé au contrôle propriétaire ListView , qui est accessible avec la ImageList propriété .

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

S’applique à

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.

public:
 ListViewItem(System::String ^ text, int imageIndex);
public ListViewItem (string text, int imageIndex);
public ListViewItem (string? text, int imageIndex);
new System.Windows.Forms.ListViewItem : string * int -> System.Windows.Forms.ListViewItem
Public Sub New (text As String, imageIndex As Integer)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

Remarques

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

Voir aussi

S’applique à

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.

protected:
 ListViewItem(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ListViewItem (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Windows.Forms.ListViewItem : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Windows.Forms.ListViewItem
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Paramètres

info
SerializationInfo

SerializationInfo contenant les informations sur ListViewItem à initialiser.

context
StreamingContext

StreamingContext qui indique la source de destination et les informations de contexte d'un flux sérialisé.

S’applique à

ListViewItem(ListViewGroup)

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

public:
 ListViewItem(System::Windows::Forms::ListViewGroup ^ group);
public ListViewItem (System.Windows.Forms.ListViewGroup group);
public ListViewItem (System.Windows.Forms.ListViewGroup? group);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewGroup -> System.Windows.Forms.ListViewItem
Public Sub New (group As ListViewGroup)

Paramètres

group
ListViewGroup

ListViewGroup auquel assigner l'élément.

Remarques

Cette version du constructeur vous permet de spécifier le groupe auquel appartient un élément.

Notes

ListView Les groupes sont disponibles uniquement sur Windows XP et la famille Windows Server 2003 (Windows XP Édition Familiale, Windows XP Professionnel, Windows Server 2003). Pour plus d'informations, consultez la rubrique de vue d'ensemble ListViewGroup.

Voir aussi

S’applique à

ListViewItem(String[])

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

public:
 ListViewItem(cli::array <System::String ^> ^ items);
public ListViewItem (string[] items);
public ListViewItem (string[]? items);
new System.Windows.Forms.ListViewItem : string[] -> System.Windows.Forms.ListViewItem
Public Sub New (items As String())

Paramètres

items
String[]

Tableau de chaînes représentant les sous-éléments du nouvel élément.

S’applique à

ListViewItem(String)

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

public:
 ListViewItem(System::String ^ text);
public ListViewItem (string text);
public ListViewItem (string? text);
new System.Windows.Forms.ListViewItem : string -> System.Windows.Forms.ListViewItem
Public Sub New (text As String)

Paramètres

text
String

Texte à afficher pour l'élément. Il ne doit pas dépasser 259 caractères.

Remarques

Le texte du ListViewItem ne doit pas dépasser 259 caractères ou un comportement inattendu peut se produire.

S’applique à

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.

public:
 ListViewItem(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ subItems, int imageIndex);
public ListViewItem (System.Windows.Forms.ListViewItem.ListViewSubItem[] subItems, int imageIndex);
new System.Windows.Forms.ListViewItem : System.Windows.Forms.ListViewItem.ListViewSubItem[] * int -> System.Windows.Forms.ListViewItem
Public Sub New (subItems As ListViewItem.ListViewSubItem(), imageIndex As Integer)

Paramètres

subItems
ListViewItem.ListViewSubItem[]

Tableau de ListViewItem.ListViewSubItem type qui représentent les sous-éléments de l'élément.

imageIndex
Int32

Index de base zéro de l'image dans le ImageList associé au ListView qui contient l'élément.

Remarques

Cette version du constructeur est utile lorsque vous créez ListViewItem.ListViewSubItem des objets avant de les ajouter à un ListViewItem (par exemple, pour indiquer une mise en forme spéciale ou utiliser les sous-éléments dans plusieurs éléments).

Voir aussi

S’applique à