Exportar (0) Imprimir
Expandir todo
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 en un control de ListView .

System.Object
  System.Windows.Forms.ListViewItem

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

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

El tipo ListViewItem expone los siguientes miembros.

  NombreDescripción
Método públicoListViewItem()Inicializa una nueva instancia de la clase de ListViewItem con valores predeterminados.
Método públicoListViewItem(ListViewGroup)Inicializa una nueva instancia de la clase y asignaciones de ListViewItem al grupo especificado.
Método públicoListViewItem(String)Inicializa una nueva instancia de la clase de ListViewItem con el texto del elemento especificado.
Método públicoListViewItem(String[])Inicializa una nueva instancia de la clase de ListViewItem con una matriz de cadenas que representan subelementos.
Método públicoListViewItem(ListViewItem.ListViewSubItem[], Int32)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de una matriz de elementos de icono y objetos de ListViewItem.ListViewSubItem .
Método públicoListViewItem(ListViewItem.ListViewSubItem[], String)Inicializa una nueva instancia de la clase de ListViewItem con los subelementos y la imagen especificados.
Método protegidoListViewItem(SerializationInfo, StreamingContext)Inicializa una nueva instancia de la clase de ListViewItem con la información de serialización y el contexto especificados con transmisión por secuencias.
Método públicoListViewItem(String, Int32)Inicializa una nueva instancia de la clase de ListViewItem con el texto del elemento especificado y la posición de índice de imagen de icono del elemento.
Método públicoListViewItem(String, String)Inicializa una nueva instancia de la clase de ListViewItem con el texto y la imagen especificados.
Método públicoListViewItem(String, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con el texto y las asignaciones de elemento especificado al grupo especificado.
Método públicoListViewItem(String[], Int32)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de una matriz de elementos icon y de cadenas que representan subelementos.
Método públicoListViewItem(String[], String)Inicializa una nueva instancia de la clase de ListViewItem con el elemento especificado y el texto y la imagen del subelemento.
Método públicoListViewItem(String[], ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con una matriz de cadenas que representan subelementos, y asigna el elemento al grupo especificado.
Método públicoListViewItem(ListViewItem.ListViewSubItem[], Int32, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de una matriz de elementos de icono y objetos de ListViewItem.ListViewSubItem , y asigna el elemento al grupo especificado.
Método públicoListViewItem(ListViewItem.ListViewSubItem[], String, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con los subelementos, la imagen, y el grupo especificados.
Método públicoListViewItem(String, Int32, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con el texto del elemento especificado y la posición de índice de imagen de icono de elemento, y asigna el elemento al grupo especificado.
Método públicoListViewItem(String, String, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con el texto, la imagen, y el grupo especificados.
Método públicoListViewItem(String[], Int32, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de una matriz de elementos icon y de cadenas que representan subelementos, y asigna el elemento al grupo especificado.
Método públicoListViewItem(String[], String, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con los subelementos que contienen texto, la imagen, y al grupo especificados.
Método públicoListViewItem(String[], Int32, Color, Color, Font)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de icono de elemento; el color de primer plano, el color de fondo, y la fuente del elemento; y una matriz de cadenas que representan subelementos.
Método públicoListViewItem(String[], String, Color, Color, Font)Inicializa una nueva instancia de la clase de ListViewItem con los subelementos que contienen texto, la imagen, los colores, y fuente especificados.
Método públicoListViewItem(String[], Int32, Color, Color, Font, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con la posición de índice de imagen de icono de elemento; el color de primer plano, el color de fondo, y la fuente del elemento; y una matriz de cadenas que representan subelementos. Asigna el elemento al grupo especificado.
Método públicoListViewItem(String[], String, Color, Color, Font, ListViewGroup)Inicializa una nueva instancia de la clase de ListViewItem con los subelementos que contienen texto, la imagen, los colores, fuentes, y al grupo especificados.
Arriba

  NombreDescripción
Propiedad públicaBackColorObtiene o establece el color de fondo del texto del elemento.
Propiedad públicaBoundsObtiene el rectángulo delimitador del elemento, incluidos subelementos.
Propiedad públicaCheckedObtiene o establece un valor que indica si el elemento está activado.
Propiedad públicaFocusedObtiene o establece un valor que indica si el elemento tiene el foco dentro del control de ListView .
Propiedad públicaFontObtiene o establece la fuente del texto mostrado por el elemento.
Propiedad públicaForeColorObtiene o establece el color de primer plano del texto del elemento.
Propiedad públicaGroupObtiene o establece el grupo al que está asignado el elemento.
Propiedad públicaImageIndexObtiene o establece el índice de la imagen que se muestra para el elemento.
Propiedad públicaImageKeyObtiene o establece la clave de la imagen que se muestra para el elemento.
Propiedad públicaImageListObtiene ImageList que contiene la imagen mostrada al elemento.
Propiedad públicaIndentCountObtiene o establece el número de pequeños anchos de imagen por los que aplicar sangría ListViewItem.
Propiedad públicaIndexObtiene el índice de base cero del elemento dentro del control de ListView .
Propiedad públicaListViewobtiene el control de ListView que contiene el elemento.
Propiedad públicaNameObtiene o establece el nombre asociado a este ListViewItem.
Propiedad públicaPositionobtiene o establece la posición de la esquina superior izquierda de ListViewItem.
Propiedad públicaSelectedObtiene o establece un valor que indica si el elemento está seleccionado.
Propiedad públicaStateImageIndexObtiene o establece el índice de la imagen de estado (una imagen como una casilla activada o desactivada que indica el estado del elemento) que se muestra para el elemento.
Propiedad públicaSubItemsObtiene una colección que contiene todos los subelementos del elemento.
Propiedad públicaTagObtiene o establece un objeto que contiene datos para asociar al elemento.
Propiedad públicaTextObtiene o establece el texto del elemento.
Propiedad públicaToolTipTextObtiene o establece el texto que se muestra cuando el puntero del mouse se encuentra sobre ListViewItem.
Propiedad públicaUseItemStyleForSubItemsObtiene o establece un valor que indica si Font, ForeColor, y las propiedades de BackColor para el elemento se utilizan para todos los subelementos.
Arriba

  NombreDescripción
Método públicoBeginEditColoca el texto del elemento en modo de edición.
Método públicoCloneCrea una copia idéntica del elemento.
Método protegidoDeserializedeserializa el elemento.
Método públicoEnsureVisibleGarantiza que el elemento sea visible dentro del control, moviendo el contenido del control, si es necesario.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindNearestItemEncuentra el elemento siguiente de ListViewItem, buscando en la dirección especificada.
Método públicoGetBoundsRecuperar la parte especificada del rectángulo delimitador para el elemento.
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetSubItemAtDevuelve el nombre de ListViewItem en las coordenadas especificadas.
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoRemovequita el elemento de su control asociado de ListView .
Método protegidoSerializeserializa el elemento.
Método públicoToString Retorna una cadena que representa al objeto actual. (Invalida a Object.ToString()).
Arriba

El control de ListView es similar a ListBox en que muestra una lista de elementos. La diferencia principal es que el control de ListView proporciona varias maneras que los elementos se pueden ver por el usuario. La clase de ListViewItem define el aspecto, el comportamiento, y los datos asociados a un elemento que se muestra en el control de ListView . los objetos deListViewItem se pueden mostrar en el control de ListView en cuatro vistas diferentes. Los elementos se pueden mostrar como iconos grandes o pequeños o como pequeñas iconos en una lista vertical. Los elementos también pueden tener subelementos que contienen la 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 se pueden utilizar para identificar la información que se muestra en un subelemento.

La mayoría de las propiedades de la clase de ListViewItem proporcionan maneras de cambiar la presentación del elemento en el control de ListView que está asociado. BackColor , ForeColor, y las propiedades de Font permiten cambiar el aspecto del texto del elemento se muestra en el control de ListView . La propiedad de ImageIndex permite especificar la imagen para la carga de ImageList asignado al control de ListView (estableciendo las propiedades de LargeImageList o de SmallImageList de ListView). Los elementos pueden mostrar las casillas para obtener las opciones del elemento del usuario de una manera similar a un control de CheckedListBox . Puede utilizar la propiedad de Checked para determinar si se comprueba un elemento, o para activar o desactivar la casilla en tiempo de ejecución. Los elementos pueden mostrar cualquier número de subelementos cuando la propiedad de View del control asociado de ListView se establece en Details y columnas se define en ListView.ColumnHeaderCollection de control de ListView . Puede agregar subelementos a un elemento llamando al método de Add de la clase de ListViewItem.ListViewSubItemCollection . La propiedad de SubItems permite acceda a la clase de ListViewItem.ListViewSubItemCollection y sus miembros.

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

La clase de ListViewItem también proporciona métodos que no son versiones de los métodos de ListView . El método de BeginEdit coloca el texto del elemento en modo de edición para que el usuario puede cambiar el texto del elemento (cuando la propiedad de LabelEdit de control de ListView se establece en true). El método de Clone permite crear copias de los objetos existentes de ListViewItem a la reutilización en otros controles de ListView .

el ejemplo de código siguiente crea un control de ListView con tres objetos de ListViewItem especificados y tres objetos de ListViewItem.ListViewSubItem especificados para cada elemento. El ejemplo también crea objetos de ColumnHeader para mostrar los subelementos en la vista detalles. Dos objetos de ImageList también se crean en el ejemplo de código para proporcionar las imágenes de los objetos de ListViewItem . estos objetos de ImageList se agregan a las propiedades de LargeImageList y de SmallImageList . El ejemplo utiliza las siguientes propiedades de la creación del control de ListView :

Deberá agregar código a Form y llamar al método creado en el ejemplo de constructor u otro método en el formulario. El ejemplo requiere que las imágenes hubiesen llamado MySmallImage1, MySmallImage2, MyLargeImage1, y MyLargeImage2 se encuentra 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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft