DrawListViewItemEventArgs.DrawText Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Rysuje tekst przy użyciu bieżącego ListViewItem koloru pierwszego planu i domyślnego formatowania.

Przeciążenia

DrawText()

Rysuje tekst przy użyciu bieżącego ListViewItem koloru pierwszego planu.
DrawText(TextFormatFlags)

Rysuje tekst przy użyciu bieżącego ListViewItem koloru pierwszego planu i formatuje go z określonymi TextFormatFlags wartościami.

DrawText()

Rysuje tekst przy użyciu bieżącego ListViewItem koloru pierwszego planu.

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

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DrawText metody w aplikacji, która udostępnia niestandardowy rysunek dla kontrolki ListView . W tym przykładzie program obsługi zdarzenia ListView.DrawItem rysuje tło dla całych elementów. We wszystkich widokach oprócz widoku szczegółów ta procedura obsługi rysuje również tekst pierwszego planu. W widoku szczegółów tekst pierwszego planu jest rysowany w ListView.DrawSubItem zdarzeniu.

Pełny przykład można znaleźć w temacie referencyjnym DrawListViewItemEventArgs przeglądu.

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

Uwagi

Użyj tej metody, aby narysować tekst elementu przy użyciu bieżących ListViewItem.ForeColor wartości właściwości i ListViewItem.Font . Tekst jest rysowany w obszarze określonym przez Bounds właściwość . Tekst można również narysować ręcznie przy użyciu Graphics właściwości pobranej Graphics za pomocą właściwości .

Metoda jest najbardziej przydatna DrawText , gdy ListView.View właściwość jest ustawiona na wartość inną niż View.Details. W widoku szczegółów ta metoda rysuje tekst dla ListViewItemelementu , ale nie rysuje tekstu dla podywitów. W związku z tym w widoku szczegółów na ogół wygodniejsze jest rysowanie całego ListView tekstu w procedurze obsługi zdarzenia ListView.DrawSubItem .

Zobacz też

Dotyczy

DrawText(TextFormatFlags)

Rysuje tekst przy użyciu bieżącego ListViewItem koloru pierwszego planu i formatuje go z określonymi TextFormatFlags wartościami.

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)

Parametry

flags
TextFormatFlags

Bitowa kombinacja TextFormatFlags wartości.

Uwagi

Użyj tej metody, aby narysować tekst elementu przy użyciu bieżących ListViewItem.ForeColor wartości właściwości i ListViewItem.Font . Wartości TextFormatFlags określone w parametrze flags umożliwiają podanie właściwości formatowania dla etykiety węzła, takich jak wyrównanie tekstu. Tekst jest rysowany w obszarze określonym przez Bounds właściwość . Tekst można również narysować ręcznie przy użyciu Graphics właściwości pobranej Graphics za pomocą właściwości .

Metoda jest najbardziej przydatna DrawText , gdy ListView.View właściwość jest ustawiona na wartość inną niż View.Details. W widoku szczegółów ta metoda rysuje tekst dla ListViewItemelementu , ale nie rysuje tekstu dla podywitów. W związku z tym w widoku szczegółów na ogół wygodniejsze jest rysowanie całego ListView tekstu w procedurze obsługi zdarzenia ListView.DrawSubItem .

Zobacz też

Dotyczy