ListViewItemStates (Enumeración)
Actualización: noviembre 2007
Define constantes que representan los posibles estados de ListViewItem.
Esta enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de los valores de miembro.
Espacio de nombres: System.Windows.FormsEnsamblado: System.Windows.Forms (en System.Windows.Forms.dll)
| Nombre de miembro | Descripción | |
|---|---|---|
| Checked | El elemento está activado. | |
| Default | El elemento está en su estado predeterminado. | |
| Focused | El elemento tiene foco. | |
| Grayed | El elemento está desactivado. | |
| Hot | El elemento está actualmente bajo el puntero del mouse. | |
| Indeterminate | El elemento está en un estado indeterminado. | |
| Marked | El elemento está marcado. | |
| Selected | El elemento está seleccionado. | |
| ShowKeyboardCues | El elemento debe indicar un método abreviado de teclado. |
Las propiedades DrawListViewItemEventArgs.State y DrawListViewSubItemEventArgs.ItemState utilizan esta enumeración. Para obtener más información, vea los eventos ListView.DrawItem y ListView.DrawSubItem.
El siguiente ejemplo muestra cómo proporcionar dibujos personalizados a un control ListView. En el ejemplo, el control ListView tiene un fondo degradado. Los subelementos con valores negativos tienen un primer plano de color rojo y un fondo de color negro.
Un controlador del evento ListView.DrawItem dibuja el fondo de todos los elementos y de la fila de los encabezados de la columna. Un controlador del evento ListView.DrawSubItem dibuja los valores de texto así como el texto y el fondo de los subelementos con valores negativos.
Un componente ContextMenu proporciona una manera de cambiar entre la vista de detalles y la vista de lista. En la vista de lista, sólo se desencadena el evento ListView.DrawItem. En este caso, el texto y el fondo se dibujan ambos en el controlador de eventos ListView.DrawItem.
Para obtener el ejemplo completo, vea el tema referente a ListView.OwnerDraw.
// Draws the backgrounds for entire ListView items. private void listView1_DrawItem(object sender, DrawListViewItemEventArgs e) { if ((e.State & ListViewItemStates.Selected) != 0) { // Draw the background and focus rectangle for a selected item. e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds); e.DrawFocusRectangle(); } else { // Draw the background for an unselected item. using (LinearGradientBrush brush = new LinearGradientBrush(e.Bounds, Color.Orange, Color.Maroon, LinearGradientMode.Horizontal)) { e.Graphics.FillRectangle(brush, e.Bounds); } } // Draw the item text for views other than the Details view. if (listView1.View != View.Details) { e.DrawText(); } }
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.