TextRenderer.DrawText Método

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

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

Exceções

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 Windows e chame RenderText1 do manipulador de eventos Paint do 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 DrawText sobrecargas que usa um TextFormatFlags parâmetro.

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.

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

Confira também

• IDeviceContext

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

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

Exceções

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 Windows e chame RenderText2 do manipulador de eventos Paint do 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.

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 que usa um TextFormatFlags tipo de DrawText parâmetro.

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

Confira também

• IDeviceContext

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

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

Exceções

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 Windows e chame RenderText3 do manipulador de eventos Paint do 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 DrawText sobrecargas que usa um TextFormatFlags parâmetro.

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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

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

Exceções

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 Windows e chame RenderText5 do manipulador de eventos Paint do 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

Você pode manipular como o texto é desenhado usando uma das DrawText sobrecargas que usa um TextFormatFlags parâmetro. Por exemplo, o comportamento padrão é TextRenderer adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos pendentes. 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 e TextFormatFlags um Size parâmetro. Para obter um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

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.

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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.

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

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

Exceções

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 Windows e chame RenderText4 do manipulador de eventos Paint do 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 que usa um TextFormatFlags tipo de DrawText parâmetro.

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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

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

Exceções

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 Windows e chame RenderText6 do manipulador de eventos Paint do 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.

Você pode manipular como o texto é desenhado usando uma das DrawText sobrecargas que usa um TextFormatFlags parâmetro. Por exemplo, o comportamento padrão é TextRenderer adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos pendentes. 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 e TextFormatFlags um Size parâmetro. Para obter um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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.

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

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

Exceções

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 Windows e chame RenderText7 do manipulador de eventos Paint do 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.

Você pode manipular como o texto é desenhado usando uma das DrawText sobrecargas que usa um TextFormatFlags parâmetro. Por exemplo, o comportamento padrão é TextRenderer adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos pendentes. 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 e TextFormatFlags um Size parâmetro. Para obter um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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.

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

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

Exceções

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 Windows e chame RenderText8 do manipulador de eventos Paint do 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 DrawText sobrecargas que usa um TextFormatFlags parâmetro. Por exemplo, o comportamento padrão é TextRenderer adicionar preenchimento ao retângulo delimitador do texto desenhado para acomodar glifos pendentes. 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 e TextFormatFlags um Size parâmetro. Para obter um exemplo, consulte MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags).

A renderização de texto oferecida pela classe TextRenderer baseia-se 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.

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.