ListViewGroup Konstruktoren

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initialisiert eine neue Instanz der ListViewGroup-Klasse.

Überlädt

ListViewGroup()	Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des Standardheadertextes "ListViewGroup" und der Standardheaderausrichtung (linksbündig).
ListViewGroup(String)	Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des angegebenen Werts zum Initialisieren der Header-Eigenschaft und unter Verwendung der linksbündigen Standardheaderausrichtung.
ListViewGroup(String, String)	Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung der angegebenen Werte zum Initialisieren der Name-Eigenschaft und der Header-Eigenschaft.
ListViewGroup(String, HorizontalAlignment)	Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des angegebenen Headertextes "ListViewGroup" und der angegebenen Headerausrichtung.

ListViewGroup()

Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des Standardheadertextes "ListViewGroup" und der Standardheaderausrichtung (linksbündig).

public:
 ListViewGroup();

public ListViewGroup ();

Public Sub New ()

ListViewGroup(String)

Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des angegebenen Werts zum Initialisieren der Header-Eigenschaft und unter Verwendung der linksbündigen Standardheaderausrichtung.

public:
 ListViewGroup(System::String ^ header);

public ListViewGroup (string header);

public ListViewGroup (string? header);

new System.Windows.Forms.ListViewGroup : string -> System.Windows.Forms.ListViewGroup

Public Sub New (header As String)

Parameter

header

String

Der für den Gruppenheader anzuzeigende Text.

ListViewGroup(String, String)

Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung der angegebenen Werte zum Initialisieren der Name-Eigenschaft und der Header-Eigenschaft.

public:
 ListViewGroup(System::String ^ key, System::String ^ headerText);

public ListViewGroup (string key, string headerText);

public ListViewGroup (string? key, string? headerText);

new System.Windows.Forms.ListViewGroup : string * string -> System.Windows.Forms.ListViewGroup

Public Sub New (key As String, headerText As String)

Parameter

key

String

Der Anfangswert der Name-Eigenschaft.

headerText

String

Der Anfangswert der Header-Eigenschaft.

ListViewGroup(String, HorizontalAlignment)

Initialisiert eine neue Instanz der ListViewGroup-Klasse unter Verwendung des angegebenen Headertextes "ListViewGroup" und der angegebenen Headerausrichtung.

public:
 ListViewGroup(System::String ^ header, System::Windows::Forms::HorizontalAlignment headerAlignment);

public ListViewGroup (string header, System.Windows.Forms.HorizontalAlignment headerAlignment);

public ListViewGroup (string? header, System.Windows.Forms.HorizontalAlignment headerAlignment);

new System.Windows.Forms.ListViewGroup : string * System.Windows.Forms.HorizontalAlignment -> System.Windows.Forms.ListViewGroup

Public Sub New (header As String, headerAlignment As HorizontalAlignment)

Parameter

header

String

Der für den Gruppenheader anzuzeigende Text.

headerAlignment

HorizontalAlignment

Einer der HorizontalAlignment-Werte, der die Ausrichtung des Headertextes angibt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der ListViewGroup Konstruktor in einer Anwendung verwendet werden kann, die Elemente nach Teilelementwert in der Detailansicht organisiert ListView . Diese Gruppierungsform ähnelt der Gruppierung, die in Windows Explorer verwendet wird. Im Beispiel werden die Gruppen dynamisch erstellt. Für jede Teilelementspalte wird eine Gruppe für jeden eindeutigen Teilelementwert erstellt. Für die übergeordnete Elementspalte wird eine Gruppe für jeden eindeutigen Anfangsbuchstaben erstellt. Die für jede Spalte erstellten Gruppen werden zusammen mit dem Unterelementtext oder dem Anfangsbuchstaben in einer Hashtabelle gespeichert. Wenn auf eine Spaltenüberschrift geklickt wird, wird dieser Textwert verwendet, um Elemente mit Gruppen für die entsprechende Spalte zu übereinstimmen.

Das vollständige Beispiel finden Sie im ListViewGroup Übersichtsreferenzthema.

   // Creates a Hashtable object with one entry for each unique
   // subitem value (or initial letter for the parent item)
   // in the specified column.
private:
   Hashtable^ CreateGroupsTable(int column)
   {
      // Create a Hashtable object.
      Hashtable^ groups = gcnew Hashtable();

      // Iterate through the items in myListView.
      IEnumerator^ myEnum1 = myListView->Items->GetEnumerator();
      while (myEnum1->MoveNext())
      {
         ListViewItem^ item = safe_cast<ListViewItem^>(myEnum1->Current);
         // Retrieve the text value for the column.
         String^ subItemText = item->SubItems[column]->Text;

         // Use the initial letter instead if it is the first column.
         if (column == 0) 
         {
            subItemText = subItemText->Substring(0, 1);
         }

         // If the groups table does not already contain a group
         // for the subItemText value, add a new group using the 
         // subItemText value for the group header and Hashtable key.
         if (!groups->Contains(subItemText))
         {
            groups->Add( subItemText, gcnew ListViewGroup(subItemText, 
               HorizontalAlignment::Left) );
         }
      }

      // Return the Hashtable object.
      return groups;
   }

// Creates a Hashtable object with one entry for each unique
// subitem value (or initial letter for the parent item)
// in the specified column.
private Hashtable CreateGroupsTable(int column)
{
    // Create a Hashtable object.
    Hashtable groups = new Hashtable();

    // Iterate through the items in myListView.
    foreach (ListViewItem item in myListView.Items)
    {
        // Retrieve the text value for the column.
        string subItemText = item.SubItems[column].Text;

        // Use the initial letter instead if it is the first column.
        if (column == 0) 
        {
            subItemText = subItemText.Substring(0, 1);
        }

        // If the groups table does not already contain a group
        // for the subItemText value, add a new group using the 
        // subItemText value for the group header and Hashtable key.
        if (!groups.Contains(subItemText))
        {
            groups.Add( subItemText, new ListViewGroup(subItemText, 
                HorizontalAlignment.Left) );
        }
    }

    // Return the Hashtable object.
    return groups;
}

' Creates a Hashtable object with one entry for each unique
' subitem value (or initial letter for the parent item)
' in the specified column.
Private Function CreateGroupsTable(column As Integer) As Hashtable
    ' Create a Hashtable object.
    Dim groups As New Hashtable()
    
    ' Iterate through the items in myListView.
    Dim item As ListViewItem
    For Each item In myListView.Items
        ' Retrieve the text value for the column.
        Dim subItemText As String = item.SubItems(column).Text
        
        ' Use the initial letter instead if it is the first column.
        If column = 0 Then
            subItemText = subItemText.Substring(0, 1)
        End If 

        ' If the groups table does not already contain a group
        ' for the subItemText value, add a new group using the 
        ' subItemText value for the group header and Hashtable key.
        If Not groups.Contains(subItemText) Then
            groups.Add( subItemText, New ListViewGroup(subItemText, _
                HorizontalAlignment.Left) )
        End If
    Next item
    
    ' Return the Hashtable object.
    Return groups
End Function 'CreateGroupsTable