TextRenderer Classe

Definição

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

public ref class TextRenderer sealed
public sealed class TextRenderer
type TextRenderer = class
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 ver um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).For an example, see MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Observação

Os métodos 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.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
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.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a