ListViewItemStates Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit des constantes qui représentent les états possibles d’une ListViewItem.
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
public enum class ListViewItemStates
[System.Flags]
public enum ListViewItemStates
[<System.Flags>]
type ListViewItemStates =
Public Enum ListViewItemStates
- Héritage
- Attributs
Champs
| Nom | Valeur | Description |
|---|---|---|
| Selected | 1 | L’élément est sélectionné. |
| Grayed | 2 | L’élément est désactivé. |
| Checked | 8 | L’élément est activé. |
| Focused | 16 | L’élément a le focus. |
| Default | 32 | L’élément est dans son état par défaut. |
| Hot | 64 | L’élément se trouve actuellement sous le pointeur de la souris. |
| Marked | 128 | L’élément est marqué. |
| Indeterminate | 256 | L’élément est dans un état indéterminé. |
| ShowKeyboardCues | 512 | L’élément doit indiquer un raccourci clavier. |
Exemples
L’exemple suivant montre comment fournir un dessin personnalisé pour un ListView contrôle. Le ListView contrôle de l’exemple a un arrière-plan dégradé. Les sous-éléments avec des valeurs négatives ont un premier plan rouge et un arrière-plan noir.
Un gestionnaire pour l’événement ListView.DrawItem dessine l’arrière-plan pour les éléments entiers et pour la ligne d’en-têtes de colonne. Un gestionnaire pour l’événement ListView.DrawSubItem dessine les valeurs de texte et le texte et l’arrière-plan pour les sous-éléments qui ont des valeurs négatives.
Un ContextMenu composant permet de basculer entre l’affichage détails et la liste. Dans l’affichage liste, seul l’événement ListView.DrawItem est déclenché. Dans ce cas, le texte et l’arrière-plan sont tous deux dessinés dans le ListView.DrawItem gestionnaire d’événements.
Pour obtenir l’exemple complet, consultez la ListView.OwnerDraw rubrique de référence.
// 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();
}
}
' Draws the backgrounds for entire ListView items.
Private Sub listView1_DrawItem(ByVal sender As Object, _
ByVal e As DrawListViewItemEventArgs) _
Handles listView1.DrawItem
If Not (e.State And ListViewItemStates.Selected) = 0 Then
' Draw the background for a selected item.
e.Graphics.FillRectangle(Brushes.Maroon, e.Bounds)
e.DrawFocusRectangle()
Else
' Draw the background for an unselected item.
Dim brush As New LinearGradientBrush(e.Bounds, Color.Orange, _
Color.Maroon, LinearGradientMode.Horizontal)
Try
e.Graphics.FillRectangle(brush, e.Bounds)
Finally
brush.Dispose()
End Try
End If
' Draw the item text for views other than the Details view.
If Not Me.listView1.View = View.Details Then
e.DrawText()
End If
End Sub
Remarques
Cette énumération est utilisée par les propriétés et DrawListViewSubItemEventArgs.ItemState les DrawListViewItemEventArgs.State propriétés. Pour plus d’informations, consultez les événements et ListView.DrawSubItem les ListView.DrawItem événements.