DrawListViewItemEventArgs.Item Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das zu zeichnende ListViewItem ab.

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.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Item -Eigenschaft in einer Anwendung verwendet wird, die benutzerdefinierte Zeichnung für ein ListView Steuerelement bereitstellt. Im Beispiel zeichnet ein Handler für das ListView.DrawItem Ereignis den Hintergrund für ganze Elemente. In allen Ansichten mit Ausnahme der Detailansicht zeichnet dieser Handler auch den Vordergrundtext. In der Detailansicht wird der Vordergrundtext im ListView.DrawSubItem -Ereignis gezeichnet.

Das vollständige Beispiel finden Sie im DrawListViewItemEventArgs Übersichtsreferenzthema.

// 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 auf die ListViewItem zu zeichnende zu zugreifen. Dies ist nützlich, wenn die State Eigenschaft keine ausreichenden Informationen bereitstellt, um Ihre Anforderungen zu erfüllen. Die State -Eigenschaft stellt nur grundlegende Zustandsinformationen bereit, die Sie beispielsweise verwenden können, um zu bestimmen, ob ein Element ausgewählt, überprüft oder fokussiert ist. Mit Item der -Eigenschaft hingegen können Sie auf alle Member von ListViewItemzugreifen. Sie müssen direkt auf das Element zugreifen, z. B. um den ListViewItem.Text Wert selbst zu zeichnen, anstatt die DrawText -Methode zu verwenden.

Weitere Informationen

• DrawText
• ItemIndex
• ListView
• DrawItem
• ListViewItem
• Text
• State