Graphics.MeasureString Graphics.MeasureString Graphics.MeasureString Method

Definición

Mide la cadena especificada al dibujarla con la Font especificada.Measures the specified string when drawn with the specified Font.

Sobrecargas

MeasureString(String, Font) MeasureString(String, Font) MeasureString(String, Font)

Mide la cadena especificada al dibujarla con la Font especificada.Measures the specified string when drawn with the specified Font.

MeasureString(String, Font, SizeF) MeasureString(String, Font, SizeF) MeasureString(String, Font, SizeF)

Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.Measures the specified string when drawn with the specified Font within the specified layout area.

MeasureString(String, Font, Int32) MeasureString(String, Font, Int32) MeasureString(String, Font, Int32)

Mide la cadena especificada al dibujarla con la Font especificada.Measures the specified string when drawn with the specified Font.

MeasureString(String, Font, PointF, StringFormat) MeasureString(String, Font, PointF, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

MeasureString(String, Font, SizeF, StringFormat) MeasureString(String, Font, SizeF, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

MeasureString(String, Font, Int32, StringFormat) MeasureString(String, Font, Int32, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32) MeasureString(String, Font, SizeF, StringFormat, Int32, Int32) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

MeasureString(String, Font) MeasureString(String, Font) MeasureString(String, Font)

Mide la cadena especificada al dibujarla con la Font especificada.Measures the specified string when drawn with the specified Font.

public:
 System::Drawing::SizeF MeasureString(System::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

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

Devoluciones

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 el parámetro font.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified by the text parameter as drawn with the font parameter.

Excepciones

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 para medir.Creates a string to measure.

  • Crea un objeto Font y lo establece en Arial (16 puntos).Creates a font object and sets it to Arial (16 point).

  • Crea un objeto de tamaño y lo utiliza y el objeto de fuente para medir el tamaño de la cadena.Creates a size object and uses it and the font object to measure the size of the string.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

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 se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, SizeF) MeasureString(String, Font, SizeF) MeasureString(String, Font, SizeF)

Mide la cadena especificada al dibujarla con la Font especificada dentro del área de presentación indicada.Measures the specified string when drawn with the specified Font within the specified layout area.

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);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF -> System.Drawing.SizeF

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

layoutArea
SizeF SizeF SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.SizeF structure that specifies the maximum layout area for the text.

Devoluciones

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 el parámetro font.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified by the text parameter as drawn with the font parameter.

Excepciones

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 para medir y un objeto de fuente establecido en Arial (16 puntos).Creates a string to measure and a font object set to Arial (16 point).

  • Establece el tamaño de diseño máximo de la cadena.Sets the maximum layout size of the string.

  • 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.Creates a size object and uses it, the font object, and the maximum layout size to measure the size of the string.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

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

El MeasureString método se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, Int32) MeasureString(String, Font, Int32) MeasureString(String, Font, Int32)

Mide la cadena especificada al dibujarla con la Font especificada.Measures the specified string when drawn with the specified Font.

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);
member this.MeasureString : string * System.Drawing.Font * int -> System.Drawing.SizeF

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

width
Int32 Int32 Int32

Ancho máximo de la cadena en píxeles.Maximum width of the string in pixels.

Devoluciones

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 el parámetro font.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified in the text parameter as drawn with the font parameter.

Excepciones

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 para medir y un objeto de fuente establecido en Arial (16 puntos).Creates a string to measure and a font object set to Arial (16 point).

  • Establece el ancho máximo de la cadena.Sets the maximum width of the string.

  • Crea un objeto de tamaño y lo usa, el objeto de fuente y el ancho de cadena máximo para medir el tamaño de la cadena.Creates a size object and uses it, the font object, and the maximum string width to measure the size of the string.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

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 SizeF devueltaWidth().The width parameter specifies the maximum value of the width component of the returned SizeF structure (Width). Si el width parámetro es menor que el ancho real de la cadena, el componente Width devuelto se trunca a un valor que representa el número máximo de caracteres que caben en el ancho especificado.If the width parameter is less than the actual width of the string, the returned Width component is truncated to a value representing the maximum number of characters that will fit within the specified width. Para dar cabida a toda la cadena Height , el componente devuelto se ajusta a un valor que permite mostrar la cadena con el ajuste de caracteres.To accommodate the entire string, the returned Height component is adjusted to a value that allows displaying the string with character wrap.

El MeasureString método se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, PointF, StringFormat) MeasureString(String, Font, PointF, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

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

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

origin
PointF PointF PointF

Estructura PointF que representa la esquina superior izquierda de la cadena.PointF structure that represents the upper-left corner of the string.

stringFormat
StringFormat StringFormat StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.StringFormat that represents formatting information, such as line spacing, for the string.

Devoluciones

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.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified by the text parameter as drawn with the font parameter and the stringFormat parameter.

Excepciones

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 para medir y un objeto de fuente establecido en Arial (16 puntos)Creates a string to measure and a font object set to Arial (16 point)

  • Crea un punto para buscar la esquina superior izquierda de la cadena.Creates a point to locate the upper-left corner of the string.

  • Crea un objeto de formato de cadena y establece sus marcas DirectionVerticalde formato en.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea un objeto de tamaño para medir la cadena.Creates a size object to measure the string.

  • Mide el tamaño de la cadena mediante la cadena, el objeto de fuente, el punto de ubicación y el formato de cadena.Measures the size of the string, using the string, the font object, the locating point, and the string format.

  • Dibuja un rectángulo rojo usando el punto de ubicación y el tamaño medido de la cadena.Draws a red rectangle using the locating point and the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

El resultado es un rectángulo vertical que rodea una cadena vertical.The result is a vertical rectangle enclosing a vertical string.

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

El MeasureString método se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, SizeF, StringFormat) MeasureString(String, Font, SizeF, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

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);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat -> System.Drawing.SizeF

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

layoutArea
SizeF SizeF SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.SizeF structure that specifies the maximum layout area for the text.

stringFormat
StringFormat StringFormat StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.StringFormat that represents formatting information, such as line spacing, for the string.

Devoluciones

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.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified in the text parameter as drawn with the font parameter and the stringFormat parameter.

Excepciones

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 para medir y un objeto de fuente establecido en Arial (16 puntos).Creates a string to measure and a font object set to Arial (16 point).

  • Establece el tamaño de diseño máximo de la cadena y crea un objeto de tamaño para medir la cadena.Sets the maximum layout size of the string, creating a size object to measure the string.

  • Crea un objeto de formato de cadena y establece sus marcas DirectionVerticalde formato en.Creates a string format object and sets its format flags to 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.Measures the size of the string, using the string, the font object, the maximum layout size, and the string format.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

El resultado es un rectángulo vertical que rodea una cadena vertical.The result is a vertical rectangle enclosing a vertical string.

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

El MeasureString método se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, Int32, StringFormat) MeasureString(String, Font, Int32, StringFormat) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

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);
member this.MeasureString : string * System.Drawing.Font * int * System.Drawing.StringFormat -> System.Drawing.SizeF

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

width
Int32 Int32 Int32

Ancho máximo de la cadena.Maximum width of the string.

format
StringFormat StringFormat StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.StringFormat that represents formatting information, such as line spacing, for the string.

Devoluciones

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.This method returns a SizeF structure that represents the size, in the units specified by the PageUnit property, of the string specified in the text parameter as drawn with the font parameter and the stringFormat parameter.

Excepciones

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 para medir y un objeto de fuente lo establece en Arial (16 puntos).Creates a string to measure and a font object set it to Arial (16 point).

  • Establece el ancho máximo de la cadena.Sets the maximum width of the string.

  • Crea un objeto de formato de cadena y establece sus marcas DirectionVerticalde formato en.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea un objeto de tamaño para medir la cadena.Creates a size object to measure the string.

  • Mide el tamaño de la cadena mediante la cadena, el objeto de fuente, el ancho máximo y el formato de cadena.Measures the size of the string, using the string, the font object, the maximum width, and the string format.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

El resultado es un rectángulo vertical que rodea una cadena vertical.The result is a vertical rectangle enclosing a vertical string.

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

El MeasureString método se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormatlos métodos que GenericTypographictoma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat, and pass GenericTypographic. Además, asegúrese Graphics de TextRenderingHint que para es AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32) MeasureString(String, Font, SizeF, StringFormat, Int32, Int32) 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.Measures the specified string when drawn with the specified Font and formatted with the specified StringFormat.

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);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat * int * int -> System.Drawing.SizeF

Parámetros

text
String String String

Cadena que se va a medir.String to measure.

font
Font Font Font

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

layoutArea
SizeF SizeF SizeF

Estructura SizeF que especifica el área máxima de presentación del texto.SizeF structure that specifies the maximum layout area for the text.

stringFormat
StringFormat StringFormat StringFormat

StringFormat que representa la información de formato, como el espaciado interlineal.StringFormat that represents formatting information, such as line spacing, for the string.

charactersFitted
Int32 Int32 Int32

Número de caracteres que contiene la cadena.Number of characters in the string.

linesFilled
Int32 Int32 Int32

Número de líneas de texto que contiene la cadena.Number of text lines in the string.

Devoluciones

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.This method returns a SizeF structure that represents the size of the string, in the units specified by the PageUnit property, of the text parameter as drawn with the font parameter and the stringFormat parameter.

Excepciones

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 para medir y un objeto de fuente establecido en Arial (16 puntos)Creates a string to measure and a font object set to Arial (16 point)

  • Establece el tamaño de diseño máximo de la cadena.Sets the maximum layout size of the string.

  • Crea un objeto de formato de cadena y establece sus marcas DirectionVerticalde formato en.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea las variables charactersFitted de entero y linesFilled y un objeto de tamaño para medir la cadena.Creates the integer variables charactersFitted and linesFilled and a size object to measure the string.

  • Mide el tamaño de la cadena y determina el número de caracteres incluidos y las líneas rellenas, utilizando la cadena, el objeto de fuente, el tamaño de diseño máximo y el formato de cadena.Measures the size of the string and determines the number of characters fitted and lines filled, using the string, the font object, the maximum layout size, and the string format.

  • Dibuja un rectángulo rojo usando el tamaño medido de la cadena.Draws a red rectangle using the measured size of the string.

  • Dibuja la cadena dentro del rectángulo dibujado.Draws the string within the drawn rectangle.

  • Dibuja los valores del número de caracteres ajustado y de las líneas rellenas.Draws the values of the number of characters fitted and lines filled.

El resultado es un rectángulo vertical que rodea una cadena vertical.The result is a vertical rectangle enclosing a vertical string.

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 se ha diseñado para su uso con cadenas individuales e incluye una pequeña cantidad de espacio adicional antes y después de la cadena que se va a permitir para los glifos sobresalientes.The MeasureString method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Además, el DrawString método ajusta los puntos del glifo para optimizar la calidad de la pantalla y puede mostrar una cadena más MeasureStringestrecha de lo que indica.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Para obtener las métricas adecuadas para las cadenas adyacentes en el diseño (por ejemplo, al implementar texto con MeasureCharacterRanges formato), use el MeasureString método o uno de StringFormat los métodos GenericTypographicque toma un y un paso.To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the MeasureCharacterRanges method or one of the MeasureString methods that takes a StringFormat and pass GenericTypographic. Asegúrese TextRenderingHint AntiAlias tambiénGraphics de que el es.Also ensure the TextRenderingHint for the Graphics is AntiAlias.

Consulte también:

Se aplica a