TextRenderer.DrawText Método

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.

Desenha o texto especificado no local especificado usando o contexto de dispositivo, a fonte e a cor especificados.

Sobrecargas

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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, Rectangle, Color)	Desenha o texto especificado nos limites especificados usando o contexto, a fonte e a cor do dispositivo 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, 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, 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.

Comentários

A renderização de texto oferecida pela TextRenderer classe é baseada na renderização de texto GDI e não tem suporte para impressão de Windows Forms. Em vez disso, use os DrawString métodos da Graphics classe .

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

Desenha o texto especificado no local especificado usando o contexto de dispositivo, fonte e cor especificados.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

Exceções

ArgumentNullException

dc é null.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

O Color a ser aplicado ao texto.

backColor: Color

O Color a ser aplicado à área representada por bounds.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

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 RenderText8 do manipulador de eventos do Paint formulário, passando 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

Comentários

O backcolor parâmetro é aplicado à área dentro do bounds parâmetro. If font, forecolor or backcolor is null ou Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

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).

O TextRenderer não dá suporte à adição de paradas de tabulação ao texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs sinalizador .

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

O Color a ser aplicado ao texto.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

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 RenderText7 do manipulador de eventos do Paint formulário, passando 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

Comentários

O backcolor parâmetro é aplicado à área retangular que contém o texto desenhado. Se font ou forecolor for null ou Empty, respectivamente, o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

O TextRenderer não dá suporte à adição de paradas de tabulação ao texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs sinalizador .

Nota

Os DrawText métodos que especificam um Point como o canto superior esquerdo do texto desenhado não são renderizados corretamente no Windows 2000. Se seu aplicativo se destina a ser usado em computadores que executam o Windows 2000, você deve usar um dos DrawText métodos que especificam um Rectangle para os limites do texto desenhado.

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

ArgumentOutOfRangeException

ModifyString é definido.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

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 RenderText6 do manipulador de eventos do Paint formulário, passando 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

Comentários

Se font ou color for null ou Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

O TextRenderer não dá suporte à adição de paradas de tabulação para o texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs sinalizador .

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

O Color a ser aplicado à área representada por bounds.

Exceções

ArgumentNullException

dc é null.

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 RenderText4 do manipulador de eventos do Paint formulário, passando 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

Comentários

O backColor parâmetro é aplicado à área dentro do bounds parâmetro . Se font, backcolor ou forecolor for null ou Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

Esse método resultará em texto centralizado horizontal e verticalmente no retângulo especificado pelo bounds parâmetro . Para alterar a forma como o texto é desenhado, use uma versão do que usa um TextFormatFlags tipo de DrawText parâmetro.

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

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 RenderText5 do manipulador de eventos do Paint formulário, passando 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

Comentários

O backColor parâmetro é aplicado à área dentro do bounds parâmetro . Se font ou forecolor for null ou Color.Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

O TextRenderer não dá suporte à adição de paradas de tabulação para o texto desenhado, embora você possa expandir as paradas de tabulação existentes usando o ExpandTabs sinalizador .

Nota

Os DrawText métodos que especificam um Point como o canto superior esquerdo do texto desenhado não são renderizados corretamente no Windows 2000. Se o aplicativo for destinado a ser usado em computadores que executam o Windows 2000, você deverá usar um dos DrawText métodos que especificam um Rectangle para os limites do texto desenhado.

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

Exceções

ArgumentNullException

dc é null.

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 RenderText3 do manipulador de eventos do Paint formulário, passando 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

Comentários

O backColor parâmetro é aplicado à área retangular que contém o texto desenhado. Se font, backcolor ou forecolor for null ou Color.Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

Você pode manipular como o texto é desenhado usando uma das sobrecargas DrawText que usa um parâmetro TextFormatFlags.

Nota

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

ArgumentOutOfRangeException

ModifyString é definido.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

Exceções

ArgumentNullException

dc é null.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

ArgumentOutOfRangeException

ModifyString é definido.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

backColor: Color

A Color a ser aplicada à área de tela de fundo do texto desenhado.

Exceções

ArgumentNullException

dc é null.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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

Desenha o texto especificado nos limites especificados usando o contexto, a fonte e a cor do dispositivo especificados.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

Exceções

ArgumentNullException

dc é null.

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 RenderText2 do manipulador de eventos do Paint formulário, passando 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

Comentários

Se font ou forecolor for null ou Color.Empty, respectivamente; o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

Confira também

IDeviceContext

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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

Desenha o texto especificado no local especificado usando o contexto de dispositivo, fonte e cor especificados.

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

O contexto de dispositivo no qual desenhar o texto.

text: String

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

pt: Point

O Point que representa o canto superior esquerdo do texto desenhado.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

Exceções

ArgumentNullException

dc é null.

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

Você pode manipular como o texto é desenhado usando uma das sobrecargas DrawText que usa um parâmetro TextFormatFlags.

Se font for null ou forecolor for Color.Empty, o DrawText método desenhará o texto na fonte ou cor atualmente selecionada no contexto do dispositivo especificado por dc. Se forecolor for Transparent, o texto não será desenhado.

Nota

Confira também

IDeviceContext

Aplica-se a

.NET Framework 4.8.1 e outras versões

Produto	Versões
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

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.

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

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

Exceções

ArgumentNullException

dc é null.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

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.

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)

Parâmetros

dc: IDeviceContext

O contexto de dispositivo no qual desenhar o texto.

text: ReadOnlySpan<Char>

O texto a ser desenhado.

font: Font

A Font a ser aplicada ao texto desenhado.

bounds: Rectangle

O Rectangle que representa os limites do texto.

foreColor: Color

A Color a ser aplicada ao texto desenhado.

flags: TextFormatFlags

Uma combinação bit a bit dos valores TextFormatFlags.

Exceções

ArgumentNullException

dc é null.

ArgumentOutOfRangeException

ModifyString é definido.

Aplica-se a

Windows Desktop 9 e outras versões

Produto	Versões
Windows Desktop	5, 6, 7, 8, 9

Partilhar via

TextRenderer.DrawText Método

Definição

Sobrecargas

Comentários

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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