ListViewItem Klasse

Definition

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:

• View

• LabelEdit

• AllowColumnReorder

• CheckBoxes

• FullRowSelect

• GridLines

• Sorting

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

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für

Siehe auch

• ListView
• ListViewItem.ListViewSubItem
• ListView-Steuerelement (Windows Forms)