Graphics.DrawString Método

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v8.0.7

Pacote:: System.Drawing.Common v9.0.0-preview.6.24327.6

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 a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.

Sobrecargas

DrawString(String, Font, Brush, Single, Single, StringFormat)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.
DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single, StringFormat)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.
DrawString(String, Font, Brush, Single, Single)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.
DrawString(String, Font, Brush, RectangleF, StringFormat)	Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.
DrawString(String, Font, Brush, PointF, StringFormat)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.
DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.
DrawString(ReadOnlySpan<Char>, Font, Brush, PointF, StringFormat)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.
DrawString(String, Font, Brush, RectangleF)	Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados.
DrawString(String, Font, Brush, PointF)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.
DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF)	Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados.
DrawString(ReadOnlySpan<Char>, Font, Brush, PointF)	Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.
DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat)	Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

DrawString(String, Font, Brush, Single, Single, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y, System::Drawing::StringFormat ^ format);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat? format);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat format);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, x As Single, y As Single, format As StringFormat)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

x: Single

A coordenada x do canto superior esquerdo do texto desenhado.

y: Single

A coordenada y do canto superior esquerdo do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto e sólido com o qual desenhar.
Cria as coordenadas de um ponto para o canto superior esquerdo no qual desenhar o texto.
Define o formato da cadeia de caracteres a ser desenhada verticalmente
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel, o ponto de destino e o formato.

public:
   void DrawStringFloatFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      float x = 150.0F;
      float y = 50.0F;

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->FormatFlags = StringFormatFlags::DirectionVertical;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, x, y, drawFormat );
   }

public void DrawStringFloatFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    float x = 150.0F;
    float y =  50.0F;
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y, drawFormat);
}

Public Sub DrawStringFloatFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 50.0F

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    x, y, drawFormat)
End Sub

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y, System::Drawing::StringFormat ^ format);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y, System.Drawing.StringFormat? format);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, x As Single, y As Single, format As StringFormat)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

x: Single

A coordenada x do canto superior esquerdo do texto desenhado.

y: Single

A coordenada y do canto superior esquerdo do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

DrawString(String, Font, Brush, Single, Single)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, x As Single, y As Single)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

x: Single

A coordenada x do canto superior esquerdo do texto desenhado.

y: Single

A coordenada y do canto superior esquerdo do texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto sólido com o qual desenhar.
Cria um ponto para o canto superior esquerdo no qual desenhar o texto.
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel e o ponto de destino.

public:
   void DrawStringFloat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      float x = 150.0F;
      float y = 150.0F;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, x, y );
   }

public void DrawStringFloat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    float x = 150.0F;
    float y = 150.0F;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y);
}

Public Sub DrawStringFloat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, x, y)
End Sub

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(String, Font, Brush, RectangleF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle, System::Drawing::StringFormat ^ format);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat? format);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat format);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, layoutRectangle As RectangleF, format As StringFormat)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

layoutRectangle: RectangleF

RectangleF estrutura que especifica o local do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto e sólido com o qual desenhar.
Cria um retângulo no qual desenhar o texto.
Desenha o retângulo para a tela.
Define o formato da cadeia de caracteres para centralizar dentro do retângulo.
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel e o retângulo de destino.

public:
   void DrawStringRectangleFFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create rectangle for drawing.
      float x = 150.0F;
      float y = 150.0F;
      float width = 200.0F;
      float height = 50.0F;
      RectangleF drawRect = RectangleF(x,y,width,height);

      // Draw rectangle to screen.
      Pen^ blackPen = gcnew Pen( Color::Black );
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->Alignment = StringAlignment::Center;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawRect, drawFormat );
   }

public void DrawStringRectangleFFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create rectangle for drawing.
    float x = 150.0F;
    float y = 150.0F;
    float width = 200.0F;
    float height = 50.0F;
    RectangleF drawRect = new RectangleF(x, y, width, height);
             
    // Draw rectangle to screen.
    Pen blackPen = new Pen(Color.Black);
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.Alignment = StringAlignment.Center;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect, drawFormat);
}

Public Sub DrawStringRectangleFFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create rectangle for drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F
    Dim width As Single = 200.0F
    Dim height As Single = 50.0F
    Dim drawRect As New RectangleF(x, y, width, height)

    ' Draw rectangle to screen.
    Dim blackPen As New Pen(Color.Black)
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.Alignment = StringAlignment.Center

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    drawRect, drawFormat)
End Sub

Comentários

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(String, Font, Brush, PointF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point, System::Drawing::StringFormat ^ format);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat? format);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat format);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, point As PointF, format As StringFormat)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

point: PointF

PointF estrutura que especifica o canto superior esquerdo do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto e sólido com o qual desenhar.
Cria um ponto para o canto superior esquerdo no qual desenhar o texto.
Define o formato da cadeia de caracteres a ser desenhada verticalmente.
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel, o ponto de destino e o formato.

public:
   void DrawStringPointFFormat( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      PointF drawPoint = PointF(150.0F,50.0F);

      // Set format of string.
      StringFormat^ drawFormat = gcnew StringFormat;
      drawFormat->FormatFlags = StringFormatFlags::DirectionVertical;

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawPoint, drawFormat );
   }

public void DrawStringPointFFormat(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    PointF drawPoint = new PointF(150.0F, 50.0F);
             
    // Set format of string.
    StringFormat drawFormat = new StringFormat();
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical;
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint, drawFormat);
}

Public Sub DrawStringPointFFormat(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim drawPoint As New PointF(150.0F, 50.0F)

    ' Set format of string.
    Dim drawFormat As New StringFormat
    drawFormat.FormatFlags = StringFormatFlags.DirectionVertical

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, _
    drawPoint, drawFormat)
End Sub

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, float x, float y);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, float x, float y);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * single * single -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, x As Single, y As Single)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

x: Single

A coordenada x do canto superior esquerdo do texto desenhado.

y: Single

A coordenada y do canto superior esquerdo do texto desenhado.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point, System::Drawing::StringFormat ^ format);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point, System.Drawing.StringFormat? format);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, point As PointF, format As StringFormat)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

point: PointF

PointF estrutura que especifica o canto superior esquerdo do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

DrawString(String, Font, Brush, RectangleF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, layoutRectangle As RectangleF)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

layoutRectangle: RectangleF

RectangleF estrutura que especifica o local do texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto e sólido com o qual desenhar.
Cria um retângulo no qual desenhar o texto.
Desenha o retângulo para a tela.
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel e o retângulo de destino.

public:
   void DrawStringRectangleF( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create rectangle for drawing.
      float x = 150.0F;
      float y = 150.0F;
      float width = 200.0F;
      float height = 50.0F;
      RectangleF drawRect = RectangleF(x,y,width,height);

      // Draw rectangle to screen.
      Pen^ blackPen = gcnew Pen( Color::Black );
      e->Graphics->DrawRectangle( blackPen, x, y, width, height );

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawRect );
   }

public void DrawStringRectangleF(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create rectangle for drawing.
    float x = 150.0F;
    float y = 150.0F;
    float width = 200.0F;
    float height = 50.0F;
    RectangleF drawRect = new RectangleF(x, y, width, height);
             
    // Draw rectangle to screen.
    Pen blackPen = new Pen(Color.Black);
    e.Graphics.DrawRectangle(blackPen, x, y, width, height);
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect);
}

Public Sub DrawStringRectangleF(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create rectangle for drawing.
    Dim x As Single = 150.0F
    Dim y As Single = 150.0F
    Dim width As Single = 200.0F
    Dim height As Single = 50.0F
    Dim drawRect As New RectangleF(x, y, width, height)

    ' Draw rectangle to screen.
    Dim blackPen As New Pen(Color.Black)
    e.Graphics.DrawRectangle(blackPen, x, y, width, height)

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawRect)
End Sub

Comentários

O texto representado pelo parâmetro s é desenhado dentro do retângulo representado pelo parâmetro layoutRectangle. Se o texto não se ajustar dentro do retângulo, ele será truncado na palavra mais próxima. Para manipular ainda mais como a cadeia de caracteres é desenhada dentro do retângulo, use a sobrecarga de DrawString que usa um StringFormat.

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(String, Font, Brush, PointF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.

public:
 void DrawString(System::String ^ s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point);

public void DrawString (string? s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);

public void DrawString (string s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);

member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit

Public Sub DrawString (s As String, font As Font, brush As Brush, point As PointF)

Parâmetros

s: String

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

point: PointF

PointF estrutura que especifica o canto superior esquerdo do texto desenhado.

Exceções

ArgumentNullException

brush é null.

-ou-

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

Cria uma cadeia de caracteres de texto a ser desenhada.
Define a fonte como Arial (16pt).
Cria um pincel preto e sólido com o qual desenhar.
Cria um ponto para o canto superior esquerdo no qual desenhar o texto.
Desenha a cadeia de caracteres para a tela usando a fonte, o pincel e o ponto de destino.

public:
   void DrawStringPointF( PaintEventArgs^ e )
   {
      // Create string to draw.
      String^ drawString = "Sample Text";

      // Create font and brush.
      System::Drawing::Font^ drawFont = gcnew System::Drawing::Font( "Arial",16 );
      SolidBrush^ drawBrush = gcnew SolidBrush( Color::Black );

      // Create point for upper-left corner of drawing.
      PointF drawPoint = PointF(150.0F,150.0F);

      // Draw string to screen.
      e->Graphics->DrawString( drawString, drawFont, drawBrush, drawPoint );
   }

public void DrawStringPointF(PaintEventArgs e)
{
             
    // Create string to draw.
    String drawString = "Sample Text";
             
    // Create font and brush.
    Font drawFont = new Font("Arial", 16);
    SolidBrush drawBrush = new SolidBrush(Color.Black);
             
    // Create point for upper-left corner of drawing.
    PointF drawPoint = new PointF(150.0F, 150.0F);
             
    // Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint);
}

Public Sub DrawStringPointF(ByVal e As PaintEventArgs)

    ' Create string to draw.
    Dim drawString As [String] = "Sample Text"

    ' Create font and brush.
    Dim drawFont As New Font("Arial", 16)
    Dim drawBrush As New SolidBrush(Color.Black)

    ' Create point for upper-left corner of drawing.
    Dim drawPoint As New PointF(150.0F, 150.0F)

    ' Draw string to screen.
    e.Graphics.DrawString(drawString, drawFont, drawBrush, drawPoint)
End Sub

Confira também

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	6, 7, 8, 9
.NET Framework	1.1, 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
.NET Standard	2.0
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, layoutRectangle As RectangleF)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

layoutRectangle: RectangleF

RectangleF estrutura que especifica o local do texto desenhado.

Comentários

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no local especificado com os objetos Brush e Font especificados.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::PointF point);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.PointF point);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, point As PointF)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

point: PointF

PointF estrutura que especifica o canto superior esquerdo do texto desenhado.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Desenha a cadeia de caracteres de texto especificada no retângulo especificado com os objetos Brush e Font especificados usando os atributos de formatação do StringFormatespecificado.

public:
 void DrawString(ReadOnlySpan<char> s, System::Drawing::Font ^ font, System::Drawing::Brush ^ brush, System::Drawing::RectangleF layoutRectangle, System::Drawing::StringFormat ^ format);

public void DrawString (ReadOnlySpan<char> s, System.Drawing.Font font, System.Drawing.Brush brush, System.Drawing.RectangleF layoutRectangle, System.Drawing.StringFormat? format);

member this.DrawString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit

Public Sub DrawString (s As ReadOnlySpan(Of Char), font As Font, brush As Brush, layoutRectangle As RectangleF, format As StringFormat)

Parâmetros

s: ReadOnlySpan<Char>

Cadeia de caracteres a ser desenhada.

font: Font

Font que define o formato de texto da cadeia de caracteres.

brush: Brush

Brush que determina a cor e a textura do texto desenhado.

layoutRectangle: RectangleF

RectangleF estrutura que especifica o local do texto desenhado.

format: StringFormat

StringFormat que especifica atributos de formatação, como espaçamento e alinhamento de linha, que são aplicados ao texto desenhado.

Aplica-se a

.NET 9 e outras versões

Produto	Versões
.NET	8, 9
Windows Desktop	8, 9

Compartilhar via

Graphics.DrawString Método

Definição

Sobrecargas

DrawString(String, Font, Brush, Single, Single, StringFormat)

Parâmetros

Exceções

Exemplos

Confira também

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single, StringFormat)

Parâmetros

Aplica-se a

DrawString(String, Font, Brush, Single, Single)

Parâmetros

Exceções

Exemplos

Confira também

Aplica-se a

DrawString(String, Font, Brush, RectangleF, StringFormat)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DrawString(String, Font, Brush, PointF, StringFormat)

Parâmetros

Exceções

Exemplos

Confira também

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, Single, Single)

Parâmetros

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF, StringFormat)

Parâmetros

Aplica-se a

DrawString(String, Font, Brush, RectangleF)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DrawString(String, Font, Brush, PointF)

Parâmetros

Exceções

Exemplos

Confira também

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF)

Parâmetros

Comentários

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, PointF)

Parâmetros

Aplica-se a

DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat)

Parâmetros

Aplica-se a

Recursos adicionais