Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad ListViewItem.Group

 

Publicado: octubre de 2016

Obtiene o establece el grupo al que se asigna el elemento.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public ListViewGroup Group { get; set; }

Valor de propiedad

Type: System.Windows.Forms.ListViewGroup

El ListViewGroup que tiene asignado el elemento.

Utilice esta propiedad para establecer el grupo al que pertenece un elemento. También puede establecer el grupo en el ListViewItem constructor, o se puede utilizar esta propiedad para modificar la pertenencia al grupo en tiempo de ejecución. Si establece esta propiedad en null y hay grupos en el ListView.Groups colección, el elemento aparecerá en el grupo predeterminado, que tiene la etiqueta de encabezado "DefaultGroupSystem.Windows.Forms". El grupo predeterminado no está contenido en el ListView.Groups colección y no se puede modificar. Es especialmente útil en la depuración para asegurarse de que todos los elementos se han agregado correctamente a los grupos.

System_CAPS_noteNota

ListView grupos sólo están disponibles en Windows XP y la familia Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obtener más información, consulte el ListViewGroup tema de información general.

En el ejemplo de código siguiente se muestra cómo el Group propiedad se puede utilizar en una aplicación que organiza ListView elementos por valor de subelemento en la vista de detalles. Esta forma de agrupación es similar a la agrupación utilizada en el Explorador de Windows. En el ejemplo, los grupos se crean dinámicamente. Para cada columna de subelementos, se crea un grupo para cada valor de subelemento único. En la columna del 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, se recupera la tabla hash que corresponde a esa columna. A continuación, los valores de texto de subelemento para esa columna se utilizan como claves de tabla hash para recuperar el grupo correcto para cada elemento. El elemento se le asigna el grupo mediante el Group propiedad.

Este ejemplo de código forma parte de un ejemplo mayor proporcionado para el ListView.Groups propiedad.

// Sets myListView to the groups created for the specified column.
private void SetGroups(int column)
{
    // Remove the current groups.
    myListView.Groups.Clear();

    // Retrieve the hash table corresponding to the column.
    Hashtable groups = (Hashtable)groupTables[column];

    // Copy the groups for the column to an array.
    ListViewGroup[] groupsArray = new ListViewGroup[groups.Count];
    groups.Values.CopyTo(groupsArray, 0);

    // Sort the groups and add them to myListView.
    Array.Sort(groupsArray, new ListViewGroupSorter(myListView.Sorting));
    myListView.Groups.AddRange(groupsArray);

    // Iterate through the items in myListView, assigning each 
    // one to the appropriate group.
    foreach (ListViewItem item in myListView.Items)
    {
        // Retrieve the subitem text corresponding to the column.
        string subItemText = item.SubItems[column].Text;

        // For the Title column, use only the first letter.
        if (column == 0) 
        {
            subItemText = subItemText.Substring(0, 1);
        }

        // Assign the item to the matching group.
        item.Group = (ListViewGroup)groups[subItemText];
    }
}

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: