ListViewItem Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Element in einem ListView-Steuerelement dar.

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

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

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

Public Class ListViewItem
Implements ICloneable, ISerializable

Vererbung: Object
ListViewItem

Attribute: TypeConverterAttribute SerializableAttribute

Implementiert: ICloneable ISerializable

Beispiele

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

Sie müssen dem Formular den Code Form hinzufügen und die in dem Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Das Beispiel erfordert, dass Bilder namens MySmallImage1, , MySmallImage2``MyLargeImage1und MyLargeImage2 sich im Stammverzeichnis des Laufwerks 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

Hinweise

Das ListView Steuerelement ähnelt einem ListBox In, in dem eine Liste von Elementen angezeigt wird. Der Hauptunterschied besteht darin, dass das ListView Steuerelement eine Reihe verschiedener Möglichkeiten bereitstellt, wie Elemente vom Benutzer angezeigt werden können. Die ListViewItem Klasse definiert die Darstellung, das Verhalten und die Daten, die einem Element zugeordnet sind, das im ListView Steuerelement angezeigt wird. ListViewItem Objekte können im Steuerelement in ListView einer von vier verschiedenen Ansichten angezeigt werden. Elemente können als große oder kleine Symbole oder als kleine Symbole in einer vertikalen Liste angezeigt werden. Elemente können auch Unterelemente enthalten, die Informationen enthalten, die sich auf das übergeordnete Element beziehen. Mit dem vierten Ansichtsformat, der Detailansicht können Sie das Element und seine Unterelemente in einem Raster mit Spaltenüberschriften anzeigen, die verwendet werden können, um die Informationen zu identifizieren, die in einem Unterelement angezeigt werden.

Die meisten Eigenschaften der ListViewItem Klasse bieten Möglichkeiten zum Ändern der Anzeige des Elements im ListView Steuerelement, dem sie zugeordnet ist. ForeColor Font Mit BackColorden ListView Eigenschaften und Eigenschaften können Sie ändern, wie der Text des Elements im Steuerelement angezeigt wird. Mit ImageIndex der Eigenschaft können Sie das Bild ImageList angeben, das vom Steuerelement geladen werden ListView soll (indem Sie die LargeImageList SmallImageList Eigenschaften des ListViewSteuerelements festlegen). Elemente können Kontrollkästchen anzeigen, um Elementauswahlen vom Benutzer auf eine Weise wie ein CheckedListBox Steuerelement abzurufen. Sie können die Checked Eigenschaft verwenden, um festzustellen, ob ein Element aktiviert ist, oder um das Kontrollkästchen zur Laufzeit auszuwählen oder zu deaktivieren. Elemente können eine beliebige Anzahl von Unterelementen anzeigen, wenn die View Eigenschaft des zugeordneten ListView Steuerelements auf Details und Spalten im ListView.ColumnHeaderCollection ListView Steuerelement definiert ist. Sie können Teilelemente zu einem Element hinzufügen, indem Sie die Add Methode der ListViewItem.ListViewSubItemCollection Klasse aufrufen. Mit der SubItems Eigenschaft können Sie Zugriff auf die ListViewItem.ListViewSubItemCollection Klasse und deren Mitglieder erhalten.

Einige der Eigenschaften und Methoden der ListViewItem Klasse sind elementspezifische Versionen von Eigenschaften und Methoden im ListView Steuerelement. Die Methode ähnelt beispielsweise EnsureVisible der ListView Version der Methode, die ListViewItem Version wirkt sich jedoch nur auf das aktuelle Element aus.

Die ListViewItem Klasse enthält auch Methoden, die keine Versionen von ListView Methoden sind. Die BeginEdit Methode platziert den Text des Elements im Bearbeitungsmodus, sodass der Benutzer den Text des Elements ändern kann (wenn die LabelEdit Eigenschaft des ListView Steuerelements auf truefestgelegt ist). Mit der Clone Methode können Sie Kopien vorhandener ListViewItem Objekte erstellen, die in anderen ListView Steuerelementen wiederverwendet werden können.

Konstruktoren

ListViewItem()	Initialisiert eine neue Instanz der ListViewItem-Klasse mit Standardwerten.
ListViewItem(ListViewGroup)	Initialisiert eine neue Instanz der ListViewItem-Klasse und weist diese der angegebenen Gruppe zu.
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(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(ListViewItem+ListViewSubItem[], String)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen und dem angegebenen Bild.
ListViewItem(ListViewItem+ListViewSubItem[], String, ListViewGroup)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Unterelementen, dem angegebenen Bild und der angegebenen Gruppe.
ListViewItem(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit den angegebenen Serialisierungsinformationen und dem angegebenen Streamingkontext
ListViewItem(String)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext.
ListViewItem(String, Int32)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Elementtext und der Indexposition des Bilds für das Elementsymbol.
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 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, String, ListViewGroup)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit dem angegebenen Text, dem angegebenen Bild und der angegebenen Gruppe.
ListViewItem(String[])	Initialisiert eine neue Instanz der ListViewItem-Klasse mit einem Array von Zeichenfolgen, die Unterelemente darstellen.
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[], 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(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[], 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[], 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[], 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[], 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[], String, ListViewGroup)	Initialisiert eine neue Instanz der ListViewItem-Klasse mit Unterelementen, die den angegebenen Text, das angegebene Bild und die angegebene Gruppe enthalten.

Eigenschaften

BackColor	Ruft die Hintergrundfarbe des Elementtexts ab oder legt diese fest.
Bounds	Ruft das umschließende Rechteck des Elements und der zugehörigen Unterelemente ab.
Checked	Ruft einen Wert ab, der angibt, ob das Element aktiviert ist, oder legt diesen fest.
Focused	Ruft einen Wert ab, der angibt, ob das Element im ListView-Steuerelement den Fokus besitzt, oder legt diesen fest.
Font	Ruft die Schriftart des angezeigten Elementtexts ab oder legt diese fest.
ForeColor	Ruft die Vordergrundfarbe des Elementtexts ab oder legt diese fest.
Group	Ruft die Gruppe ab, der das Element zugewiesen ist, oder legt diese fest.
ImageIndex	Ruft den Index des Bilds ab, das für das Element angezeigt wird, oder legt diesen fest.
ImageKey	Ruft den Schlüssel des Bilds ab, das für das Element angezeigt wird, oder legt diesen fest.
ImageList	Ruft die ImageList ab, die das mit dem Element angezeigte Bild enthält.
IndentCount	Ruft die Werte für die jeweilige Breite kleiner Bilder ab, um die das ListViewItem eingezogen werden soll, oder legt diese fest.
Index	Ruft den nullbasierten Index des Elements im ListView-Steuerelement ab.
ListView	Ruft das ListView-Steuerelement mit dem Element ab.
Name	Ruft den Namen ab, der diesem ListViewItem zugeordnet ist, oder legt diesen fest.
Position	Ruft die Position der linken oberen Ecke von ListViewItem ab oder legt diese fest.
Selected	Ruft einen Wert ab, der angibt, ob das Element ausgewählt ist, oder legt diesen fest.
StateImageIndex	Ruft den Index der Zustandsgrafik (ein Bild, z. B. ein aktiviertes oder deaktiviertes Kontrollkästchen, das den Zustand eines Elements darstellt) ab, die für das Element angezeigt wird, oder legt diesen fest.
SubItems	Ruft eine Auflistung mit allen Unterelementen des Elements ab.
Tag	Ruft das Objekt ab, das dem Element zuzuordnende Daten enthält, oder legt dieses fest.
Text	Ruft den Text des Elements ab oder legt diesen fest.
ToolTipText	Ruft den Text ab, der angezeigt wird, wenn sich der Mauszeiger auf dem ListViewItem befindet, oder legt diesen fest.
UseItemStyleForSubItems	Ruft einen Wert ab, der angibt, ob die Font-Eigenschaft, die ForeColor-Eigenschaft und die BackColor-Eigenschaft des Elements auch für alle zugehörigen Unterelemente verwendet werden sollen.

Methoden

BeginEdit()	Setzt den Text des Elements in den Bearbeitungsmodus.
Clone()	Erstellt eine identische Kopie des Elements.
Deserialize(SerializationInfo, StreamingContext)	Deserialisiert das Element.
EnsureVisible()	Stellt sicher, dass das Element im Steuerelement angezeigt wird und führt ggf. einen Bildlauf durch den Inhalt des Steuerelements durch.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindNearestItem(SearchDirectionHint)	Sucht nach dem nächsten Element von ListViewItem in der angegebenen Richtung.
GetBounds(ItemBoundsPortion)	Ruft den angegebenen Teil des umschließenden Rechtecks für das Element ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetSubItemAt(Int32, Int32)	Gibt das Unterelement von ListViewItem an den angegebenen Koordinaten zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove()	Entfernt das Element aus seinem zugeordneten ListView-Steuerelement.
Serialize(SerializationInfo, StreamingContext)	Serialisiert das Element.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Serialisiert das Element.

Gilt für

Freigeben über