TextRenderer Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece os métodos usados para medir e renderizar o texto. Essa classe não pode ser herdada.

public ref class TextRenderer sealed

public ref class TextRenderer abstract sealed

public sealed class TextRenderer

public static class TextRenderer

type TextRenderer = class

Public NotInheritable Class TextRenderer

Public Class TextRenderer

Herança: Object
TextRenderer

Exemplos

O exemplo de código a seguir demonstra como usar o DrawText método . Para executar este exemplo, cole o código em um Formulário do Windows e chame RenderText1 do manipulador de eventos do Paint formulário, passando e como PaintEventArgs.

private void RenderText1(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font, 
        new Point(10, 10), SystemColors.ControlText);
}

Private Sub RenderText1(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", _
        Me.Font, New Point(10, 10), SystemColors.ControlText)

End Sub

Comentários

A TextRenderer classe fornece um conjunto de static métodos que podem ser usados para medir e desenhar texto em um controle do Windows Form.

Você pode manipular como o texto é desenhado usando uma das sobrecargas DrawText que usa um parâmetro TextFormatFlags. Por exemplo, o comportamento padrão do TextRenderer é adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos suspensos. Se você precisar desenhar uma linha de texto sem esses espaços extras, deverá usar as versões de DrawText e MeasureText que usam um parâmetro Size e TextFormatFlags. Para ver um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Observação

Os DrawText métodos de TextRenderer não têm suporte para impressão. Você sempre deve usar os DrawString métodos da Graphics classe .

Métodos

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, fonte e cor especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, a fonte, a cor e a cor do fundo especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Desenha o texto especificado na localização especificada usando o contexto de dispositivo, a fonte, a cor, a cor de fundo e as instruções de formatação especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, TextFormatFlags)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, a fonte, a cor e instruções de formatação especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Desenha o texto especificado nos limites especificados usando o contexto, a fonte e a cor do dispositivo especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color)	Desenha o texto especificado nos limites especificados usando o contexto de dispositivo, a fonte, a cor e a cor de fundo especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, Color, TextFormatFlags)	Desenha o texto especificado dentro dos limites especificados usando o contexto de dispositivo, a fonte, a cor, a cor de fundo e as instruções de formatação especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color, TextFormatFlags)	Desenha o texto especificado dentro dos limites especificados usando o contexto de dispositivo, a fonte, a cor e instruções de formatação especificados.
DrawText(IDeviceContext, String, Font, Point, Color)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, fonte e cor especificados.
DrawText(IDeviceContext, String, Font, Point, Color, Color)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, a fonte, a cor e a cor do fundo especificados.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Desenha o texto especificado na localização especificada usando o contexto de dispositivo, a fonte, a cor, a cor de fundo e as instruções de formatação especificados.
DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)	Desenha o texto especificado no local especificado usando o contexto de dispositivo, a fonte, a cor e instruções de formatação especificados.
DrawText(IDeviceContext, String, Font, Rectangle, Color)	Desenha o texto especificado nos limites especificados usando o contexto, a fonte e a cor do dispositivo especificados.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color)	Desenha o texto especificado nos limites especificados usando o contexto de dispositivo, a fonte, a cor e a cor de fundo especificados.
DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)	Desenha o texto especificado dentro dos limites especificados usando o contexto de dispositivo, a fonte, a cor, a cor de fundo e as instruções de formatação especificados.
DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)	Desenha o texto especificado dentro dos limites especificados usando o contexto de dispositivo, a fonte, a cor e instruções de formatação especificados.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font)	Fornece o tamanho, em pixels, do texto especificado desenhado com a fonte especificada no contexto de dispositivo especificado.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte no contexto de dispositivo especificado, usando o tamanho especificado para criar um retângulo delimitador inicial para o texto.
MeasureText(IDeviceContext, ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com as instruções de formatação, fonte e contexto do dispositivo especificadas, usando o tamanho especificado para criar o retângulo delimitador inicial para o texto.
MeasureText(IDeviceContext, String, Font)	Fornece o tamanho, em pixels, do texto especificado desenhado com a fonte especificada no contexto de dispositivo especificado.
MeasureText(IDeviceContext, String, Font, Size)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte no contexto de dispositivo especificado, usando o tamanho especificado para criar um retângulo delimitador inicial para o texto.
MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com as instruções de formatação, fonte e contexto do dispositivo especificadas, usando o tamanho especificado para criar o retângulo delimitador inicial para o texto.
MeasureText(ReadOnlySpan<Char>, Font)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte especificada.
MeasureText(ReadOnlySpan<Char>, Font, Size)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte especificada, usando o tamanho especificado para criar um retângulo delimitador inicial.
MeasureText(ReadOnlySpan<Char>, Font, Size, TextFormatFlags)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte e as instruções de formatação especificadas, usando o tamanho especificado para criar o retângulo delimitador inicial para o texto.
MeasureText(String, Font)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte especificada.
MeasureText(String, Font, Size)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte especificada, usando o tamanho especificado para criar um retângulo delimitador inicial.
MeasureText(String, Font, Size, TextFormatFlags)	Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte e as instruções de formatação especificadas, usando o tamanho especificado para criar o retângulo delimitador inicial para o texto.

Aplica-se a

Compartilhar via