ListViewGroup Конструкторы

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Инициализирует новый экземпляр класса ListViewGroup.

Перегрузки

ListViewGroup()	Инициализирует новый экземпляр класса ListViewGroup, используя текст заголовка по умолчанию "ListViewGroup" и установленное по умолчанию выравнивание заголовка влево.
ListViewGroup(String)	Инициализирует новый экземпляр класса ListViewGroup, используя указанное значение для инициализации свойства Header и используя установленное по умолчанию выравнивание заголовка влево.
ListViewGroup(String, String)	Инициализирует новый экземпляр класса ListViewGroup, используя заданные значения для инициализации свойств Name и Header.
ListViewGroup(String, HorizontalAlignment)	Инициализирует новый экземпляр класса ListViewGroup, используя заданный текст заголовка и указанное выравнивание заголовка.

ListViewGroup()

Инициализирует новый экземпляр класса ListViewGroup, используя текст заголовка по умолчанию "ListViewGroup" и установленное по умолчанию выравнивание заголовка влево.

public:
 ListViewGroup();

public ListViewGroup ();

Public Sub New ()

ListViewGroup(String)

Инициализирует новый экземпляр класса ListViewGroup, используя указанное значение для инициализации свойства Header и используя установленное по умолчанию выравнивание заголовка влево.

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)

Параметры

header

String

Текст, отображаемый для заголовка группы.

ListViewGroup(String, String)

Инициализирует новый экземпляр класса ListViewGroup, используя заданные значения для инициализации свойств Name и 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)

Параметры

key

String

Начальное значение свойства Name.

headerText

String

Начальное значение свойства Header.

ListViewGroup(String, HorizontalAlignment)

Инициализирует новый экземпляр класса ListViewGroup, используя заданный текст заголовка и указанное выравнивание заголовка.

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)

Параметры

header

String

Текст, отображаемый для заголовка группы.

headerAlignment

HorizontalAlignment

Одно из значений HorizontalAlignment, задающее способ выравнивания текста заголовка.

Примеры

В следующем примере кода показано, как ListViewGroup конструктор может использоваться в приложении, которое упорядочивает ListView элементы по значению подэлемента в представлении сведений. Эта форма группировки аналогична группировке, используемой в обозревателе Windows. В этом примере группы создаются динамически. Для каждого столбца подэлемента создается одна группа для каждого уникального значения подэлемента. Для столбца родительского элемента создается одна группа для каждой уникальной исходной буквы. Группы, созданные для каждого столбца, хранятся в хэш-таблице вместе с текстом подэлемента или начальной буквой. При щелчке заголовка столбца это текстовое значение используется для сопоставления элементов с группами для соответствующего столбца.

Полный пример см. в справочном ListViewGroup разделе обзора.

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