Graphics.MeasureString Graphics.MeasureString Graphics.MeasureString Method

Definizione

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.Measures the specified string when drawn with the specified Font.

Overload

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.Measures the specified string when drawn with the specified Font.

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato nell'area di layout indicata.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font that defines the text format of the string.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata dal parametro text e disegnata con il parametro 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare.Creates a string to measure.

  • Crea un oggetto tipo di carattere e lo imposta su Arial (16 punti).Creates a font object and sets it to Arial (16 point).

  • Crea un oggetto Size e lo utilizza e l'oggetto del tipo di carattere per misurare la dimensione della stringa.Creates a size object and uses it and the font object to measure the size of the string.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato nell'area di layout indicata.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font defines the text format of the string.

layoutArea
SizeF SizeF SizeF

Struttura SizeF che specifica l'area massima di layout per il testo.SizeF structure that specifies the maximum layout area for the text.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata dal parametro text e disegnata con il parametro 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font impostato su Arial (16 punti).Creates a string to measure and a font object set to Arial (16 point).

  • Imposta la dimensione massima del layout della stringa.Sets the maximum layout size of the string.

  • Crea un oggetto Size e lo usa, l'oggetto del tipo di carattere e la dimensione massima del layout per misurare la dimensione della stringa.Creates a size object and uses it, the font object, and the maximum layout size to measure the size of the string.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato della stringa.Font that defines the format of the string.

width
Int32 Int32 Int32

Larghezza massima in pixel della stringa.Maximum width of the string in pixels.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata nella proprietà PageUnit, della stringa specificata dal parametro text e disegnata con il parametro 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font impostato su Arial (16 punti).Creates a string to measure and a font object set to Arial (16 point).

  • Imposta la larghezza massima della stringa.Sets the maximum width of the string.

  • Crea un oggetto Size e lo usa, l'oggetto del tipo di carattere e la larghezza massima della stringa per misurare la dimensione della stringa.Creates a size object and uses it, the font object, and the maximum string width to measure the size of the string.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.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

Commenti

Il width parametro specifica il valore massimo del componente Width della struttura restituita SizeF (Width).The width parameter specifies the maximum value of the width component of the returned SizeF structure (Width). Se il width parametro è minore della larghezza effettiva della stringa, il componente restituito Width viene troncato in base a un valore che rappresenta il numero massimo di caratteri che rientreranno nella larghezza specificata.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. Per contenere l'intera stringa, il componente Height restituito viene regolato in base a un valore che consente di visualizzare la stringa con ritorno a capo.To accommodate the entire string, the returned Height component is adjusted to a value that allows displaying the string with character wrap.

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

MeasureString(String, Font, PointF, StringFormat) MeasureString(String, Font, PointF, StringFormat) MeasureString(String, Font, PointF, StringFormat)

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font defines the text format of the string.

origin
PointF PointF PointF

Struttura PointF che rappresenta l'angolo superiore sinistro della stringa.PointF structure that represents the upper-left corner of the string.

stringFormat
StringFormat StringFormat StringFormat

Oggetto StringFormat che rappresenta le informazioni di formattazione per la stringa, ad esempio l'interlinea.StringFormat that represents formatting information, such as line spacing, for the string.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata dal parametro text e disegnata con i parametri font e 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font impostato su Arial (16 punti)Creates a string to measure and a font object set to Arial (16 point)

  • Crea un punto per individuare l'angolo superiore sinistro della stringa.Creates a point to locate the upper-left corner of the string.

  • Crea un oggetto formato stringa e ne imposta i flag di DirectionVerticalformato su.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea un oggetto Size per misurare la stringa.Creates a size object to measure the string.

  • Misura la dimensione della stringa, usando la stringa, l'oggetto del tipo di carattere, il punto di individuazione e il formato della stringa.Measures the size of the string, using the string, the font object, the locating point, and the string format.

  • Disegna un rettangolo rosso usando il punto di individuazione e la dimensione misurata della stringa.Draws a red rectangle using the locating point and the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.Draws the string within the drawn rectangle.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font defines the text format of the string.

layoutArea
SizeF SizeF SizeF

Struttura SizeF che specifica l'area massima di layout per il testo.SizeF structure that specifies the maximum layout area for the text.

stringFormat
StringFormat StringFormat StringFormat

Oggetto StringFormat che rappresenta le informazioni di formattazione per la stringa, ad esempio l'interlinea.StringFormat that represents formatting information, such as line spacing, for the string.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata nel parametro text e disegnata con i parametri font e 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font impostato su Arial (16 punti).Creates a string to measure and a font object set to Arial (16 point).

  • Imposta la dimensione massima del layout della stringa, creando un oggetto Size per misurare la stringa.Sets the maximum layout size of the string, creating a size object to measure the string.

  • Crea un oggetto formato stringa e ne imposta i flag di DirectionVerticalformato su.Creates a string format object and sets its format flags to DirectionVertical.

  • Misura la dimensione della stringa, usando la stringa, l'oggetto del tipo di carattere, la dimensione massima del layout e il formato della stringa.Measures the size of the string, using the string, the font object, the maximum layout size, and the string format.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.Draws the string within the drawn rectangle.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font that defines the text format of the string.

width
Int32 Int32 Int32

Larghezza massima della stringa.Maximum width of the string.

format
StringFormat StringFormat StringFormat

Oggetto StringFormat che rappresenta le informazioni di formattazione per la stringa, ad esempio l'interlinea.StringFormat that represents formatting information, such as line spacing, for the string.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, della stringa specificata nel parametro text e disegnata con i parametri font e 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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font lo imposta su Arial (16 punti).Creates a string to measure and a font object set it to Arial (16 point).

  • Imposta la larghezza massima della stringa.Sets the maximum width of the string.

  • Crea un oggetto formato stringa e ne imposta i flag di DirectionVerticalformato su.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea un oggetto Size per misurare la stringa.Creates a size object to measure the string.

  • Misura la dimensione della stringa, usando la stringa, l'oggetto del tipo di carattere, la larghezza massima e il formato della stringa.Measures the size of the string, using the string, the font object, the maximum width, and the string format.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.Draws the string within the drawn rectangle.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), MeasureCharacterRanges usare il MeasureString metodo o uno dei StringFormatmetodi che accetta GenericTypographicun oggetto e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also, ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

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

Misura la stringa specificata quando viene disegnata con l'oggetto Font specificato e formattata con l'oggetto StringFormat specificato.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

Parametri

text
String String String

Stringa da misurare.String to measure.

font
Font Font Font

Oggetto Font che definisce il formato di testo della stringa.Font that defines the text format of the string.

layoutArea
SizeF SizeF SizeF

Struttura SizeF che specifica l'area massima di layout per il testo.SizeF structure that specifies the maximum layout area for the text.

stringFormat
StringFormat StringFormat StringFormat

Oggetto StringFormat che rappresenta le informazioni di formattazione per la stringa, ad esempio l'interlinea.StringFormat that represents formatting information, such as line spacing, for the string.

charactersFitted
Int32 Int32 Int32

Numero di caratteri della stringa.Number of characters in the string.

linesFilled
Int32 Int32 Int32

Numero di righe di testo della stringa.Number of text lines in the string.

Restituisce

Questo metodo restituisce una struttura SizeF che rappresenta le dimensioni, nell'unità specificata dalla proprietà PageUnit, del parametro text e disegnata con i parametri font estringFormat.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.

Eccezioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea una stringa da misurare e un oggetto Font impostato su Arial (16 punti)Creates a string to measure and a font object set to Arial (16 point)

  • Imposta la dimensione massima del layout della stringa.Sets the maximum layout size of the string.

  • Crea un oggetto formato stringa e ne imposta i flag di DirectionVerticalformato su.Creates a string format object and sets its format flags to DirectionVertical.

  • Crea le variabili charactersFitted Integer e linesFilled un oggetto Size per misurare la stringa.Creates the integer variables charactersFitted and linesFilled and a size object to measure the string.

  • Misura la dimensione della stringa e determina il numero di caratteri montati e le linee riempite, usando la stringa, l'oggetto del tipo di carattere, la dimensione massima del layout e il formato della stringa.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.

  • Disegna un rettangolo rosso usando le dimensioni misurate della stringa.Draws a red rectangle using the measured size of the string.

  • Disegna la stringa all'interno del rettangolo disegnato.Draws the string within the drawn rectangle.

  • Disegna i valori del numero di caratteri montati e delle linee riempite.Draws the values of the number of characters fitted and lines filled.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.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

Commenti

Il MeasureString metodo è progettato per essere usato con stringhe singole e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi.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. Inoltre, il DrawString metodo regola i punti di glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta MeasureStringrispetto a quanto riportato da.Also, the DrawString method adjusts glyph points to optimize display quality and might display a string narrower than reported by MeasureString. Per ottenere le metriche MeasureCharacterRanges appropriate per StringFormat le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureString metodo o uno dei metodi che GenericTypographicaccetta e passano.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. Verificare TextRenderingHint inoltre che Graphics per sia AntiAlias.Also ensure the TextRenderingHint for the Graphics is AntiAlias.

Vedi anche

Si applica a