Graphics.MeasureString Metodo

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa da misurare.

• Crea un oggetto carattere e lo imposta su Arial (16 punti).

• Crea un oggetto size e lo usa e l'oggetto carattere per misurare le dimensioni della stringa.

• Disegna un rettangolo rosso usando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo di disegno.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging degli glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità della visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passare GenericTypographic. Assicurarsi inoltre che l'oggetto TextRenderingHint per sia GraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

• Imposta la dimensione massima del layout della stringa.

• Crea un oggetto size e lo usa, l'oggetto carattere e le dimensioni massime del layout per misurare le dimensioni della stringa.

• Disegna un rettangolo rosso usando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo di disegno.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging degli glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità della visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche appropriate per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passare GenericTypographic. Assicurarsi inoltre che l'oggetto TextRenderingHint per sia GraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

• Imposta la larghezza massima della stringa.

• Crea un oggetto size e lo usa, l'oggetto carattere e la larghezza massima della stringa per misurare le dimensioni della stringa.

• Disegna un rettangolo rosso usando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo di disegno.

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). Se il width parametro è minore della larghezza effettiva della stringa, il componente restituito Width viene troncato a un valore che rappresenta il numero massimo di caratteri che rientrano nella larghezza specificata. Per contenere l'intera stringa, il componente restituito Height viene modificato in un valore che consente di visualizzare la stringa con il ritorno a capo del carattere.

Il MeasureString metodo è progettato per l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche adatte per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passano GenericTypographic. Assicurarsi inoltre che per sia TextRenderingHintGraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti)

• Crea un punto per individuare l'angolo superiore sinistro della stringa.

• Crea un oggetto formato stringa e ne imposta i flag di formato su DirectionVertical.

• Crea un oggetto size per misurare la stringa.

• Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto tipo di carattere, il punto di individuazione e il formato stringa.

• Disegna un rettangolo rosso utilizzando il punto di individuazione e le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche adatte per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passano GenericTypographic. Assicurarsi inoltre che per sia TextRenderingHintGraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti).

• Imposta la dimensione massima del layout della stringa, creando un oggetto size per misurare la stringa.

• Crea un oggetto formato stringa e ne imposta i flag di formato su DirectionVertical.

• Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto carattere, le dimensioni massime del layout e il formato stringa.

• Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche adatte per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passano GenericTypographic. Assicurarsi inoltre che per sia TextRenderingHintGraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostarlo su Arial (16 punti).

• Imposta la larghezza massima della stringa.

• Crea un oggetto formato stringa e ne imposta i flag di formato su DirectionVertical.

• Crea un oggetto size per misurare la stringa.

• Misura le dimensioni della stringa, utilizzando la stringa, l'oggetto font, la larghezza massima e il formato stringa.

• Disegna un rettangolo rosso utilizzando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo disegnato.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging dei glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità di visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche adatte per le stringhe adiacenti nel layout (ad esempio, quando si implementa il testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano un StringFormatoggetto e passano GenericTypographic. Assicurarsi inoltre che per sia TextRenderingHintGraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

Parametri

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.

Source:

Graphics.cs

Source:

Graphics.cs

Source:

Graphics.cs

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

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

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

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

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

Parametri

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.

Eccezioni

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea una stringa per misurare e un oggetto carattere impostato su Arial (16 punti)

• Imposta la dimensione massima del layout della stringa.

• Crea un oggetto formato stringa e ne imposta i flag di formato su DirectionVertical.

• Crea le variabili charactersFitted integer e linesFilled un oggetto size per misurare la stringa.

• Misura le dimensioni della stringa e determina il numero di caratteri inseriti e righe riempiti, usando la stringa, l'oggetto carattere, le dimensioni massime del layout e il formato stringa.

• Disegna un rettangolo rosso usando le dimensioni misurate della stringa.

• Disegna la stringa all'interno del rettangolo di disegno.

• Disegna i valori del numero di caratteri inseriti e linee riempiti.

Il risultato è un rettangolo verticale che racchiude una stringa verticale.

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 l'uso con singole stringhe e include una piccola quantità di spazio aggiuntivo prima e dopo la stringa per consentire l'overhanging degli glifi. Inoltre, il DrawString metodo regola i punti del glifo per ottimizzare la qualità della visualizzazione e potrebbe visualizzare una stringa più stretta rispetto a quella segnalata da MeasureString. Per ottenere le metriche adatte per le stringhe adiacenti nel layout (ad esempio, quando si implementa testo formattato), usare il MeasureCharacterRanges metodo o uno dei MeasureString metodi che accettano e StringFormat passano GenericTypographic. Assicurarsi anche che l'oggetto TextRenderingHint per sia GraphicsAntiAlias.

Vedi anche

• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)
• MeasureCharacterRanges(String, Font, RectangleF, StringFormat)
• Utilizzo di tipi di carattere e testo