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