ListViewItem Clase
TOC
Collapse the table of content
Expand the table of content
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

ListViewItem (Clase)

 

Representa un elemento de un control ListView.

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

System.Object
  System.Windows.Forms.ListViewItem

[SerializableAttribute]
[TypeConverterAttribute(typeof(ListViewItemConverter))]
public class ListViewItem : ICloneable, ISerializable

NombreDescripción
System_CAPS_pubmethodListViewItem()

Inicializa una nueva instancia de la clase ListViewItem con valores predeterminados.

System_CAPS_pubmethodListViewItem(ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem y la asigna al grupo especificado.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], Int32)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de objetos ListViewItem.ListViewSubItem.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], Int32, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de objetos ListViewItem.ListViewSubItem y asigna el elemento al grupo especificado.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], String)

Inicializa una nueva instancia de la clase ListViewItem con la imagen y los subelementos especificados.

System_CAPS_pubmethodListViewItem(ListViewItem.ListViewSubItem[], String, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con la imagen, el grupo y los subelementos especificados.

System_CAPS_protmethodListViewItem(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase ListViewItem con la información de serialización y el contexto de secuencia especificados.

System_CAPS_pubmethodListViewItem(String)

Inicializa una nueva instancia de la clase ListViewItem con el texto especificado.

System_CAPS_pubmethodListViewItem(String, Int32)

Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la posición de índice de la imagen del icono del elemento.

System_CAPS_pubmethodListViewItem(String, Int32, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la posición de índice de la imagen del icono del elemento, y asigna el elemento al grupo especificado.

System_CAPS_pubmethodListViewItem(String, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con el texto del elemento especificado y la asigna al grupo especificado.

System_CAPS_pubmethodListViewItem(String, String)

Inicializa una nueva instancia de la clase ListViewItem con la imagen y el texto especificados.

System_CAPS_pubmethodListViewItem(String, String, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con la imagen, el grupo y los subelementos especificados.

System_CAPS_pubmethodListViewItem(String[])

Inicializa una nueva instancia de la clase ListViewItem con una matriz de cadenas que representan subelementos.

System_CAPS_pubmethodListViewItem(String[], Int32)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de cadenas que representan los subelementos.

System_CAPS_pubmethodListViewItem(String[], Int32, Color, Color, Font)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento, el color de primer plano, el color de fondo y la fuente del elemento; y una matriz de cadenas que representan los subelementos.

System_CAPS_pubmethodListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento, el color de primer plano, el color de fondo y la fuente del elemento; y una matriz de cadenas que representan los subelementos.Asigna el elemento al grupo especificado.

System_CAPS_pubmethodListViewItem(String[], Int32, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con la posición de índice de la imagen del icono del elemento y una matriz de cadenas que representan los subelementos, y asigna el elemento al grupo especificado.

System_CAPS_pubmethodListViewItem(String[], ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con una matriz de cadenas que representan los subelementos y asigna el elemento al grupo especificado.

System_CAPS_pubmethodListViewItem(String[], String)

Inicializa una nueva instancia de la clase ListViewItem con el texto y la imagen del elemento y el subelemento especificados.

System_CAPS_pubmethodListViewItem(String[], String, Color, Color, Font)

Inicializa una nueva instancia de la clase ListViewItem con los subelementos que contienen el texto, imagen, colores y fuente especificados.

System_CAPS_pubmethodListViewItem(String[], String, Color, Color, Font, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con los subelementos que contienen el texto, imagen, colores, fuente y grupo especificados.

System_CAPS_pubmethodListViewItem(String[], String, ListViewGroup)

Inicializa una nueva instancia de la clase ListViewItem con subelementos que contienen el texto, la imagen y el grupo especificados.

NombreDescripción
System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo del texto del elemento.

System_CAPS_pubpropertyBounds

Obtiene el rectángulo delimitador del elemento, incluidos los subelementos.

System_CAPS_pubpropertyChecked

Obtiene o establece un valor que indica si el elemento está activado.

System_CAPS_pubpropertyFocused

Obtiene o establece un valor que indica si el elemento tiene el foco en el control ListView.

System_CAPS_pubpropertyFont

Obtiene o establece la fuente del texto que muestra el elemento.

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano del texto del elemento.

System_CAPS_pubpropertyGroup

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

System_CAPS_pubpropertyImageIndex

Obtiene o establece el índice de la imagen mostrada para el elemento.

System_CAPS_pubpropertyImageKey

Obtiene o establece la clave para la imagen mostrada para el elemento.

System_CAPS_pubpropertyImageList

Obtiene el ImageList que contiene la imagen mostrada con el elemento.

System_CAPS_pubpropertyIndentCount

Obtiene o establece el número de anchos de imagen pequeños por los que aplicar sangría a ListViewItem.

System_CAPS_pubpropertyIndex

Obtiene el índice de base cero del elemento del control ListView.

System_CAPS_pubpropertyListView

Obtiene el control ListView que contiene el elemento.

System_CAPS_pubpropertyName

Obtiene o establece el nombre asociado a este ListViewItem.

System_CAPS_pubpropertyPosition

Obtiene o establece la posición de la esquina superior izquierda de ListViewItem.

System_CAPS_pubpropertySelected

Obtiene o establece un valor que indica si el elemento está seleccionado.

System_CAPS_pubpropertyStateImageIndex

Obtiene o establece el índice de la imagen de estado (como la imagen de una casilla activada o desactivada que indica el estado del elemento) mostrada para el elemento.

System_CAPS_pubpropertySubItems

Obtiene una colección que contiene todos los subelementos del elemento.

System_CAPS_pubpropertyTag

Obtiene o establece un objeto que contiene datos asociados al elemento.

System_CAPS_pubpropertyText

Obtiene o establece el texto del elemento.

System_CAPS_pubpropertyToolTipText

Obtiene o establece el texto mostrado cuando el puntero del mouse descansa en ListViewItem.

System_CAPS_pubpropertyUseItemStyleForSubItems

Obtiene o establece un valor que indica si las propiedades Font, ForeColor y BackColor del elemento se utilizan para todos los subelementos.

NombreDescripción
System_CAPS_pubmethodBeginEdit()

Pone el texto del elemento en modo de edición.

System_CAPS_pubmethodClone()

Crea una copia idéntica del elemento.

System_CAPS_protmethodDeserialize(SerializationInfo, StreamingContext)

Deserializa el elemento.

System_CAPS_pubmethodEnsureVisible()

Garantiza que el elemento esté visible en el control, desplazando el contenido del control si es necesario.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object.)

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodFindNearestItem(SearchDirectionHint)

Encuentra el siguiente elemento a partir de ListViewItem, buscando en la dirección especificada.

System_CAPS_pubmethodGetBounds(ItemBoundsPortion)

Recupera la parte especificada del rectángulo delimitador del elemento.

System_CAPS_pubmethodGetHashCode()

Sirve como una función hash para un tipo en particular. (Heredado de Object.)

System_CAPS_pubmethodGetSubItemAt(Int32, Int32)

Devuelve el subelemento de ListViewItem en las coordenadas especificadas.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual. (Heredado de Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual. (Heredado de Object.)

System_CAPS_pubmethodRemove()

Quita el elemento de su control ListView asociado.

System_CAPS_protmethodSerialize(SerializationInfo, StreamingContext)

Serializa el elemento.

System_CAPS_pubmethodToString()

(Reemplaza a Object.ToString()).

El control ListView es similar a un ListBox en que muestra una lista de elementos.La diferencia principal es que el control ListView proporciona al usuario varias formas distintas de ver los elementos.La clase ListViewItem define el aspecto, comportamiento y datos asociados a un elemento que se muestra en el control ListView.Los objetos ListViewItem se pueden mostrar en el control ListView en una de cuatro las vistas diferentes.Los elementos se pueden mostrar como iconos grandes o pequeños, o bien como iconos pequeños en una lista vertical.Los elementos también pueden tener subelementos que contengan información relacionada con el elemento primario.El cuarto estilo de vista, vista de detalles, permite mostrar el elemento y sus subelementos en una cuadrícula con encabezados de columna que identifican la información de un subelemento.

La mayoría de las propiedades de la clase ListViewItem ofrecen formas para cambiar la presentación del elemento en el control ListView al que está asociado.Las propiedades BackColor, ForeColor y Font permiten cambiar la presentación del texto del elemento en el control ListView.La propiedad ImageIndex permite especificar la imagen que se va a cargar desde el ImageList asignado al control ListView (estableciendo las propiedades LargeImageList o SmallImageList del ListView).Los elementos pueden mostrar casillas para que el usuario pueda especificar opciones de elemento, de forma parecida a un control CheckedListBox.La propiedad Checked se puede utilizar para determinar si un elemento está activado, o bien para activar o desactivar la casilla en tiempo de ejecución.Los elementos pueden mostrar cualquier número de subelementos cuando la propiedad View del control ListView asociado está establecida en Details y las columnas están definidas en el ListView.ColumnHeaderCollection del control ListView.Se pueden agregar subelementos a un elemento llamando al método Add de la clase ListViewItem.ListViewSubItemCollection.La propiedad SubItems permite obtener acceso a la clase ListViewItem.ListViewSubItemCollection y a sus miembros.

Algunas de las propiedades y métodos de la clase ListViewItem son versiones específicas de elemento de las propiedades y métodos del control ListView.Por ejemplo, el método EnsureVisible es similar a la versión ListView del método, pero la versión ListViewItem sólo afecta al elemento actual.

La clase ListViewItem también proporciona métodos que no son versiones de los métodos ListView.El método BeginEdit pone el texto del elemento en modo de edición para que el usuario pueda cambiarlo (cuando la propiedad LabelEdit del control ListView está establecida en true).El método Clone permite la creación de copias de objetos ListViewItem existentes para volver a utilizarlos en otros controles ListView.

En el ejemplo de código siguiente se crea un control ListView con tres objetos ListViewItem y tres objetos ListViewItem.ListViewSubItem especificados para cada elemento.Asimismo se crean objetos ColumnHeader para mostrar los subelementos en la vista de detalles.En el ejemplo de código también se crean dos objetos ImageList para proporcionar imágenes a los objetos ListViewItem.Estos objetos ImageList se agregan a las propiedades LargeImageList y SmallImageList.Para crear el control ListView, en el ejemplo se utilizan las siguientes propiedades:

Se necesita agregar el código a un Form y que se llame al método creado en el ejemplo desde el constructor u otro método del formulario.En el ejemplo se requiere que las imágenes denominadas MySmallImage1, MySmallImage2, MyLargeImage1 y MyLargeImage2 se encuentren en el directorio raíz de la unidad C.

private void CreateMyListView()
{
	// Create a new ListView control.
	ListView listView1 = new ListView();
	listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

	// Set the view to show details.
	listView1.View = View.Details;
	// Allow the user to edit item text.
	listView1.LabelEdit = true;
	// Allow the user to rearrange columns.
	listView1.AllowColumnReorder = true;
	// Display check boxes.
	listView1.CheckBoxes = true;
	// Select the item and subitems when selection is made.
	listView1.FullRowSelect = true;
	// Display grid lines.
	listView1.GridLines = true;
	// Sort the items in the list in ascending order.
	listView1.Sorting = SortOrder.Ascending;

	// Create three items and three sets of subitems for each item.
	ListViewItem item1 = new ListViewItem("item1",0);
	// Place a check mark next to the item.
	item1.Checked = true;
	item1.SubItems.Add("1");
	item1.SubItems.Add("2");
	item1.SubItems.Add("3");
	ListViewItem item2 = new ListViewItem("item2",1);
	item2.SubItems.Add("4");
	item2.SubItems.Add("5");
	item2.SubItems.Add("6");
	ListViewItem item3 = new ListViewItem("item3",0);
	// Place a check mark next to the item.
	item3.Checked = true;
	item3.SubItems.Add("7");
	item3.SubItems.Add("8");
	item3.SubItems.Add("9");

	// Create columns for the items and subitems.
	// Width of -2 indicates auto-size.
	listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
	listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

	//Add the items to the ListView.
          		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

	// Create two ImageList objects.
	ImageList imageListSmall = new ImageList();
	ImageList imageListLarge = new ImageList();

	// Initialize the ImageList objects with bitmaps.
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
	imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
	imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

	//Assign the ImageList objects to the ListView.
	listView1.LargeImageList = imageListLarge;
	listView1.SmallImageList = imageListSmall;

	// Add the ListView to the control collection.
	this.Controls.Add(listView1);
}

.NET Framework
Disponible desde 1.1

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft