DrawListViewItemEventArgs.Item Eigenschaft

Definition

Ruft das zu zeichnende ListViewItem ab.Gets the ListViewItem to draw.

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.ListViewItem
Public ReadOnly Property Item As ListViewItem

Eigenschaftswert

ListViewItem

Das zu zeichnende ListViewItem.The ListViewItem to draw.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die- Item Eigenschaft in einer Anwendung verwendet wird, die benutzerdefinierte Zeichnungen für ein-Steuerelement bereitstellt ListView .The following code example demonstrates how to use the Item property in an application that provides custom drawing for a ListView control. Im Beispiel zeichnet ein Handler für das- ListView.DrawItem Ereignis den Hintergrund für ganze Elemente.In the example, a handler for the ListView.DrawItem event draws the background for entire items. In allen Sichten außer der Detailansicht zeichnet dieser Handler auch den Vordergrund Text.In all views except the details view, this handler also draws the foreground text. In der Detailansicht wird der Vorder Grundtext im- ListView.DrawSubItem Ereignis gezeichnet.In the details view, the foreground text is drawn in the ListView.DrawSubItem event.

Das komplette Beispiel finden Sie im DrawListViewItemEventArgs Übersichts Referenz Thema.For the complete example, see the DrawListViewItemEventArgs overview reference topic.

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

Hinweise

Verwenden Sie diese Eigenschaft, um ListViewItem auf zu zeichnen.Use this property to access the ListViewItem to draw. Dies ist nützlich, wenn die- State Eigenschaft keine ausreichenden Informationen bereitstellt, um Ihre Anforderungen zu erfüllen.This is useful when the State property does not provide adequate information to meet your needs. Die- State Eigenschaft enthält nur grundlegende Zustandsinformationen, die Sie verwenden können, um beispielsweise zu bestimmen, ob ein Element ausgewählt, aktiviert oder fokussiert ist.The State property provides only basic state information that you can use, for example, to determine whether an item is selected, checked, or focused. Mit der- Item Eigenschaft können Sie hingegen auf alle Member von zugreifen ListViewItem .The Item property, on the other hand, allows you to access all members of the ListViewItem. Sie müssen z. b. direkt auf das Element zugreifen, um den Wert selbst zu zeichnen, ListViewItem.Text anstatt die-Methode zu verwenden DrawText .You must access the item directly, for example, to draw the ListViewItem.Text value yourself rather than using the DrawText method.

Gilt für:

Siehe auch