ListViewItem.ListViewSubItem 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 Unterelement eines ListViewItem dar.

public: ref class ListViewItem::ListViewSubItem

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewSubItemConverter))]
[System.Serializable]
public class ListViewItem.ListViewSubItem

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListViewSubItemConverter))>]
[<System.Serializable>]
type ListViewItem.ListViewSubItem = class

Public Class ListViewItem.ListViewSubItem

Vererbung: Object
ListViewItem.ListViewSubItem

Attribute: TypeConverterAttribute SerializableAttribute

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. Das Beispiel verwendet die folgenden Eigenschaften beim Erstellen des ListView Steuerelements.

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

Ein ListView Steuerelement zeigt eine Liste der Elemente an, die von der ListViewItem Klasse definiert werden. Jede ListViewItem kann Unterelementobjekte speichern, die von der ListViewItem.ListViewSubItem Klasse definiert werden. Unterelemente werden angezeigt, wenn die View Eigenschaft des ListView Steuerelements auf Details"festgelegt" festgelegt ist. In der Regel enthalten Unterelemente Informationen, die im Zusammenhang mit ihrem übergeordneten Element stehen. Wenn beispielsweise ein ListView Steuerelement Elemente anzeigt, die Bestellungen darstellen, könnte jedes Element die Bestellnummer anzeigen. Unterelemente können jedem Element hinzugefügt werden, um Informationen wie das bestellte Produkt, die Menge der bestellten Elemente und den Gesamtpreis der bestellten Elemente anzuzeigen. Im Gegensatz ListViewItem zu Objekten können Objekte nicht direkt vom Benutzer bearbeitet werden (der Benutzer kann Objekte bearbeitenListViewItem, ListViewItem.ListViewSubItem wenn die LabelEdit Eigenschaft des ListView Steuerelements auf truefestgelegt ist).

Da Unterelemente nicht direkt vom Benutzer bearbeitet werden können und keine Bilder angezeigt werden, sind Eigenschaften auf diejenigen beschränkt, die sich auf die Formatvorlage des Unterelementtexts auswirken, wenn sie im ListView Steuerelement angezeigt wird. Wenn die UseItemStyleForSubItems Eigenschaft der ListView mit den Unteritems festgelegt falseist, können Sie die Font BackColorFormatvorlagen verwenden, ForeColor die auf die Textanzeige angewendet werden. In der Regel sind die Formatvorlagen des Elements und die Unterelemente in einem ListView Steuerelement identisch, aber wenn Sie die Formatvorlage eines bestimmten ListViewItem.ListViewSubItem Zum Hervorhebens ändern möchten, können Sie diese Eigenschaften auf den Elementen verwenden, die Sie anders anzeigen möchten.

Konstruktoren

ListViewItem.ListViewSubItem()	Initialisiert eine neue Instanz der ListViewItem.ListViewSubItem-Klasse mit Standardwerten.
ListViewItem.ListViewSubItem(ListViewItem, String)	Initialisiert eine neue Instanz der ListViewItem.ListViewSubItem-Klasse mit dem angegebenen Besitzer und Text.
ListViewItem.ListViewSubItem(ListViewItem, String, Color, Color, Font)	Initialisiert eine neue Instanz der ListViewItem.ListViewSubItem-Klasse mit dem angegebenen Besitzer, einem angegebenen Text und angegebenen Werten für die Vorder- und Hintergrundfarbe sowie die Schriftart.

Eigenschaften

BackColor	Ruft die Hintergrundfarbe für den Text des Unterelements ab oder legt diese fest.
Bounds	Ruft das umschließende Rechteck des ListViewItem.ListViewSubItem ab.
Font	Ruft die Schriftart für den angezeigten Text des Unterelements ab oder legt diese fest.
ForeColor	Ruft die Vordergrundfarbe für den Text des Unterelements ab oder legt diese fest.
Name	Ruft den Namen der ListViewItem.ListViewSubItem ab oder legt diesen fest.
Tag	Ruft das Objekt ab, das Daten über das ListViewItem.ListViewSubItem enthält, oder legt dieses Objekt fest.
Text	Ruft den Text des Unterelements ab oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ResetStyle()	Setzt die für das Unterelement übernommenen Formate auf die Standardschriftart und -farben zurück.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

Gilt für

Siehe auch

ListViewItem