Cómo: Dibujar texto con GDI

Actualización: noviembre 2007

Con el método DrawText de la clase TextRenderer , puede obtener acceso a las funciones de GDI para dibujar texto en un formulario o control. La representación de texto en GDI normalmente ofrece un mayor rendimiento y una medida más precisa del texto que GDI+.

Nota:
Los métodos DrawText de la clase TextRenderer no se admiten para imprimir. Al imprimir, siempre utilice los métodos DrawString de la clase Graphics.

Ejemplo

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

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

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);
}

Para representar texto con la clase TextRenderer, necesita una interfaz IDeviceContext, como Graphics y Font, una ubicación para dibujar el texto y el color con el que se va a dibujar. Opcionalmente, puede especificar el formato de texto utilizando la enumeración TextFormatFlags.

Para obtener más información sobre cómo obtener Graphics, vea Cómo: Crear objetos Graphics para dibujar. Para obtener más información sobre cómo construir una clase Font, vea Cómo: Construir fuentes y familias de fuentes.

Compilar el código

El ejemplo anterior está diseñado para formularios Windows Forms y requiere PaintEventArgse, que es un parámetro de PaintEventHandler.

Vea también

Referencia

TextRenderer

Font

Color

Color

Otros recursos

Utilizar fuentes y texto