DrawListViewItemEventArgs.Item Propriété
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.
Obtient le ListViewItem dessin.
public:
property System::Windows::Forms::ListViewItem ^ Item { System::Windows::Forms::ListViewItem ^ get(); };public System.Windows.Forms.ListViewItem Item { get; }member this.Item : System.Windows.Forms.ListViewItemPublic ReadOnly Property Item As ListViewItemValeur de propriété
À ListViewItem dessiner.
Exemples
L’exemple de code suivant montre comment utiliser la Item propriété dans une application qui fournit un dessin personnalisé pour un ListView contrôle. Dans l’exemple, un gestionnaire pour l’événement ListView.DrawItem dessine l’arrière-plan pour les é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 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 accéder ListViewItem au dessin. Cela est utile lorsque la State propriété ne fournit pas d’informations adéquates pour répondre à vos besoins. La State propriété fournit uniquement des informations d’état de base que vous pouvez utiliser, par exemple, pour déterminer si un élément est sélectionné, activé ou concentré. La Item propriété, en revanche, vous permet d’accéder à tous les membres du ListViewItem. Vous devez accéder directement à l’élément pour dessiner la ListViewItem.Text valeur vous-même au lieu d’utiliser la DrawText méthode.
