DrawListViewItemEventArgs.State Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Obtient l'état actuel de ListViewItem à dessiner.

public:
 property System::Windows::Forms::ListViewItemStates State { System::Windows::Forms::ListViewItemStates get(); };

public System.Windows.Forms.ListViewItemStates State { get; }

member this.State : System.Windows.Forms.ListViewItemStates

Public ReadOnly Property State As ListViewItemStates

Valeur de propriété

ListViewItemStates

Combinaison d'opérations de bits des valeurs ListViewItemStates indiquant l'état actuel de ListViewItem.

Exemples

L’exemple de code suivant montre comment utiliser la State propriété dans une application qui fournit un dessin personnalisé pour un ListView contrôle. Dans l’exemple, un gestionnaire pour l’événement dessine l’arrière-plan ListView.DrawItem des éléments entiers. Dans toutes les vues, à l’exception de la vue détails, ce gestionnaire dessine également le texte de premier plan. Dans la vue des détails, le texte de premier plan est dessiné dans l’événement ListView.DrawSubItem .

Pour obtenir l’exemple complet, consultez la rubrique de référence de vue d’ensemble DrawListViewItemEventArgs .

// 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

Utilisez cette propriété pour case activée si le ListViewItem à dessiner est dans un état particulier. Cette propriété fournit uniquement des informations d’état de base sur l’élément. Vous pouvez utiliser cette propriété, par exemple, pour déterminer si un élément est sélectionné, vérifié ou prioritaire. Si vous avez besoin d’en savoir plus, récupérez l’élément via la Item propriété et case activée ses propriétés directement.

S’applique à

Partager via