ListViewGroup Konstruktory

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Inicjuje nowe wystąpienie klasy ListViewGroup.

Przeciążenia

ListViewGroup()	Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu domyślnego tekstu nagłówka "ListViewGroup" i domyślnego wyrównania nagłówka po lewej stronie.
ListViewGroup(String)	Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonej wartości w celu zainicjowania Header właściwości i przy użyciu domyślnego wyrównania nagłówka po lewej stronie.
ListViewGroup(String, String)	Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonych wartości w celu zainicjowania Name właściwości i Header .
ListViewGroup(String, HorizontalAlignment)	Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonego tekstu nagłówka i wyrównania określonego nagłówka.

ListViewGroup()

Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu domyślnego tekstu nagłówka "ListViewGroup" i domyślnego wyrównania nagłówka po lewej stronie.

public:
 ListViewGroup();

public ListViewGroup ();

Public Sub New ()

ListViewGroup(String)

Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonej wartości w celu zainicjowania Header właściwości i przy użyciu domyślnego wyrównania nagłówka po lewej stronie.

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)

Parametry

header

String

Tekst do wyświetlenia dla nagłówka grupy.

ListViewGroup(String, String)

Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonych wartości w celu zainicjowania Name właściwości i Header .

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)

Parametry

key

String

Początkowa Name wartość właściwości.

headerText

String

Początkowa Header wartość właściwości.

ListViewGroup(String, HorizontalAlignment)

Inicjuje nowe wystąpienie ListViewGroup klasy przy użyciu określonego tekstu nagłówka i wyrównania określonego nagłówka.

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)

Parametry

header

String

Tekst do wyświetlenia dla nagłówka grupy.

headerAlignment

HorizontalAlignment

HorizontalAlignment Jedna z wartości określających wyrównanie tekstu nagłówka.

Przykłady

W poniższym przykładzie kodu pokazano, jak ListViewGroup konstruktor może być używany w aplikacji, która organizuje ListView elementy według wartości subitem w widoku szczegółów. Ta forma grupowania jest podobna do grupowania używanego w eksploratorze Windows. W tym przykładzie grupy są tworzone dynamicznie. Dla każdej kolumny subitem jedna grupa jest tworzona dla każdej unikatowej wartości subitem. Dla kolumny elementu nadrzędnego jedna grupa jest tworzona dla każdej unikatowej litery początkowej. Grupy utworzone dla każdej kolumny są przechowywane w tabeli skrótów wraz z tekstem subitem lub początkową literą. Po kliknięciu nagłówka kolumny ta wartość tekstowa jest używana do dopasowywania elementów do grup dla odpowiedniej kolumny.

Pełny przykład można znaleźć w temacie referencyjnym ListViewGroup przeglądu.

   // 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