Graphics.MeasureString Método

Referencia

Definición

Espacio de nombres:: System.Drawing

Ensamblado:: System.Drawing.Common.dll

Ensamblado:: System.Drawing.dll

Paquete:: System.Drawing.Common v8.0.0

Paquete:: System.Drawing.Common v9.0.0-preview.2.24128.3

Paquete:: System.Drawing.Common v6.0.0

Paquete:: System.Drawing.Common v7.0.0

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Mide la cadena especificada al dibujarla con la Font especificada.

Sobrecargas

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(ReadOnlySpan<Char>, Font)	Mide la cadena especificada al dibujarla con la Font especificada.
MeasureString(String, Font)	Mide la cadena especificada al dibujarla con la Font especificada.
MeasureString(ReadOnlySpan<Char>, Font, SizeF)	Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.
MeasureString(ReadOnlySpan<Char>, Font, Int32)	Mide la cadena especificada al dibujarla con la Font especificada.
MeasureString(String, Font, SizeF)	Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.
MeasureString(String, Font, Int32)	Mide la cadena especificada al dibujarla con la Font especificada.
MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(String, Font, PointF, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(String, Font, SizeF, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(String, Font, Int32, StringFormat)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.
MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)	Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF, stringFormat As StringFormat) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Este método devuelve una estructura SizeF que representa el tamaño, en las unidades especificadas por la propiedad PageUnit, de la cadena especificada por el parámetro text que se dibuja con los parámetros font y stringFormat.

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

Devoluciones

SizeF

Se aplica a

MeasureString(String, Font)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font);

member this.MeasureString : string * System.Drawing.Font -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

ArgumentNullException

font 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 que se va a medir.
Crea un objeto de fuente y lo establece en Arial (16 puntos).
Crea un objeto de tamaño y lo usa y el objeto de fuente para medir el tamaño de la cadena.
Dibuja un rectángulo rojo con el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

public:
   void MeasureStringMin( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0) );
   }

private void MeasureStringMin(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Private Sub MeasureStringMin(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub

Comentarios

El MeasureString método está diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena para permitir glifos salientes. Además, el DrawString método ajusta los puntos de glifo para optimizar la calidad de la pantalla y podría mostrar una cadena más estrecha que la notificada por MeasureString. Para obtener métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con formato), use el MeasureCharacterRanges método o uno de los MeasureString métodos que toman y StringFormatpasan GenericTypographic. Además, asegúrese de que para TextRenderingHint Graphics es AntiAlias.

Consulte también

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

Devoluciones

SizeF

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, int width);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * int -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, width As Integer) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de la cadena.

width: Int32

Ancho máximo de la cadena en píxeles.

Devoluciones

SizeF

Se aplica a

MeasureString(String, Font, SizeF)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);

member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, layoutArea As SizeF) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos).
Establece el tamaño de diseño máximo de la cadena.
Crea un objeto de tamaño y lo usa, el objeto de fuente y el tamaño de diseño máximo para medir el tamaño de la cadena.
Dibuja un rectángulo rojo con el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

public:
   void MeasureStringSizeF( PaintEventArgs^ e )
   {

      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set maximum layout size.
      SizeF layoutSize = SizeF(200.0F,50.0F);

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, layoutSize );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0) );
   }

private void MeasureStringSizeF(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(200.0F, 50.0F);

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Private Sub MeasureStringSizeF(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New SizeF(200.0F, 50.0F)

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub

Comentarios

Consulte también

Se aplica a

MeasureString(String, Font, Int32)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font especificada.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, int width);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width);

member this.MeasureString : string * System.Drawing.Font * int -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, width As Integer) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de la cadena.

width: Int32

Ancho máximo de la cadena en píxeles.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos).
Establece el ancho máximo de la cadena.
Crea un objeto de tamaño y lo usa, el objeto de fuente y el ancho máximo de cadena para medir el tamaño de la cadena.
Dibuja un rectángulo rojo con el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

public:
   void MeasureStringWidth( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set maximum width of string.
      int stringWidth = 200;

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, stringWidth );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0) );
   }

private void MeasureStringWidth(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 200;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0));
}

Private Sub MeasureStringWidth(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set maximum width of string.
    Dim stringWidth As Integer = 200

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, _
    stringFont, stringWidth)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0))
End Sub

Comentarios

El width parámetro especifica el valor máximo del componente de ancho de la estructura devuelta SizeF (Width). Si el width parámetro es menor que el ancho real de la cadena, el componente devuelto Width se trunca en un valor que representa el número máximo de caracteres que caberán dentro del ancho especificado. Para dar cabida a toda la cadena, el componente devuelto Height se ajusta a un valor que permite mostrar la cadena con ajuste de caracteres.

Consulte también

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::PointF origin, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.PointF * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, origin As PointF, stringFormat As StringFormat) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

origin: PointF

Estructura PointF que representa la esquina superior izquierda de la cadena.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, int width, System::Drawing::StringFormat ^ format);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * int * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, width As Integer, format As StringFormat) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

width: Int32

Ancho máximo de la cadena.

format: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Se aplica a

MeasureString(String, Font, PointF, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::PointF origin, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat stringFormat);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);

member this.MeasureString : string * System.Drawing.Font * System.Drawing.PointF * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, origin As PointF, stringFormat As StringFormat) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

origin: PointF

Estructura PointF que representa la esquina superior izquierda de la cadena.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos)
Crea un punto para buscar la esquina superior izquierda de la cadena.
Crea un objeto de formato de cadena y establece sus marcas de formato en DirectionVertical.
Crea un objeto size para medir la cadena.
Mide el tamaño de la cadena, utilizando la cadena, el objeto de fuente, el punto de búsqueda y el formato de cadena.
Dibuja un rectángulo rojo utilizando el punto de búsqueda y el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

El resultado es un rectángulo vertical que incluye una cadena vertical.

public:
   void MeasureStringPointFFormat( PaintEventArgs^ e )
   {

      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set point for upper-left corner of string.
      float x = 50.0F;
      float y = 50.0F;
      PointF ulCorner = PointF(x,y);

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

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, ulCorner, newStringFormat );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), x, y, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, ulCorner, newStringFormat );
   }

private void MeasureStringPointFFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set point for upper-left corner of string.
    float x = 50.0F;
    float y = 50.0F;
    PointF ulCorner = new PointF(x, y);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, ulCorner, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), x, y, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, ulCorner, newStringFormat);
}

Private Sub MeasureStringPointFFormat(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set point for upper-left corner of string.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim ulCorner As New PointF(x, y)

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

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    ulCorner, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), x, y, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    ulCorner, newStringFormat)
End Sub

Comentarios

Consulte también

Se aplica a

MeasureString(String, Font, SizeF, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);

member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, layoutArea As SizeF, stringFormat As StringFormat) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos).
Establece el tamaño de diseño máximo de la cadena, creando un objeto size para medir la cadena.
Crea un objeto de formato de cadena y establece sus marcas de formato en DirectionVertical.
Mide el tamaño de la cadena, utilizando la cadena, el objeto de fuente, el tamaño de diseño máximo y el formato de cadena.
Dibuja un rectángulo rojo con el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

El resultado es un rectángulo vertical que incluye una cadena vertical.

public:
   void MeasureStringSizeFFormat( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set maximum layout size.
      SizeF layoutSize = SizeF(100.0F,200.0F);

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

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, layoutSize, newStringFormat );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0), newStringFormat );
   }

private void MeasureStringSizeFFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}

Private Sub MeasureStringSizeFFormat(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New SizeF(100.0F, 200.0F)

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

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)
End Sub

Comentarios

Consulte también

Se aplica a

MeasureString(String, Font, Int32, StringFormat)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, int width, System::Drawing::StringFormat ^ format);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width, System.Drawing.StringFormat format);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);

member this.MeasureString : string * System.Drawing.Font * int * System.Drawing.StringFormat -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, width As Integer, format As StringFormat) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

width: Int32

Ancho máximo de la cadena.

format: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos).
Establece el ancho máximo de la cadena.
Crea un objeto de formato de cadena y establece sus marcas de formato en DirectionVertical.
Crea un objeto size para medir la cadena.
Mide el tamaño de la cadena, utilizando la cadena, el objeto de fuente, el ancho máximo y el formato de cadena.
Dibuja un rectángulo rojo con el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.

El resultado es un rectángulo vertical que incluye una cadena vertical.

public:
   void MeasureStringWidthFormat( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set maximum width of string.
      int stringWidth = 100;

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

      // Measure string.
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, stringWidth, newStringFormat );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0), newStringFormat );
   }

private void MeasureStringWidthFormat(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum width of string.
    int stringWidth = 100;

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, stringWidth, newStringFormat);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}

Private Sub MeasureStringWidthFormat(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set maximum width of string.
    Dim stringWidth As Integer = 100

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

    ' Measure string.
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    stringWidth, newStringFormat)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)
End Sub

Comentarios

Consulte también

Se aplica a

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat, [Runtime::InteropServices::Out] int % charactersFitted, [Runtime::InteropServices::Out] int % linesFilled);

public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);

member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat * int * int -> System.Drawing.SizeF

Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF, stringFormat As StringFormat, ByRef charactersFitted As Integer, ByRef linesFilled As Integer) As SizeF

Parámetros

text: ReadOnlySpan<Char>

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

charactersFitted: Int32

Número de caracteres que contiene la cadena.

linesFilled: Int32

Número de líneas de texto que contiene la cadena.

Devoluciones

SizeF

Se aplica a

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)

Source:: Graphics.cs

Source:: Graphics.cs

Source:: Graphics.cs

Mide la cadena especificada al dibujarla con la Font que se indique y darle formato con el StringFormat señalado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat, [Runtime::InteropServices::Out] int % charactersFitted, [Runtime::InteropServices::Out] int % linesFilled);

public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat, out int charactersFitted, out int linesFilled);

public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);

member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat * int * int -> System.Drawing.SizeF

Public Function MeasureString (text As String, font As Font, layoutArea As SizeF, stringFormat As StringFormat, ByRef charactersFitted As Integer, ByRef linesFilled As Integer) As SizeF

Parámetros

text: String

Cadena que se va a medir.

font: Font

Font que define el formato de texto de la cadena.

layoutArea: SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.

stringFormat: StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.

charactersFitted: Int32

Número de caracteres que contiene la cadena.

linesFilled: Int32

Número de líneas de texto que contiene la cadena.

Devoluciones

SizeF

Excepciones

ArgumentException

font es null.

Ejemplos

Crea una cadena para medir y un objeto de fuente establecido en Arial (16 puntos)
Establece el tamaño de diseño máximo de la cadena.
Crea un objeto de formato de cadena y establece sus marcas de formato en DirectionVertical.
Crea las variables charactersFitted de entero y linesFilled un objeto size para medir la cadena.
Mide el tamaño de la cadena y determina el número de caracteres ajustados y líneas rellenados, utilizando la cadena, el objeto de fuente, el tamaño de diseño máximo y el formato de cadena.
Dibuja un rectángulo rojo utilizando el tamaño medido de la cadena.
Dibuja la cadena dentro del rectángulo dibujado.
Dibuja los valores del número de caracteres ajustados y líneas rellenados.

El resultado es un rectángulo vertical que incluye una cadena vertical.

public:
   void MeasureStringSizeFFormatInts( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "Measure String";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Arial",16 );

      // Set maximum layout size.
      SizeF layoutSize = SizeF(100.0F,200.0F);

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

      // Measure string.
      int charactersFitted;
      int linesFilled;
      SizeF stringSize = e->Graphics->MeasureString( measureString, stringFont, layoutSize, newStringFormat, charactersFitted, linesFilled );

      // Draw rectangle representing size of string.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), 0.0F, 0.0F, stringSize.Width, stringSize.Height );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, PointF(0,0), newStringFormat );

      // Draw output parameters to screen.
      String^ outString = String::Format( "chars {0}, lines {1}", charactersFitted, linesFilled );
      e->Graphics->DrawString( outString, stringFont, Brushes::Black, PointF(100,0) );
   }

private void MeasureStringSizeFFormatInts(PaintEventArgs e)
{

    // Set up string.
    string measureString = "Measure String";
    Font stringFont = new Font("Arial", 16);

    // Set maximum layout size.
    SizeF layoutSize = new SizeF(100.0F, 200.0F);

    // Set string format.
    StringFormat newStringFormat = new StringFormat();
    newStringFormat.FormatFlags = StringFormatFlags.DirectionVertical;

    // Measure string.
    int charactersFitted;
    int linesFilled;
    SizeF stringSize = new SizeF();
    stringSize = e.Graphics.MeasureString(measureString, stringFont, layoutSize, newStringFormat, out charactersFitted, out linesFilled);

    // Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), 0.0F, 0.0F, stringSize.Width, stringSize.Height);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);

    // Draw output parameters to screen.
    string outString = "chars " + charactersFitted + ", lines " + linesFilled;
    e.Graphics.DrawString(outString, stringFont, Brushes.Black, new PointF(100, 0));
}

Private Sub MeasureStringSizeFFormatInts(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "Measure String"
    Dim stringFont As New Font("Arial", 16)

    ' Set maximum layout size.
    Dim layoutSize As New SizeF(100.0F, 200.0F)

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

    ' Measure string.
    Dim charactersFitted As Integer
    Dim linesFilled As Integer
    Dim stringSize As New SizeF
    stringSize = e.Graphics.MeasureString(measureString, stringFont, _
    layoutSize, newStringFormat, charactersFitted, linesFilled)

    ' Draw rectangle representing size of string.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), 0.0F, 0.0F, _
    stringSize.Width, stringSize.Height)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    New PointF(0, 0), newStringFormat)

    ' Draw output parameters to screen.
    Dim outString As String = "chars " & charactersFitted & _
    ", lines " & linesFilled
    e.Graphics.DrawString(outString, stringFont, Brushes.Black, _
    New PointF(100, 0))
End Sub

Comentarios

El MeasureString método está diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena para permitir glifos de voladizo. Además, el DrawString método ajusta los puntos de glifo para optimizar la calidad de la pantalla y podría mostrar una cadena más estrecha que la notificada por MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con formato), use el MeasureCharacterRanges método o uno de los MeasureString métodos que toman y StringFormat pasan GenericTypographic. Asegúrese también de que para TextRenderingHint Graphics es AntiAlias.

Consulte también

Se aplica a