Freigeben über


ListViewItem Konstruktoren

Definition

Initialisiert eine neue Instanz der ListViewItem-Klasse.

Überlädt

ListViewItem()

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Standardwerten.

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild, die angegebene Gruppe sowie die angegebenen Farben und die angegebene Schriftart enthalten.

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen. Weist das Element der angegebenen Gruppe zu.

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild sowie die angegebenen Farben und die angegebene Schriftart enthalten.

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen.

ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen, dem angegebenen Bild und der angegebenen Gruppe.

ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten, und weist das Element der angegebenen Gruppe zu.

ListViewItem(String[], String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild und die angegebene Gruppe enthalten.

ListViewItem(String[], Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.

ListViewItem(String, String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text, dem angegebenen Bild und der angegebenen Gruppe.

ListViewItem(ListViewItem+ListViewSubItem[], String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen und dem angegebenen Bild.

ListViewItem(String, Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol, und weist das Element der angegebenen Gruppe zu.

ListViewItem(String[], ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.

ListViewItem(String[], String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Element, dem angegebenen Unterelementtext und dem angegebenen Bild.

ListViewItem(String[], Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen.

ListViewItem(String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und weist diese der angegebenen Gruppe zu.

ListViewItem(String, String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text und dem angegebenen Bild.

ListViewItem(String, Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol.

ListViewItem(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Streamingkontext

ListViewItem(ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse und weist diese der angegebenen Gruppe zu.

ListViewItem(String[])

Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen.

ListViewItem(String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext.

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten.

ListViewItem()

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Standardwerten.

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

Beispiele

Im folgenden Codebeispiel wird ein ListView Steuerelement mit drei ListViewItem angegebenen Objekten und drei ListViewItem.ListViewSubItem für jedes Element angegebenen Objekten erstellt. Im Beispiel werden auch Objekte erstellt ColumnHeader , um die Unterelemente in der Detailansicht anzuzeigen. Im Codebeispiel werden auch zwei ImageList -Objekte erstellt, um Bilder für die ListViewItem -Objekte bereitzustellen. Diese ImageList Objekte werden den LargeImageList Eigenschaften und SmallImageList hinzugefügt. Im Beispiel werden die folgenden Eigenschaften zum Erstellen des Steuerelements ListView verwendet:

Sie müssen den Code zu einem Form hinzufügen und die im Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Für das Beispiel müssen sich Bilder mit den Namen MySmallImage1, MySmallImage2, MyLargeImage1und MyLargeImage2 im Stammverzeichnis von Laufwerk C befinden.

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

Gilt für:

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild, die angegebene Gruppe sowie die angegebenen Farben und die angegebene Schriftart enthalten.

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)

Parameter

items
String[]

Ein Zeichenfolgenarray, das den Text für die Unterelemente für das ListViewItem darstellt.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.

foreColor
Color

Eine Color, die die Vordergrundfarbe des Elements darstellt.

backColor
Color

Eine Color, die die Hintergrundfarbe des Elements darstellt.

font
Font

Ein Font, der auf den Elementtext angewendet werden soll.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Der imageKey Parameter gibt ein Bild im an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Gilt für:

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen. Weist das Element der angegebenen Gruppe zu.

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)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

foreColor
Color

Eine Color, die die Vordergrundfarbe des Elements darstellt.

backColor
Color

Eine Color, die die Hintergrundfarbe des Elements darstellt.

font
Font

Ein Font, der die Schriftart darstellt, in der der Elementtext angezeigt werden soll.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Weitere Informationen

Gilt für:

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild sowie die angegebenen Farben und die angegebene Schriftart enthalten.

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)

Parameter

items
String[]

Ein Zeichenfolgenarray, das den Text für Unterelemente für das ListViewItem darstellt.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.

foreColor
Color

Eine Color, die die Vordergrundfarbe des Elements darstellt.

backColor
Color

Eine Color, die die Hintergrundfarbe des Elements darstellt.

font
Font

Ein Font, der auf den Elementtext angewendet werden soll.

Hinweise

Der imageKey Parameter gibt ein Bild im an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Gilt für:

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

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol, der Vorder- und Hintergrundfarbe und Schriftart des Elements, sowie einem Array von Zeichenfolgen, die Unterelemente darstellen.

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)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

foreColor
Color

Eine Color, die die Vordergrundfarbe des Elements darstellt.

backColor
Color

Eine Color, die die Hintergrundfarbe des Elements darstellt.

font
Font

Ein Font, der die Schriftart darstellt, in der der Elementtext angezeigt werden soll.

Beispiele

Im folgenden Codebeispiel wird ein Formular erstellt, das ein ListView Steuerelement enthält, das Elemente manuell sortiert, wenn auf eine Spalte im ListView Steuerelement geklickt wird. Im Beispiel wird eine Klasse namens ListViewItemComparer definiert, die die System.Collections.IComparer Schnittstelle implementiert, die den ListViewItem Vergleich durchführt. Im Beispiel wird eine instance von ListViewItemComparer erstellt und verwendet, um die ListViewItemSorter -Eigenschaft des ListView Steuerelements festzulegen. Der Sort Methodenaufruf im ColumnClick Ereignishandler verwendet die in ListViewItemComparer definierten Methoden, um die Art von Elementen basierend auf der Spalte auszuführen, auf die geklickt wird.

#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

Weitere Informationen

Gilt für:

ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen, dem angegebenen Bild und der angegebenen Gruppe.

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)

Parameter

subItems
ListViewItem.ListViewSubItem[]

Ein Array von ListViewItem.ListViewSubItem-Objekten, das die Unterelemente von ListViewItem darstellt.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem hinzufügen (z. B. um eine spezielle Formatierung anzugeben oder die Unterelemente in mehreren Elementen zu verwenden). Außerdem können Sie die Gruppe angeben, zu der ein Element gehört.

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Gilt für:

ListViewItem(ListViewItem+ListViewSubItem[], Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten, und weist das Element der angegebenen Gruppe zu.

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)

Parameter

subItems
ListViewItem.ListViewSubItem[]

Ein Array vom Typ ListViewItem.ListViewSubItem, das die Unterelemente des Elements darstellt.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem Objekt hinzufügen (z. B. um spezielle Formatierungen anzugeben oder die Unterelemente in mehreren Elementen zu verwenden). Außerdem können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Weitere Informationen

Gilt für:

ListViewItem(String[], String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild und die angegebene Gruppe enthalten.

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)

Parameter

items
String[]

Ein Zeichenfolgenarray, das den Text für Unterelemente von ListViewItem darstellt.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Gilt für:

ListViewItem(String[], Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.

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)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Weitere Informationen

Gilt für:

ListViewItem(String, String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text, dem angegebenen Bild und der angegebenen Gruppe.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, in der das Element angezeigt werden soll.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Gilt für:

ListViewItem(ListViewItem+ListViewSubItem[], String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen und dem angegebenen Bild.

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)

Parameter

subItems
ListViewItem.ListViewSubItem[]

Ein Array von ListViewItem.ListViewSubItem-Objekten.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.

Hinweise

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Gilt für:

ListViewItem(String, Int32, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol, und weist das Element der angegebenen Gruppe zu.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Weitere Informationen

Gilt für:

ListViewItem(String[], ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen, und weist das Element der angegebenen Gruppe zu.

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)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Weitere Informationen

Gilt für:

ListViewItem(String[], String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Element, dem angegebenen Unterelementtext und dem angegebenen Bild.

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)

Parameter

items
String[]

Ein Array, das den Text der Unterelemente der ListViewItem enthält.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.

Hinweise

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Gilt für:

ListViewItem(String[], Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von Zeichenfolgen, die Unterelemente darstellen.

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)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

Weitere Informationen

Gilt für:

ListViewItem(String, ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und weist diese der angegebenen Gruppe zu.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Weitere Informationen

Gilt für:

ListViewItem(String, String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text und dem angegebenen Bild.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

imageKey
String

Der Name des Bilds in der ImageList der besitzenden ListView, das im ListViewItem angezeigt werden soll.

Hinweise

Der imageKey Parameter gibt ein Bild in dem an, das ImageList dem besitzenden ListView Steuerelement zugeordnet ist, auf das mit der ImageList -Eigenschaft zugegriffen werden kann.

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Gilt für:

ListViewItem(String, Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

Hinweise

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Weitere Informationen

Gilt für:

ListViewItem(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Streamingkontext

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)

Parameter

info
SerializationInfo

Eine SerializationInfo, die Informationen über das zu initialisierende ListViewItem enthält.

context
StreamingContext

Ein StreamingContext, der das Quellziel und die Kontextinformationen eines serialisierten Streams angibt.

Gilt für:

ListViewItem(ListViewGroup)

Initialisiert eine neue Instanz der ListViewItem-Klasse und weist diese der angegebenen Gruppe zu.

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)

Parameter

group
ListViewGroup

Die ListViewGroup, der das Element zugewiesen werden soll.

Hinweise

Mit dieser Version des Konstruktors können Sie die Gruppe angeben, zu der ein Element gehört.

Hinweis

ListView Gruppen sind nur unter Windows XP und der Windows Server 2003-Familie (Windows XP Home Edition, Windows XP Professional, Windows Server 2003) verfügbar. Weitere Informationen finden Sie in der Übersicht für die ListViewGroup.

Weitere Informationen

Gilt für:

ListViewItem(String[])

Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen.

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

Parameter

items
String[]

Ein Array von Zeichenfolgen, die Unterelemente des neuen Elements darstellen.

Gilt für:

ListViewItem(String)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext.

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)

Parameter

text
String

Der für das Element anzuzeigende Text. Der Text darf nicht länger als 259 Zeichen sein.

Hinweise

Der Text des ListViewItem sollte nicht länger als 259 Zeichen sein, andernfalls kann unerwartetes Verhalten auftreten.

Gilt für:

ListViewItem(ListViewItem+ListViewSubItem[], Int32)

Initialisiert eine neue Instanz der ListViewItem-Klasse mit der Indexposition des Bilds für das Elementsymbol und einem Array von ListViewItem.ListViewSubItem-Objekten.

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)

Parameter

subItems
ListViewItem.ListViewSubItem[]

Ein Array vom Typ ListViewItem.ListViewSubItem, das die Unterelemente des Elements darstellt.

imageIndex
Int32

Der nullbasierte Bildindex in der ImageList, die der ListView zugeordnet ist, die das Element enthält.

Hinweise

Diese Version des Konstruktors ist nützlich, wenn Sie Objekte erstellen ListViewItem.ListViewSubItem , bevor Sie sie einem ListViewItem hinzufügen (z. B. um eine spezielle Formatierung anzugeben oder die Unterelemente in mehreren Elementen zu verwenden).

Weitere Informationen

Gilt für: