DrawListViewItemEventArgs.DrawText Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Crea il testo di ListViewItem utilizzandone il colore di primo piano corrente e la formattazione predefinita.

Overload

DrawText()	Crea il testo di ListViewItem utilizzandone il colore di primo piano corrente.
DrawText(TextFormatFlags)	Crea il testo di ListViewItem utilizzando il relativo colore di primo piano corrente e i valori di formattazione TextFormatFlags specificati.

DrawText()

Origine:

DrawListViewItemEventArgs.cs

Crea il testo di ListViewItem utilizzandone il colore di primo piano corrente.

public:
 void DrawText();

public void DrawText ();

member this.DrawText : unit -> unit

Public Sub DrawText ()

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il DrawText metodo in un'applicazione che fornisce disegno personalizzato per un ListView controllo . Nell'esempio, un gestore per l'evento ListView.DrawItem disegna lo sfondo per interi elementi. In tutte le visualizzazioni, ad eccezione della visualizzazione dettagli, questo gestore disegna anche il testo in primo piano. Nella visualizzazione dei dettagli il testo in primo piano viene disegnato nell'evento ListView.DrawSubItem .

Per l'esempio completo, vedere l'argomento di DrawListViewItemEventArgs riferimento di panoramica.

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

Commenti

Utilizzare questo metodo per disegnare il testo dell'elemento ListViewItem.ForeColor utilizzando i valori correnti delle proprietà e ListViewItem.Font . Il testo viene disegnato all'interno dell'area specificata dalla Bounds proprietà . È anche possibile disegnare manualmente il testo usando l'oggetto Graphics recuperato tramite la Graphics proprietà .

Il DrawText metodo è più utile quando la ListView.View proprietà è impostata su un valore diverso da View.Details. Nella visualizzazione dettagli questo metodo disegna il testo per , ListViewItemma non disegna il testo per gli elementi secondari. Pertanto, nella visualizzazione dei dettagli, è in genere più comodo disegnare tutto il ListView testo in un gestore per l'evento ListView.DrawSubItem .

Vedi anche

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

DrawText(TextFormatFlags)

Origine:

DrawListViewItemEventArgs.cs

Crea il testo di ListViewItem utilizzando il relativo colore di primo piano corrente e i valori di formattazione TextFormatFlags specificati.

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)

Parametri

flags

TextFormatFlags

Combinazione bit per bit dei valori di TextFormatFlags.

Commenti

Utilizzare questo metodo per disegnare il testo dell'elemento ListViewItem.ForeColor utilizzando i valori correnti delle proprietà e ListViewItem.Font . I TextFormatFlags valori specificati nel flags parametro consentono di specificare le proprietà di formattazione per l'etichetta del nodo, ad esempio l'allineamento del testo. Il testo viene disegnato all'interno dell'area specificata dalla Bounds proprietà . È anche possibile disegnare manualmente il testo usando l'oggetto Graphics recuperato tramite la Graphics proprietà .

Il DrawText metodo è più utile quando la ListView.View proprietà è impostata su un valore diverso da View.Details. Nella visualizzazione dettagli questo metodo disegna il testo per , ListViewItemma non disegna il testo per gli elementi secondari. Pertanto, nella visualizzazione dei dettagli, è in genere più comodo disegnare tutto il ListView testo in un gestore per l'evento ListView.DrawSubItem .

Vedi anche

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