Freigeben über


DrawListViewItemEventArgs.DrawText Methode

Definition

Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und der Standardformatierung.

Überlädt

DrawText()

Zeichnet den Text der ListViewItem mit seiner aktuellen Vordergrundfarbe.

DrawText(TextFormatFlags)

Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und formatiert ihn mit den angegebenen TextFormatFlags-Werten.

DrawText()

Zeichnet den Text der ListViewItem mit seiner aktuellen Vordergrundfarbe.

public:
 void DrawText();
public void DrawText ();
member this.DrawText : unit -> unit
Public Sub DrawText ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DrawText -Methode 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 Methode, um den Elementtext mit den aktuellen Werten der ListViewItem.ForeColor Eigenschaften und ListViewItem.Font zu zeichnen. Der Text wird innerhalb des von der -Eigenschaft angegebenen Bereichs Bounds gezeichnet. Sie können den Text auch manuell zeichnen, indem Sie das Graphics über die Graphics -Eigenschaft abgerufene verwenden.

Die DrawText -Methode ist besonders nützlich, wenn die ListView.View -Eigenschaft auf einen anderen Wert als View.Detailsfestgelegt ist. In der Detailansicht zeichnet diese Methode den Text für , ListViewItemzeichnet jedoch nicht den Text für Unterelemente. Daher ist es in der Detailansicht im Allgemeinen bequemer, den ListView gesamten Text in einem Handler für das ListView.DrawSubItem Ereignis zu zeichnen.

Weitere Informationen

Gilt für:

DrawText(TextFormatFlags)

Zeichnet den Text des ListViewItem mit seiner aktuellen Vordergrundfarbe und formatiert ihn mit den angegebenen TextFormatFlags-Werten.

public:
 void DrawText(System::Windows::Forms::TextFormatFlags flags);
public void DrawText (System.Windows.Forms.TextFormatFlags flags);
member this.DrawText : System.Windows.Forms.TextFormatFlags -> unit
Public Sub DrawText (flags As TextFormatFlags)

Parameter

flags
TextFormatFlags

Eine bitweise Kombination von TextFormatFlags-Werten.

Hinweise

Verwenden Sie diese Methode, um den Elementtext mit den aktuellen Werten der ListViewItem.ForeColor Eigenschaften und ListViewItem.Font zu zeichnen. Mit TextFormatFlags den flags im Parameter angegebenen Werten können Sie Formatierungseigenschaften für die Knotenbezeichnung angeben, z. B. textausrichtung. Der Text wird innerhalb des von der -Eigenschaft angegebenen Bereichs Bounds gezeichnet. Sie können den Text auch manuell zeichnen, indem Sie das Graphics über die Graphics -Eigenschaft abgerufene verwenden.

Die DrawText -Methode ist besonders nützlich, wenn die ListView.View -Eigenschaft auf einen anderen Wert als View.Detailsfestgelegt ist. In der Detailansicht zeichnet diese Methode den Text für , ListViewItemzeichnet jedoch nicht den Text für Unterelemente. Daher ist es in der Detailansicht im Allgemeinen bequemer, den ListView gesamten Text in einem Handler für das ListView.DrawSubItem Ereignis zu zeichnen.

Weitere Informationen

Gilt für: