DrawListViewItemEventArgs.DrawText Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Dibuja el texto del control ListViewItem utilizando el color de primer plano actual y el formato predeterminado.

Sobrecargas

DrawText()

Dibuja el texto del control ListViewItem utilizando su color de primer plano actual.
DrawText(TextFormatFlags)

Dibuja el texto del control ListViewItem utilizando el color de primer plano actual y dándole formato con los valores TextFormatFlags especificados.

DrawText()

Dibuja el texto del control ListViewItem utilizando su color de primer plano actual.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el DrawText método en una aplicación que proporciona un dibujo personalizado para un ListView control. En el ejemplo, un controlador para el ListView.DrawItem evento dibuja el fondo de todos los elementos. En todas las vistas excepto la vista de detalles, este controlador también dibuja el texto en primer plano. En la vista de detalles, el texto en primer plano se dibuja en el ListView.DrawSubItem evento .

Para obtener el ejemplo completo, consulte el DrawListViewItemEventArgs tema de referencia de información general.

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

Comentarios

Utilice este método para dibujar el texto del elemento mediante los valores actuales de las ListViewItem.ForeColor propiedades y ListViewItem.Font . El texto se dibuja dentro del área especificada por la Bounds propiedad . También puede dibujar el texto manualmente mediante el Graphics recuperado a través de la Graphics propiedad .

El DrawText método es más útil cuando la ListView.View propiedad se establece en un valor distinto View.Detailsde . En la vista de detalles, este método dibuja el texto de ListViewItem, pero no dibuja el texto de los subelementos. Por lo tanto, en la vista de detalles, generalmente es más conveniente dibujar todo el ListView texto de un controlador para el ListView.DrawSubItem evento.

Consulte también

Se aplica a

DrawText(TextFormatFlags)

Dibuja el texto del control ListViewItem utilizando el color de primer plano actual y dándole formato con los valores TextFormatFlags especificados.

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)

Parámetros

flags
TextFormatFlags

Combinación bit a bit de valores TextFormatFlags.

Comentarios

Utilice este método para dibujar el texto del elemento mediante los valores actuales de las ListViewItem.ForeColor propiedades y ListViewItem.Font . Los TextFormatFlags valores especificados en el flags parámetro permiten proporcionar propiedades de formato para la etiqueta del nodo, como la alineación de texto. El texto se dibuja dentro del área especificada por la Bounds propiedad . También puede dibujar el texto manualmente mediante el Graphics recuperado a través de la Graphics propiedad .

El DrawText método es más útil cuando la ListView.View propiedad se establece en un valor distinto View.Detailsde . En la vista de detalles, este método dibuja el texto de ListViewItem, pero no dibuja el texto de los subelementos. Por lo tanto, en la vista de detalles, generalmente es más conveniente dibujar todo el ListView texto de un controlador para el ListView.DrawSubItem evento.

Consulte también

Se aplica a