Graphics.DrawString Graphics.DrawString Graphics.DrawString Method

Definición

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.Draws the specified text string at the specified location with the specified Brush and Font objects.

Sobrecargas

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

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Dibuja la cadena de texto especificada en el rectángulo que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string in the specified rectangle with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.Draws the specified text string at the specified location with the specified Brush and Font objects.

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

Dibuja la cadena de texto especificada en el rectángulo especificado y con los objetos Brush y Font igualmente especificados.Draws the specified text string in the specified rectangle with the specified Brush and Font objects.

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.Draws the specified text string at the specified location with the specified Brush and Font objects.

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

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single * System.Drawing.StringFormat -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

x
Single Single Single

Coordenada x de la esquina superior izquierda del texto dibujado.The x-coordinate of the upper-left corner of the drawn text.

y
Single Single Single

Coordenada y de la esquina superior izquierda del texto dibujado.The y-coordinate of the upper-left corner of the drawn text.

format
StringFormat StringFormat StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Excepciones

brush es null.brush is null.

o bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel sólido y negro para dibujar con.Creates a solid, black brush to draw with.

  • Crea las coordenadas de un punto para la esquina superior izquierda en la que se va a dibujar el texto.Creates the coordinates of a point for the upper-left corner at which to draw the text.

  • Establece el formato de la cadena que se va a dibujar verticalmente.Sets the format of the string to draw vertically

  • Dibuja la cadena en la pantalla con la fuente, el pincel, el punto de destino y el formato.Draws the string to the screen using the font, brush, destination point, and format.

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
Consulte también:

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

Dibuja la cadena de texto especificada en el rectángulo que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string in the specified rectangle with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF * System.Drawing.StringFormat -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

layoutRectangle
RectangleF RectangleF RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.RectangleF structure that specifies the location of the drawn text.

format
StringFormat StringFormat StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Excepciones

brush es null.brush is null.

O bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel sólido y negro para dibujar con.Creates a solid, black brush to draw with.

  • Crea un rectángulo en el que se va a dibujar el texto.Creates a rectangle in which to draw the text.

  • Dibuja el rectángulo en la pantalla.Draws the rectangle to the screen.

  • Establece el formato de la cadena para centrarla dentro del rectángulo.Sets the format of the string to center it within the rectangle.

  • Dibuja la cadena en la pantalla con la fuente, el pincel y el rectángulo de destino.Draws the string to the screen using the font, brush, and destination rectangle.

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

Comentarios

El texto representado por el s parámetro se dibuja dentro del rectángulo representado por el layoutRectangle parámetro.The text represented by the s parameter is drawn inside the rectangle represented by the layoutRectangle parameter. Si el texto no cabe dentro del rectángulo, se trunca en la palabra más cercana, a menos que se especifique lo contrario format con el parámetro.If the text does not fit inside the rectangle, it is truncated at the nearest word, unless otherwise specified with the format parameter.

Consulte también:

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.Draws the specified text string at the specified location with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * single * single -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

x
Single Single Single

Coordenada x de la esquina superior izquierda del texto dibujado.The x-coordinate of the upper-left corner of the drawn text.

y
Single Single Single

Coordenada y de la esquina superior izquierda del texto dibujado.The y-coordinate of the upper-left corner of the drawn text.

Excepciones

brush es null.brush is null.

o bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel negro sólido para dibujar con.Creates a solid black brush to draw with.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.Creates a point for the upper-left corner at which to draw the text.

  • Dibuja la cadena en la pantalla con la fuente, el pincel y el punto de destino.Draws the string to the screen using the font, brush, and destination point.

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
Consulte también:

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

Dibuja la cadena de texto especificada en el rectángulo especificado y con los objetos Brush y Font igualmente especificados.Draws the specified text string in the specified rectangle with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.RectangleF -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

layoutRectangle
RectangleF RectangleF RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.RectangleF structure that specifies the location of the drawn text.

Excepciones

brush es null.brush is null.

O bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel sólido y negro para dibujar con.Creates a solid, black brush to draw with.

  • Crea un rectángulo en el que se va a dibujar el texto.Creates a rectangle in which to draw the text.

  • Dibuja el rectángulo en la pantalla.Draws the rectangle to the screen.

  • Dibuja la cadena en la pantalla con la fuente, el pincel y el rectángulo de destino.Draws the string to the screen using the font, brush, and destination rectangle.

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

Comentarios

El texto representado por el s parámetro se dibuja dentro del rectángulo representado por el layoutRectangle parámetro.The text represented by the s parameter is drawn inside the rectangle represented by the layoutRectangle parameter. Si el texto no cabe dentro del rectángulo, se trunca en la palabra más cercana.If the text does not fit inside the rectangle, it is truncated at the nearest word. Para manipular mejor cómo se dibuja la cadena dentro del rectángulo, use la DrawString sobrecarga que StringFormattoma.To further manipulate how the string is drawn inside the rectangle use the DrawString overload that takes a StringFormat.

Consulte también:

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.Draws the specified text string at the specified location with the specified Brush and Font objects.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

point
PointF PointF PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.PointF structure that specifies the upper-left corner of the drawn text.

Excepciones

brush es null.brush is null.

o bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel sólido y negro para dibujar con.Creates a solid, black brush to draw with.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.Creates a point for the upper-left corner at which to draw the text.

  • Dibuja la cadena en la pantalla con la fuente, el pincel y el punto de destino.Draws the string to the screen using the font, brush, and destination point.

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
Consulte también:

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

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y utilizando los atributos de formato del StringFormat especificado.Draws the specified text string at the specified location with the specified Brush and Font objects using the formatting attributes of the specified StringFormat.

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);
member this.DrawString : string * System.Drawing.Font * System.Drawing.Brush * System.Drawing.PointF * System.Drawing.StringFormat -> unit

Parámetros

s
String String String

Cadena que se va a dibujar.String to draw.

font
Font Font Font

Font que define el formato de texto de la cadena.Font that defines the text format of the string.

brush
Brush Brush Brush

Brush que determina el color y la textura del texto dibujado.Brush that determines the color and texture of the drawn text.

point
PointF PointF PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.PointF structure that specifies the upper-left corner of the drawn text.

format
StringFormat StringFormat StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.StringFormat that specifies formatting attributes, such as line spacing and alignment, that are applied to the drawn text.

Excepciones

brush es null.brush is null.

O bien-or- s es null.s is null.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una cadena de texto que se va a dibujar.Creates a text string to draw.

  • Define la fuente como Arial (16 PT).Defines the font as Arial (16pt).

  • Crea un pincel sólido y negro para dibujar con.Creates a solid, black brush to draw with.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.Creates a point for the upper-left corner at which to draw the text.

  • Establece el formato de la cadena que se va a dibujar verticalmente.Sets the format of the string to draw vertically.

  • Dibuja la cadena en la pantalla con la fuente, el pincel, el punto de destino y el formato.Draws the string to the screen using the font, brush, destination point, and format.

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
Consulte también:

Se aplica a