Bagikan melalui

DrawListViewItemEventArgs.DrawText Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Menggambar teks menggunakan ListViewItem warna latar depan saat ini dan pemformatan default.

Overload

DrawText()

Menggambar teks menggunakan ListViewItem warna latar depannya saat ini.
DrawText(TextFormatFlags)

Menggambar teks menggunakan ListViewItem warna latar depan saat ini dan memformatnya dengan nilai yang ditentukan TextFormatFlags .

DrawText()

Menggambar teks menggunakan ListViewItem warna latar depannya saat ini.

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

Contoh

Contoh kode berikut menunjukkan cara menggunakan DrawText metode dalam aplikasi yang menyediakan gambar kustom untuk ListView kontrol. Dalam contoh, handler untuk ListView.DrawItem peristiwa menggambar latar belakang untuk seluruh item. Di semua tampilan kecuali tampilan detail, handler ini juga menggambar teks latar depan. Dalam tampilan detail, teks latar depan digambar dalam peristiwa tersebut ListView.DrawSubItem .

Untuk contoh lengkapnya, lihat DrawListViewItemEventArgs topik referensi gambaran umum.

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

Keterangan

Gunakan metode ini untuk menggambar teks item menggunakan nilai ListViewItem.ForeColor properti dan ListViewItem.Font saat ini. Teks digambar di dalam area yang ditentukan oleh Bounds properti . Anda juga dapat menggambar teks secara manual menggunakan yang Graphics diambil melalui Graphics properti .

Metode DrawText ini paling berguna ketika ListView.View properti diatur ke nilai selain View.Details. Dalam tampilan detail, metode ini menggambar teks untuk ListViewItem, tetapi tidak menggambar teks untuk subitem. Oleh karena itu, dalam tampilan detail, umumnya lebih nyaman untuk menggambar semua ListView teks dalam handler untuk peristiwa tersebut ListView.DrawSubItem .

Lihat juga

Berlaku untuk

DrawText(TextFormatFlags)

Menggambar teks menggunakan ListViewItem warna latar depan saat ini dan memformatnya dengan nilai yang ditentukan TextFormatFlags .

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

Kombinasi TextFormatFlags nilai bitwise.

Keterangan

Gunakan metode ini untuk menggambar teks item menggunakan nilai ListViewItem.ForeColor properti dan ListViewItem.Font saat ini. Nilai TextFormatFlags yang ditentukan dalam flags parameter memungkinkan Anda menyediakan properti pemformatan untuk label simpul, seperti perataan teks. Teks digambar di dalam area yang ditentukan oleh Bounds properti . Anda juga dapat menggambar teks secara manual menggunakan yang Graphics diambil melalui Graphics properti .

Metode DrawText ini paling berguna ketika ListView.View properti diatur ke nilai selain View.Details. Dalam tampilan detail, metode ini menggambar teks untuk ListViewItem, tetapi tidak menggambar teks untuk subitem. Oleh karena itu, dalam tampilan detail, umumnya lebih nyaman untuk menggambar semua ListView teks dalam handler untuk peristiwa tersebut ListView.DrawSubItem .

Lihat juga

Berlaku untuk