TextRenderer Classe

Definição

Fornece os métodos usados para medir e renderizar o texto.Provides methods used to measure and render text. Esta classe não pode ser herdada.This class cannot be inherited.

public ref class TextRenderer abstract sealed
public ref class TextRenderer sealed
public static class TextRenderer
public sealed class TextRenderer
type TextRenderer = class
Public Class TextRenderer
Public NotInheritable Class TextRenderer
Herança
TextRenderer

Exemplos

O exemplo de código a seguir demonstra como usar o método DrawText.The following code example demonstrates how to use the DrawText method. Para executar este exemplo, Cole o código em um formulário do Windows e chame RenderText1 no manipulador de eventos Paint do formulário, passando e como PaintEventArgs.To run this example, paste the code into a Windows Form and call RenderText1 from the form's Paint event handler, passing e as 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 classe TextRenderer fornece um conjunto de métodos static que podem ser usados para medir e desenhar texto em um controle de formulário do Windows.The TextRenderer class provides a set of static methods that can be used for measuring and drawing text on a Windows Form control.

Você pode manipular como o texto é desenhado usando uma das sobrecargas DrawText que usa um parâmetro TextFormatFlags.You can manipulate how the text is drawn by using one of the DrawText overloads that takes a TextFormatFlags parameter. Por exemplo, o comportamento padrão do TextRenderer é adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos suspensos.For example, the default behavior of the TextRenderer is to add padding to the bounding rectangle of the drawn text to accommodate overhanging glyphs. 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.If you need to draw a line of text without these extra spaces you should use the versions of DrawText and MeasureText that take a Size and TextFormatFlags parameter. Para obter um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).For an example, see MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Observação

Os métodos de DrawText de TextRenderer não têm suporte para impressão.The DrawText methods of TextRenderer are not supported for printing. Você sempre deve usar os métodos DrawString da classe Graphics.You should always use the DrawString methods of the Graphics class.

Métodos

DrawText(IDeviceContext, String, Font, Point, Color)

Desenha o texto especificado no local especificado usando o contexto de dispositivo, fonte e cor especificados.Draws the specified text at the specified location using the specified device context, font, and color.

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.Draws the specified text at the specified location, using the specified device context, font, color, and back color.

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.Draws the specified text at the specified location using the specified device context, font, color, back color, and formatting instructions.

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.Draws the specified text at the specified location using the specified device context, font, color, and formatting instructions.

DrawText(IDeviceContext, String, Font, Rectangle, Color)

Desenha o texto especificado nos limites especificados usando o contexto, a fonte e a cor do dispositivo especificados.Draws the specified text within the specified bounds, using the specified device context, font, and color.

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.Draws the specified text within the specified bounds using the specified device context, font, color, and back color.

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.Draws the specified text within the specified bounds using the specified device context, font, color, back color, and formatting instructions.

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.Draws the specified text within the specified bounds using the specified device context, font, color, and formatting instructions.

MeasureText(IDeviceContext, String, Font)

Fornece o tamanho, em pixels, do texto especificado desenhado com a fonte especificada no contexto de dispositivo especificado.Provides the size, in pixels, of the specified text drawn with the specified font in the specified device context.

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.Provides the size, in pixels, of the specified text when drawn with the specified font in the specified device context, using the specified size to create an initial bounding rectangle for the text.

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.Provides the size, in pixels, of the specified text when drawn with the specified device context, font, and formatting instructions, using the specified size to create the initial bounding rectangle for the text.

MeasureText(String, Font)

Fornece o tamanho, em pixels, do texto especificado quando desenhado com a fonte especificada.Provides the size, in pixels, of the specified text when drawn with the specified font.

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.Provides the size, in pixels, of the specified text when drawn with the specified font, using the specified size to create an initial bounding rectangle.

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.Provides the size, in pixels, of the specified text when drawn with the specified font and formatting instructions, using the specified size to create the initial bounding rectangle for the text.

Aplica-se a