Graphics.DrawString Método

Definição

Desenha a cadeia 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 texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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

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

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

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

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

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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

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

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

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

DrawString(String, Font, Brush, RectangleF)

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

DrawString(String, Font, Brush, PointF)

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

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

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

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

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

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

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

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

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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 extraída.

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 extraído.

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 os atributos de formatação, como espaçamento de linha e alinhamento, que são aplicados ao texto desenhado.

Exceções

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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 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

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

Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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 extraída.

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 extraído.

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 os atributos de formatação, como espaçamento de linha e alinhamento, que são aplicados ao texto desenhado.

Aplica-se a

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

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

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

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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 para 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

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

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

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

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 extraída.

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 extraído.

layoutRectangle
RectangleF

Estrutura RectangleF que especifica o local do texto extraído.

format
StringFormat

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

Exceções

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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 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

O texto representado pelo s parâmetro é desenhado dentro do retângulo representado pelo layoutRectangle parâmetro . Se o texto não se ajustar dentro do retângulo, ele será truncado na palavra mais próxima, a menos que seja especificado de outra forma com o format parâmetro .

Confira também

Aplica-se a

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

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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 extraída.

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 extraído.

point
PointF

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

format
StringFormat

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

Exceções

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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.

  • Define o formato da cadeia de caracteres a ser desenhada verticalmente.

  • Desenha a cadeia de caracteres na 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

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

Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

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

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

Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia de texto especificada na localização com os objetos Brush e Font especificados usando os atributos de formatação do StringFormat especificado.

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 extraída.

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 extraído.

point
PointF

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

format
StringFormat

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

Aplica-se a

DrawString(String, Font, Brush, RectangleF)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

layoutRectangle
RectangleF

Estrutura RectangleF que especifica o local do texto extraído.

Exceções

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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 retângulo no qual desenhar o texto.

  • Desenha o retângulo na tela.

  • Desenha a cadeia de caracteres na 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 s parâmetro é desenhado dentro do retângulo representado pelo layoutRectangle parâmetro . 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 DrawString sobrecarga que usa um StringFormat.

Confira também

Aplica-se a

DrawString(String, Font, Brush, PointF)

Origem:
Graphics.cs
Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

point
PointF

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

Exceções

brush é null.

- ou -

s é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. 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 na 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

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

Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

layoutRectangle
RectangleF

Estrutura RectangleF que especifica o local do texto extraído.

Comentários

O texto representado pelo s parâmetro é desenhado dentro do retângulo representado pelo layoutRectangle parâmetro . 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 DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat) sobrecarga que usa um StringFormat.

Aplica-se a

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

Origem:
Graphics.cs
Origem:
Graphics.cs

Desenha a cadeia 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 extraída.

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 extraído.

point
PointF

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

Aplica-se a

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

Origem:
Graphics.cs
Origem:
Graphics.cs

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

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 extraída.

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 extraído.

layoutRectangle
RectangleF

Estrutura RectangleF que especifica o local do texto extraído.

format
StringFormat

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

Aplica-se a