Procedimiento para dibujar texto con GDI

  • Artículo

Con el método DrawText de la clase TextRenderer, puede acceder a la funcionalidad de GDI para dibujar texto en un formulario o control. La representación de texto de GDI suele ofrecer un rendimiento mejor y una medición de texto más precisa que GDI+.

Nota:

No se admiten los métodos DrawText de la clase TextRenderer para la impresión. Al imprimir, use siempre los métodos DrawString de la clase Graphics.

Ejemplo

En el ejemplo de código siguiente se muestra cómo dibujar texto en varias líneas dentro de un rectángulo mediante el método DrawText.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}

Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

Para representar texto con la clase TextRenderer, necesita un objeto IDeviceContext, como Graphics y Font, una ubicación para dibujar el texto y el color en el que se debe dibujar. Opcionalmente, puede especificar el formato del texto con la enumeración TextFormatFlags.

Para más información sobre cómo obtener un objeto Graphics, consulte Procedimiento para crear objetos gráficos para dibujar. Para más información sobre cómo construir un objeto Font, consulte Procedimiento para construir fuentes y familias de fuentes.

Compilar el código

El ejemplo de código anterior está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro de PaintEventHandler.

Consulte también