Share via

Como desenhar texto com o GDI

  • Artigo

Com o DrawText método na classe, você pode acessar a TextRenderer 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 a GDI+.

Observação

Os DrawText métodos da classe não são suportados TextRenderer para impressão. Ao imprimir, use sempre os DrawString métodos da Graphics 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 o texto com a classe, você precisa de um , como a e a , um IDeviceContextlocal para desenhar o texto e a FontTextRendererGraphics cor na qual ele deve ser desenhado. Opcionalmente, você pode especificar a formatação do 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 o Windows Forms e requer o PaintEventArgse, que é um parâmetro de PaintEventHandler.

Confira também