TextRenderer TextRenderer TextRenderer TextRenderer Class

Definición

Proporciona métodos utilizados para medir y representar texto.Provides methods used to measure and render text. Esta clase no puede heredarse.This class cannot be inherited.

public ref class TextRenderer sealed
public sealed class TextRenderer
type TextRenderer = class
Public NotInheritable Class TextRenderer
Herencia
TextRendererTextRendererTextRendererTextRenderer

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText.The following code example demonstrates how to use the DrawText method. Para ejecutar este ejemplo, pegue el código en un Windows Form y llame RenderText1 al controlador de eventos Paint del formulario, pasando 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


Comentarios

La TextRenderer clase proporciona un conjunto de static métodos que se pueden usar para medir y dibujar texto en un control de Windows Forms.The TextRenderer class provides a set of static methods that can be used for measuring and drawing text on a Windows Form control.

Puede manipular cómo se traza el texto mediante una de las sobrecargas de DrawText que toma un parámetro TextFormatFlags.You can manipulate how the text is drawn by using one of the DrawText overloads that takes a TextFormatFlags parameter. Por ejemplo, el comportamiento predeterminado de TextRenderer es agregar relleno al rectángulo de delimitación del texto trazado para dar cabida a glifos que sobresalgan.For example, the default behavior of the TextRenderer is to add padding to the bounding rectangle of the drawn text to accommodate overhanging glyphs. Si tiene que trazar una línea de texto sin estos espacios extra, debe usar las versiones de DrawText y MeasureText que toman un parámetro Size y 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 obtener un ejemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).For an example, see MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

Nota

No se admiten los métodos DrawText de TextRenderer para la impresión.The DrawText methods of TextRenderer are not supported for printing. Siempre debe utilizar los DrawString métodos de la Graphics clase.You should always use the DrawString methods of the Graphics class.

Métodos

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

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente y color que se concreten.Draws the specified text at the specified location using the specified device context, font, and color.

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

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente, color y color de fondo que se concreten.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) DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente, color, color de fondo e instrucciones de formato que se concreten.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) DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Point, Color, TextFormatFlags)

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente, color e instrucciones de formato que se concreten.Draws the specified text at the specified location using the specified device context, font, color, and formatting instructions.

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

Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente y color que se concreten.Draws the specified text within the specified bounds, using the specified device context, font, and color.

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

Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente, color y color de fondo que se concretan.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) DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Rectangle, Color, Color, TextFormatFlags)

Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente, color, color de fondo e instrucciones de formato que se concreten.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) DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags) DrawText(IDeviceContext, String, Font, Rectangle, Color, TextFormatFlags)

Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente, color e instrucciones de formato que se concreten.Draws the specified text within the specified bounds using the specified device context, font, color, and formatting instructions.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MeasureText(IDeviceContext, String, Font) MeasureText(IDeviceContext, String, Font) MeasureText(IDeviceContext, String, Font) MeasureText(IDeviceContext, String, Font)

Proporciona el tamaño, en píxeles, del texto especificado trazado con la fuente indicada en el contexto de dispositivo que se concrete.Provides the size, in pixels, of the specified text drawn with the specified font in the specified device context.

MeasureText(IDeviceContext, String, Font, Size) MeasureText(IDeviceContext, String, Font, Size) MeasureText(IDeviceContext, String, Font, Size) MeasureText(IDeviceContext, String, Font, Size)

Proporciona el tamaño, en píxeles, del texto especificado cuando se traza con la fuente indicada en el contexto de dispositivo dado y utilizando el tamaño concretado para crear un rectángulo delimitador inicial.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) MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags) MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags) MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)

Proporciona el tamaño, en píxeles, del texto especificado cuando se traza con el dispositivo de contexto, la fuente y las instrucciones de formato indicadas y utilizando el tamaño concretado para crear un rectángulo delimitador inicial.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) MeasureText(String, Font) MeasureText(String, Font) MeasureText(String, Font)

Proporciona el tamaño, en píxeles, del texto especificado cuando se traza con la fuente determinada.Provides the size, in pixels, of the specified text when drawn with the specified font.

MeasureText(String, Font, Size) MeasureText(String, Font, Size) MeasureText(String, Font, Size) MeasureText(String, Font, Size)

Proporciona el tamaño, en píxeles, del texto especificado cuando se traza con la fuente indicada y utilizando el tamaño concretado para crear un rectá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) MeasureText(String, Font, Size, TextFormatFlags) MeasureText(String, Font, Size, TextFormatFlags) MeasureText(String, Font, Size, TextFormatFlags)

Proporciona el tamaño, en píxeles, del texto especificado cuando se traza con la fuente e instrucciones de formato indicadas y utilizando el tamaño concretado para crear un rectángulo delimitador inicial.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() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a