ListViewGroup Constructores

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase ListViewGroup.

Sobrecargas

Nombre	Description
ListViewGroup()	Inicializa una nueva instancia de la ListViewGroup clase con el texto de encabezado predeterminado de "ListViewGroup" y la alineación predeterminada del encabezado izquierdo.
ListViewGroup(String)	Inicializa una nueva instancia de la ListViewGroup clase utilizando el valor especificado para inicializar la Header propiedad y usar la alineación predeterminada del encabezado izquierdo.
ListViewGroup(String, String)	Inicializa una nueva instancia de la ListViewGroup clase utilizando los valores especificados para inicializar las Name propiedades y Header .
ListViewGroup(String, HorizontalAlignment)	Inicializa una nueva instancia de la ListViewGroup clase utilizando el texto de encabezado especificado y la alineación de encabezado especificada.

ListViewGroup()

Inicializa una nueva instancia de la ListViewGroup clase con el texto de encabezado predeterminado de "ListViewGroup" y la alineación predeterminada del encabezado izquierdo.

public:
 ListViewGroup();

public ListViewGroup();

Public Sub New ()

Se aplica a

ListViewGroup(String)

Inicializa una nueva instancia de la ListViewGroup clase utilizando el valor especificado para inicializar la Header propiedad y usar la alineación predeterminada del encabezado izquierdo.

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

public ListViewGroup(string header);

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

Public Sub New (header As String)

Parámetros

header: String

Texto que se va a mostrar para el encabezado del grupo.

Se aplica a

ListViewGroup(String, String)

Inicializa una nueva instancia de la ListViewGroup clase utilizando los valores especificados para inicializar las Name propiedades y Header .

public:
 ListViewGroup(System::String ^ key, System::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)

Parámetros

key: String

Valor inicial de la Name propiedad.

headerText: String

Valor inicial de la Header propiedad.

Se aplica a

ListViewGroup(String, HorizontalAlignment)

Inicializa una nueva instancia de la ListViewGroup clase utilizando el texto de encabezado especificado y la alineación de encabezado especificada.

public:
 ListViewGroup(System::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)

Parámetros

header: String

Texto que se va a mostrar para el encabezado del grupo.

headerAlignment: HorizontalAlignment

Uno de los HorizontalAlignment valores que especifica la alineación del texto del encabezado.

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede usar el ListViewGroup constructor en una aplicación que organiza ListView los elementos por valor de subelemento en la vista de detalles. Esta forma de agrupación es similar a la agrupación usada en el Explorador de Windows. En el ejemplo, los grupos se crean dinámicamente. Para cada columna de subelemento, se crea un grupo para cada valor de subelemento único. Para la columna de elemento primario, se crea un grupo para cada letra inicial única. Los grupos creados para cada columna se almacenan en una tabla hash junto con el texto del subelemento o la letra inicial. Cuando se hace clic en un encabezado de columna, este valor de texto se usa para hacer coincidir elementos con grupos para la columna adecuada.

Para obtener el ejemplo completo, consulte el ListViewGroup tema de referencia de información general.

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

Se aplica a

Comentarios

¿Le ha resultado útil esta página?