TextRenderer.DrawText Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, color y fuente que se concreten.

Sobrecargas

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)	Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente y color que se concreten.
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.
DrawText(IDeviceContext, String, Font, Point, Color, Color, TextFormatFlags)	Dibuja el texto especificado en la ubicación indicada, mediante las instrucciones de contexto de dispositivo, fuente, color, color de fondo y formato especificados.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)	Dibuja el texto especificado en la ubicación indicada, mediante las instrucciones de contexto de dispositivo, fuente, color, color de fondo y formato especificados.
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.
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.
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.
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.
DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.
DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.
DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.
DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.
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.
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.
DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)	Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente y color que se concreten.
DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

Comentarios

La representación de texto que ofrece la clase se basa en la TextRenderer representación de texto GDI y no se admite para imprimir desde Windows Forms. En su lugar, use los DrawString métodos de la Graphics clase .

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color)

Traza el texto especificado en la ubicación indicada, utilizando el contexto de dispositivo, fuente y color que se concreten.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

Excepciones

ArgumentNullException

dc es null.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto.

backColor: Color

Color que se va a aplicar al área que representa bounds.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText8 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private void RenderText8(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.WordBreak;
    TextRenderer.DrawText(e.Graphics, "This is some text that will display on multiple lines.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, SystemColors.ControlDark, flags);
}

Private Sub RenderText8(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = _
        TextFormatFlags.Bottom Or TextFormatFlags.WordBreak
    TextRenderer.DrawText(e.Graphics, _
        "This is some text that will display on multiple lines.", _
        Me.Font, New Rectangle(10, 10, 100, 50), _
        SystemColors.ControlText, SystemColors.ControlDark, flags)

End Sub

Comentarios

El backcolor parámetro se aplica al área dentro del bounds parámetro. If font, forecolor o backcolor es null o Empty, respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

Puede manipular cómo se traza el texto mediante una de las sobrecargas de DrawText que toma un parámetro TextFormatFlags. 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. 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. Para obtener un ejemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

La representación de texto que ofrece la clase se basa en la TextRenderer representación de texto GDI y no se admite para la impresión desde Windows Forms. En su lugar, use los DrawString métodos de la Graphics clase .

TextRenderer no admite la adición de posiciones de tabulación en texto dibujado, aunque es posible expandir las posiciones de tabulación existentes con la marca ExpandTabs.

Se aplica a

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

Dibuja el texto especificado en la ubicación indicada, mediante las instrucciones de contexto de dispositivo, fuente, color, color de fondo y formato especificados.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText7 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private void RenderText7(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "This is some text.", this.Font,
        new Point(10, 10), Color.White, Color.SteelBlue, TextFormatFlags.Default);
}

Private Sub RenderText7(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "This is some text.", _
        Me.Font, New Point(10, 10), Color.White, Color.SteelBlue, _
        TextFormatFlags.Default)

End Sub

Comentarios

El backcolor parámetro se aplica al área rectangular que contiene el texto dibujado. Si font o es null o Emptyforecolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

TextRenderer no admite la adición de posiciones de tabulación en texto dibujado, aunque es posible expandir las posiciones de tabulación existentes con la marca ExpandTabs.

Nota:

Los DrawText métodos que especifican como Point la esquina superior izquierda del texto dibujado no se representan correctamente en Windows 2000. Si la aplicación está pensada para su uso en máquinas que ejecutan Windows 2000, debe usar uno de los DrawText métodos que especifican un Rectangle para los límites del texto dibujado.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Point, Color, Color, TextFormatFlags)

Dibuja el texto especificado en la ubicación indicada, mediante las instrucciones de contexto de dispositivo, fuente, color, color de fondo y formato especificados.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

El valor de dc es null.

ArgumentOutOfRangeException

ModifyString está configurado.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText6 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

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

Comentarios

Si font o es null o Emptycolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

TextRenderer no admite la adición de posiciones de tabulación en texto dibujado, aunque es posible expandir las posiciones de tabulación existentes con la marca ExpandTabs.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área que representa bounds.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText4 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private void RenderText4(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text.", this.Font,
        new Rectangle(10, 10, 70, 70), SystemColors.ControlText, 
        SystemColors.ControlDark);
}

Private Sub RenderText4(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text.", _
        Me.Font, New Rectangle(10, 10, 70, 70), _
        SystemColors.ControlText, SystemColors.ControlDark)

End Sub

Comentarios

El backColor parámetro se aplica al área dentro del bounds parámetro . Si font, backcolor o es null o Emptyforecolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

Este método dará como resultado texto que se centra horizontal y verticalmente en el rectángulo especificado por el bounds parámetro . Para cambiar cómo se dibuja el texto, use una versión de que toma un TextFormatFlags tipo de DrawText parámetro.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText5 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private void RenderText5(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Some text.",
        this.Font, new Point(10, 10), SystemColors.ControlText, TextFormatFlags.Bottom);
}

Private Sub RenderText5(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Some text.", _
    Me.Font, New Point(10, 10), SystemColors.ControlText, _
    TextFormatFlags.Bottom)

End Sub

Comentarios

El backColor parámetro se aplica al área dentro del bounds parámetro . Si font o es null o Color.Emptyforecolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

TextRenderer no admite la adición de posiciones de tabulación en texto dibujado, aunque es posible expandir las posiciones de tabulación existentes con la marca ExpandTabs.

Nota:

Los DrawText métodos que especifican como Point la esquina superior izquierda del texto dibujado no se representan correctamente en Windows 2000. Si la aplicación está pensada para su uso en máquinas que ejecutan Windows 2000, debe usar uno de los DrawText métodos que especifique un Rectangle para los límites del texto dibujado.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color, backColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText3 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

private void RenderText3(PaintEventArgs e)
{
    TextRenderer.DrawText(e.Graphics, "Regular Text", this.Font,
        new Point(10, 10), Color.Red, Color.PowderBlue);
}

Private Sub RenderText3(ByVal e As PaintEventArgs)
    TextRenderer.DrawText(e.Graphics, "Regular Text", Me.Font, _
        New Point(10, 10), Color.Red, Color.PowderBlue)

End Sub

Comentarios

El backColor parámetro se aplica al área rectangular que contiene el texto dibujado. Si font, backcolor o es null o Color.Emptyforecolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

Puede manipular cómo se traza el texto mediante una de las sobrecargas de DrawText que toma un parámetro TextFormatFlags.

Nota

Los DrawText métodos que especifican como Point la esquina superior izquierda del texto dibujado no se representan correctamente en Windows 2000. Si la aplicación está pensada para su uso en máquinas que ejecutan Windows 2000, debe usar uno de los DrawText métodos que especifique un Rectangle para los límites del texto dibujado.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

ArgumentOutOfRangeException

ModifyString está configurado.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, backColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

Excepciones

ArgumentNullException

dc es null.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, flags As TextFormatFlags)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

flags: TextFormatFlags

Combinación bit a bit de los valores de TextFormatFlags.

Excepciones

ArgumentNullException

dc es null.

ArgumentOutOfRangeException

ModifyString está configurado.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor, System::Drawing::Color backColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor, System.Drawing.Color backColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, pt As Point, foreColor As Color, backColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

backColor: Color

Color que se va a aplicar al área de fondo del texto trazado.

Excepciones

ArgumentNullException

dc es null.

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, bounds As Rectangle, foreColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText2 desde el controlador de eventos del Paint formulario, pasando e como PaintEventArgs.

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

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

End Sub

Comentarios

Si font o es null o Color.Emptyforecolor , respectivamente; el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

Consulte también

IDeviceContext

Se aplica a

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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, System::String ^ text, System::Drawing::Font ^ font, System::Drawing::Point pt, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string text, System.Drawing.Font font, System.Drawing.Point pt, System.Drawing.Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, string? text, System.Drawing.Font? font, System.Drawing.Point pt, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * string * System.Drawing.Font * System.Drawing.Point * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As String, font As Font, pt As Point, foreColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: String

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

pt: Point

Point que representa la esquina superior izquierda del texto trazado.

foreColor: Color

Color que se va a aplicar al texto trazado.

Excepciones

ArgumentNullException

dc es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método DrawText. Para ejecutar este ejemplo, pegue el código en un formulario Windows Forms y llame RenderText1 desde el controlador de eventos del Paint formulario, pasando 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

Comentarios

Puede manipular cómo se traza el texto mediante una de las sobrecargas de DrawText que toma un parámetro TextFormatFlags.

Si font es o forecolor es Color.Emptynull , el DrawText método dibujará el texto en la fuente o color actualmente seleccionado en el contexto del dispositivo especificado por dc. Si forecolor es Transparent, el texto no se dibujará.

Nota:

Los DrawText métodos que especifican como Point la esquina superior izquierda del texto dibujado no se representan correctamente en Windows 2000. Si la aplicación está pensada para su uso en máquinas que ejecutan Windows 2000, debe usar uno de los DrawText métodos que especifique un Rectangle para los límites del texto dibujado.

Consulte también

IDeviceContext

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, Font, Rectangle, Color)

Traza el texto especificado dentro de los límites indicados, utilizando el contexto de dispositivo, fuente y color que se concreten.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color)

Parámetros

dc: IDeviceContext

Contexto de dispositivo en el que se traza el texto.

text: ReadOnlySpan<Char>

Texto que se va a trazar.

font: Font

Font que se va a aplicar al texto trazado.

bounds: Rectangle

Rectangle que representa los límites del texto.

foreColor: Color

Color que se va a aplicar al texto trazado.

Excepciones

ArgumentNullException

dc es null.

Se aplica a

DrawText(IDeviceContext, ReadOnlySpan<Char>, 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.

public:
 static void DrawText(System::Drawing::IDeviceContext ^ dc, ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::Rectangle bounds, System::Drawing::Color foreColor, System::Windows::Forms::TextFormatFlags flags);

public static void DrawText (System.Drawing.IDeviceContext dc, ReadOnlySpan<char> text, System.Drawing.Font? font, System.Drawing.Rectangle bounds, System.Drawing.Color foreColor, System.Windows.Forms.TextFormatFlags flags);

static member DrawText : System.Drawing.IDeviceContext * ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Rectangle * System.Drawing.Color * System.Windows.Forms.TextFormatFlags -> unit

Public Shared Sub DrawText (dc As IDeviceContext, text As ReadOnlySpan(Of Char), font As Font, bounds As Rectangle, foreColor As Color, flags As TextFormatFlags)