ListViewGroup Constructeurs

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Initialise une nouvelle instance de la classe ListViewGroup.

Surcharges

ListViewGroup()

Initialise une nouvelle instance de la classe ListViewGroup à l'aide du texte d'en-tête par défaut de "ListViewGroup" et de l'alignement d'en-tête gauche par défaut.
ListViewGroup(String)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide de la valeur spécifiée pour initialiser la propriété Header et à l'aide de l'alignement d'en-tête gauche par défaut.
ListViewGroup(String, String)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide des valeurs spécifiées pour initialiser les propriétés Name et Header.
ListViewGroup(String, HorizontalAlignment)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide du texte d'en-tête et de l'alignement d'en-tête gauche spécifiés.

ListViewGroup()

Initialise une nouvelle instance de la classe ListViewGroup à l'aide du texte d'en-tête par défaut de "ListViewGroup" et de l'alignement d'en-tête gauche par défaut.

public:
 ListViewGroup();
public ListViewGroup ();
Public Sub New ()

S’applique à

ListViewGroup(String)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide de la valeur spécifiée pour initialiser la propriété Header et à l'aide de l'alignement d'en-tête gauche par défaut.

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)

Paramètres

header
String

Texte à afficher pour l'en-tête de groupe.

S’applique à

ListViewGroup(String, String)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide des valeurs spécifiées pour initialiser les propriétés Name et 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)

Paramètres

key
String

Valeur initiale de la propriété Name.

headerText
String

Valeur initiale de la propriété Header.

S’applique à

ListViewGroup(String, HorizontalAlignment)

Initialise une nouvelle instance de la classe ListViewGroup à l'aide du texte d'en-tête et de l'alignement d'en-tête gauche spécifiés.

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)

Paramètres

header
String

Texte à afficher pour l'en-tête de groupe.

headerAlignment
HorizontalAlignment

Une des valeurs de HorizontalAlignment qui spécifie l'alignement du texte d'en-tête.

Exemples

L’exemple de code suivant montre comment le ListViewGroup constructeur peut être utilisé dans une application qui organise les ListView éléments par valeur sous-élément dans la vue détails. Cette forme de regroupement est similaire au regroupement utilisé dans l’Explorateur Windows. Dans l’exemple, les groupes sont créés dynamiquement. Pour chaque colonne sous-élément, un groupe est créé pour chaque valeur sous-élément unique. Pour la colonne d’élément parent, un groupe est créé pour chaque lettre initiale unique. Les groupes créés pour chaque colonne sont stockés dans une table de hachage, ainsi que le texte sous-élément ou la lettre initiale. Lorsqu’un en-tête de colonne est cliqué, cette valeur de texte est utilisée pour faire correspondre les éléments aux groupes pour la colonne appropriée.

Pour obtenir l’exemple complet, consultez la ListViewGroup rubrique de référence de vue d’ensemble.

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

S’applique à