DrawListViewItemEventArgs.DrawText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Nakreslí text ListViewItem pomocí aktuální barvy popředí a výchozího formátování.

Přetížení

Name	Description
DrawText()	Nakreslí text ListViewItem pomocí aktuální barvy popředí.
DrawText(TextFormatFlags)	Nakreslí text ListViewItem pomocí aktuální barvy popředí a naformátuje ho zadanými TextFormatFlags hodnotami.

DrawText()

Zdroj:

DrawListViewItemEventArgs.cs

Nakreslí text ListViewItem pomocí aktuální barvy popředí.

public:
 void DrawText();

public void DrawText();

member this.DrawText : unit -> unit

Public Sub DrawText ()

Příklady

Následující příklad kódu ukazuje, jak použít metodu DrawText v aplikaci, která poskytuje vlastní výkres ListView ovládacího prvku. V příkladu obslužná rutina události ListView.DrawItem nakreslí pozadí pro celé položky. Ve všechzobrazeních V zobrazení podrobností je text popředí vykreslen v ListView.DrawSubItem události.

Úplný příklad najdete v referenčním tématu přehledu DrawListViewItemEventArgs .

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

Poznámky

Pomocí této metody lze nakreslit text položky pomocí aktuálních ListViewItem.ForeColor hodnot a ListViewItem.Font vlastností. Text je nakreslen v oblasti určené Bounds vlastností. Text můžete také nakreslit ručně pomocí Graphics načtené vlastnosti Graphics .

Metoda DrawText je nejužitečnější, pokud ListView.View je vlastnost nastavena na jinou hodnotu než View.Details. V zobrazení podrobností tato metoda nakreslí text pro ListViewItem, ale nenakreslí text pro dílčí položky. Proto je v zobrazení podrobností obecně pohodlnější nakreslit veškerý ListView text v obslužné rutině ListView.DrawSubItem události.

Viz také

• Bounds
• Graphics
• ListView
• DrawItem
• DrawSubItem
• View
• ListViewItem
• Font
• ForeColor

DrawText(TextFormatFlags)

Zdroj:

DrawListViewItemEventArgs.cs

Nakreslí text ListViewItem pomocí aktuální barvy popředí a naformátuje ho zadanými TextFormatFlags hodnotami.

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

Bitové kombinace TextFormatFlags hodnot.

Poznámky

Pomocí této metody lze nakreslit text položky pomocí aktuálních ListViewItem.ForeColor hodnot a ListViewItem.Font vlastností. Hodnoty TextFormatFlags zadané v parametru flags umožňují zadat vlastnosti formátování popisku uzlu, například zarovnání textu. Text je nakreslen v oblasti určené Bounds vlastností. Text můžete také nakreslit ručně pomocí Graphics načtené vlastnosti Graphics .

Metoda DrawText je nejužitečnější, pokud ListView.View je vlastnost nastavena na jinou hodnotu než View.Details. V zobrazení podrobností tato metoda nakreslí text pro ListViewItem, ale nenakreslí text pro dílčí položky. Proto je v zobrazení podrobností obecně pohodlnější nakreslit veškerý ListView text v obslužné rutině ListView.DrawSubItem události.

Viz také

• Bounds
• Graphics
• ListView
• DrawItem
• DrawSubItem
• View
• ListViewItem
• Font
• ForeColor
• TextFormatFlags