Graphics.DrawString Método

Definición

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.

Sobrecargas

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 usando los atributos de formato del StringFormat especificado.

DrawString(ReadOnlySpan<Char>, 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 usando los atributos de formato del StringFormat especificado.

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.

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 usando los atributos de formato del StringFormat especificado.

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 usando los atributos de formato del StringFormat especificado.

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.

DrawString(ReadOnlySpan<Char>, 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 usando los atributos de formato del StringFormat especificado.

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.

DrawString(String, Font, Brush, PointF)

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.

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

Dibuja la cadena de texto especificada en el rectángulo especificado y con los objetos Brush y Font igualmente especificados.

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

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y Font especificados.

DrawString(ReadOnlySpan<Char>, 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 usando los atributos de formato del StringFormat especificado.

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

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

x
Single

Coordenada x de la esquina superior izquierda del texto dibujado.

y
Single

Coordenada y de la esquina superior izquierda del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel sólido y negro con el que dibujar.

  • Crea las coordenadas de un punto para la esquina superior izquierda en la que se va a dibujar el texto.

  • Establece el formato de la cadena que se va a dibujar verticalmente.

  • Dibuja la cadena en la pantalla con la fuente, el pincel, el punto de destino y el 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

Consulte también

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

x
Single

Coordenada x de la esquina superior izquierda del texto dibujado.

y
Single

Coordenada y de la esquina superior izquierda del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

x
Single

Coordenada x de la esquina superior izquierda del texto dibujado.

y
Single

Coordenada y de la esquina superior izquierda del texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel negro sólido con el que dibujar.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.

  • Dibuja la cadena en la pantalla mediante la fuente, el pincel y el punto 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

Consulte también

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en el rectángulo que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

layoutRectangle
RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel sólido y negro con el que dibujar.

  • Crea un rectángulo en el que se va a dibujar el texto.

  • Dibuja el rectángulo en la pantalla.

  • Establece el formato de la cadena para centrarla dentro del rectángulo.

  • Dibuja la cadena en la pantalla mediante el rectángulo de fuente, pincel y 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

Comentarios

El texto representado por el s parámetro se dibuja dentro del rectángulo representado por el layoutRectangle parámetro . Si el texto no cabe dentro del rectángulo, se trunca en la palabra más cercana, a menos que se especifique lo contrario con el format parámetro .

Consulte también

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

point
PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel sólido y negro con el que dibujar.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.

  • Establece el formato de la cadena que se va a dibujar verticalmente.

  • Dibuja la cadena en la pantalla mediante la fuente, el pincel, el punto de destino y el 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

Consulte también

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

x
Single

Coordenada x de la esquina superior izquierda del texto dibujado.

y
Single

Coordenada y de la esquina superior izquierda del texto dibujado.

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

point
PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Se aplica a

DrawString(String, Font, Brush, RectangleF)

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en el rectángulo especificado y con los objetos Brush y Font igualmente 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

layoutRectangle
RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel sólido y negro con el que dibujar.

  • Crea un rectángulo en el que se va a dibujar el texto.

  • Dibuja el rectángulo en la pantalla.

  • Dibuja la cadena en la pantalla mediante el rectángulo de fuente, pincel y 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

Comentarios

El texto representado por el s parámetro se dibuja dentro del rectángulo representado por el layoutRectangle parámetro . Si el texto no cabe dentro del rectángulo, se trunca en la palabra más cercana. Para manipular aún más cómo se dibuja la cadena dentro del rectángulo, use la DrawString sobrecarga que toma .StringFormat

Consulte también

Se aplica a

DrawString(String, Font, Brush, PointF)

Source:
Graphics.cs
Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y 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

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

point
PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.

Excepciones

brush es null.

O bien

s es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código realiza las siguientes acciones:

  • Crea una cadena de texto que se va a dibujar.

  • Define la fuente como Arial (16pt).

  • Crea un pincel sólido y negro con el que dibujar.

  • Crea un punto para la esquina superior izquierda en la que se va a dibujar el texto.

  • Dibuja la cadena en la pantalla mediante la fuente, el pincel y el punto 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

Consulte también

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en el rectángulo especificado y con los objetos Brush y Font igualmente 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

layoutRectangle
RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.

Comentarios

El texto representado por el s parámetro se dibuja dentro del rectángulo representado por el layoutRectangle parámetro . Si el texto no cabe dentro del rectángulo, se trunca en la palabra más cercana. Para manipular aún más cómo se dibuja la cadena dentro del rectángulo, use la DrawString(ReadOnlySpan<Char>, Font, Brush, RectangleF, StringFormat) sobrecarga que toma .StringFormat

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en la ubicación especificada y con los objetos Brush y 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

point
PointF

Estructura PointF que especifica la esquina superior izquierda del texto dibujado.

Se aplica a

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

Source:
Graphics.cs
Source:
Graphics.cs

Dibuja la cadena de texto especificada en el rectángulo que se indique, con los objetos Brush y Font dados y usando los atributos de formato del 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>

Cadena que se va a dibujar.

font
Font

Font que define el formato de texto de la cadena.

brush
Brush

Brush que determina el color y la textura del texto dibujado.

layoutRectangle
RectangleF

Estructura RectangleF que especifica la ubicación del texto dibujado.

format
StringFormat

StringFormat que especifica los atributos de formato, como el espaciado de líneas y la alineación, que se aplican al texto dibujado.

Se aplica a