Compartilhar via


Como desenhar texto com o GDI

Com o método na classe, você pode acessar a DrawTextTextRenderer funcionalidade GDI para desenhar texto em um formulário ou controle. A renderização de texto GDI normalmente oferece melhor desempenho e medição de texto mais precisa do que GDI+.

Observação

Os DrawText métodos da TextRenderer classe não são suportados para impressão. Ao imprimir, sempre use os DrawStringGraphics métodos da classe.

Exemplo

O exemplo de código a seguir demonstra como desenhar texto em várias linhas dentro de um retângulo usando o DrawText método.

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 renderizar texto com a TextRenderer classe, você precisa de um IDeviceContext, como a Graphics e um Font, um local para desenhar o texto e a cor na qual ele deve ser desenhado. Opcionalmente, você pode especificar a formatação de texto usando a TextFormatFlags enumeração.

Para obter mais informações sobre como obter um Graphics, consulte Como criar objetos gráficos para desenho. Para obter mais informações sobre como construir um Font, consulte Como construir famílias de fontes e fontes.

Compilando o código

O exemplo de código anterior foi projetado para uso com Windows Forms e requer o PaintEventArgse, que é um parâmetro de PaintEventHandler.

Confira também