Graphics.MeasureString Método

Definição

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

Sobrecargas

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

MeasureString(ReadOnlySpan<Char>, Font)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

MeasureString(String, Font)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Mede a cadeia de caracteres especificada desenhada com o Font especificado dentro de uma área de layout especificada.

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

MeasureString(String, Font, SizeF)

Mede a cadeia de caracteres especificada desenhada com o Font especificado dentro de uma área de layout especificada.

MeasureString(String, Font, Int32)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

MeasureString(String, Font, PointF, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

MeasureString(String, Font, SizeF, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

MeasureString(String, Font, Int32, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF, stringFormat As StringFormat) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text, conforme desenhada com os parâmetros font e stringFormat.

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhada com o parâmetro font.

Aplica-se a

MeasureString(String, Font)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font);
member this.MeasureString : string * System.Drawing.Font -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhada com o parâmetro font.

Exceções

font é null.

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres a ser medida.

  • Cria um objeto de fonte e o define como Arial (16 pontos).

  • Cria um objeto size e o usa e o objeto font para medir o tamanho da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Mede a cadeia de caracteres especificada desenhada com o Font especificado dentro de uma área de layout especificada.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhada com o parâmetro font.

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, int width);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * int -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, width As Integer) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato da cadeia de caracteres.

width
Int32

Largura máxima da cadeia de caracteres em pixels.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, em unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text desenhada com o parâmetro font.

Aplica-se a

MeasureString(String, Font, SizeF)

Mede a cadeia de caracteres especificada desenhada com o Font especificado dentro de uma área de layout especificada.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, layoutArea As SizeF) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhada com o parâmetro font.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte definido como Arial (16 pontos).

  • Define o tamanho máximo do layout da cadeia de caracteres.

  • Cria um objeto size e o usa, o objeto font e o tamanho máximo do layout para medir o tamanho da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, Int32)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, int width);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width);
member this.MeasureString : string * System.Drawing.Font * int -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, width As Integer) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato da cadeia de caracteres.

width
Int32

Largura máxima da cadeia de caracteres em pixels.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, em unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text desenhada com o parâmetro font.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte definido como Arial (16 pontos).

  • Define a largura máxima da cadeia de caracteres.

  • Cria um objeto size e o usa, o objeto font e a largura máxima da cadeia de caracteres para medir o tamanho da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

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

Comentários

O width parâmetro especifica o valor máximo do componente de largura da estrutura retornada SizeF (Width). Se o width parâmetro for menor que a largura real da cadeia de caracteres, o componente retornado Width será truncado para um valor que representa o número máximo de caracteres que caberá dentro da largura especificada. Para acomodar toda a cadeia de caracteres, o componente retornado Height é ajustado para um valor que permite exibir a cadeia de caracteres com quebra automática de caracteres.

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::PointF origin, System::Drawing::StringFormat ^ stringFormat);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.PointF * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, origin As PointF, stringFormat As StringFormat) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

origin
PointF

A estrutura PointF que representa o canto superior esquerdo da cadeia de caracteres.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhado com o parâmetro font e o parâmetro stringFormat.

Aplica-se a

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, int width, System::Drawing::StringFormat ^ format);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * int * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, width As Integer, format As StringFormat) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

width
Int32

Largura máxima da cadeia de caracteres.

format
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text, conforme desenhada com os parâmetros font e stringFormat.

Aplica-se a

MeasureString(String, Font, PointF, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::PointF origin, System::Drawing::StringFormat ^ stringFormat);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat stringFormat);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.PointF origin, System.Drawing.StringFormat? stringFormat);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.PointF * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, origin As PointF, stringFormat As StringFormat) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

origin
PointF

A estrutura PointF que representa o canto superior esquerdo da cadeia de caracteres.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada pelo parâmetro text conforme desenhado com o parâmetro font e o parâmetro stringFormat.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte definido como Arial (16 pontos)

  • Cria um ponto para localizar o canto superior esquerdo da cadeia de caracteres.

  • Cria um objeto de formato de cadeia de caracteres e define seus sinalizadores de formato como DirectionVertical.

  • Cria um objeto size para medir a cadeia de caracteres.

  • Mede o tamanho da cadeia de caracteres, usando a cadeia de caracteres, o objeto de fonte, o ponto de localização e o formato da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o ponto de localização e o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

O resultado é um retângulo vertical que inclui uma cadeia de caracteres vertical.

public:
   void MeasureStringPointFFormat( PaintEventArgs^ e )
   {

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

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

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

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

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

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

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

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

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

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

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

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, ulCorner, newStringFormat);
}
Private Sub MeasureStringPointFFormat(ByVal e As PaintEventArgs)

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

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

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

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

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

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, SizeF, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, layoutArea As SizeF, stringFormat As StringFormat) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text, conforme desenhada com os parâmetros font e stringFormat.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte definido como Arial (16 pontos).

  • Define o tamanho máximo do layout da cadeia de caracteres, criando um objeto de tamanho para medir a cadeia de caracteres.

  • Cria um objeto de formato de cadeia de caracteres e define seus sinalizadores de formato como DirectionVertical.

  • Mede o tamanho da cadeia de caracteres, usando a cadeia de caracteres, o objeto de fonte, o tamanho máximo do layout e o formato da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

O resultado é um retângulo vertical que inclui uma cadeia de caracteres vertical.

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

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

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

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

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

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

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

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

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

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

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

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}
Private Sub MeasureStringSizeFFormat(ByVal e As PaintEventArgs)

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

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

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

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

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

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, Int32, StringFormat)

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, int width, System::Drawing::StringFormat ^ format);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, int width, System.Drawing.StringFormat format);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, int width, System.Drawing.StringFormat? format);
member this.MeasureString : string * System.Drawing.Font * int * System.Drawing.StringFormat -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, width As Integer, format As StringFormat) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

width
Int32

Largura máxima da cadeia de caracteres.

format
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

Retornos

Este método retorna uma estrutura SizeF que representa o tamanho, nas unidades especificadas pela propriedade PageUnit, da cadeia de caracteres especificada no parâmetro text, conforme desenhada com os parâmetros font e stringFormat.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte a define como Arial (16 pontos).

  • Define a largura máxima da cadeia de caracteres.

  • Cria um objeto de formato de cadeia de caracteres e define seus sinalizadores de formato como DirectionVertical.

  • Cria um objeto size para medir a cadeia de caracteres.

  • Mede o tamanho da cadeia de caracteres, usando a cadeia de caracteres, o objeto de fonte, a largura máxima e o formato da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

O resultado é um retângulo vertical que inclui uma cadeia de caracteres vertical.

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

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

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

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

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

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

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

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

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

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

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

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, new PointF(0, 0), newStringFormat);
}
Private Sub MeasureStringWidthFormat(ByVal e As PaintEventArgs)

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

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

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

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

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

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat, [Runtime::InteropServices::Out] int % charactersFitted, [Runtime::InteropServices::Out] int % linesFilled);
public System.Drawing.SizeF MeasureString (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);
member this.MeasureString : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat * int * int -> System.Drawing.SizeF
Public Function MeasureString (text As ReadOnlySpan(Of Char), font As Font, layoutArea As SizeF, stringFormat As StringFormat, ByRef charactersFitted As Integer, ByRef linesFilled As Integer) As SizeF

Parâmetros

text
ReadOnlySpan<Char>

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

charactersFitted
Int32

O número de caracteres na cadeia de caracteres.

linesFilled
Int32

O número de linhas de texto na cadeia de caracteres.

Retornos

Esse método retorna uma estrutura SizeF que representa o tamanho, em unidades especificadas pela propriedade PageUnit, da cadeia de caracteres do parâmetro text desenhada com os parâmetros font e stringFormat.

Aplica-se a

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

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado e formatada com o StringFormat especificado.

public:
 System::Drawing::SizeF MeasureString(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::SizeF layoutArea, System::Drawing::StringFormat ^ stringFormat, [Runtime::InteropServices::Out] int % charactersFitted, [Runtime::InteropServices::Out] int % linesFilled);
public System.Drawing.SizeF MeasureString (string text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat stringFormat, out int charactersFitted, out int linesFilled);
public System.Drawing.SizeF MeasureString (string? text, System.Drawing.Font font, System.Drawing.SizeF layoutArea, System.Drawing.StringFormat? stringFormat, out int charactersFitted, out int linesFilled);
member this.MeasureString : string * System.Drawing.Font * System.Drawing.SizeF * System.Drawing.StringFormat * int * int -> System.Drawing.SizeF
Public Function MeasureString (text As String, font As Font, layoutArea As SizeF, stringFormat As StringFormat, ByRef charactersFitted As Integer, ByRef linesFilled As Integer) As SizeF

Parâmetros

text
String

Cadeia de caracteres a ser medida.

font
Font

Font que define o formato de texto da cadeia de caracteres.

layoutArea
SizeF

A estrutura SizeF que especifica a área de layout máximo para o texto.

stringFormat
StringFormat

StringFormat que representa as informações de formatação, como o espaçamento entre linhas, para a cadeia de caracteres.

charactersFitted
Int32

O número de caracteres na cadeia de caracteres.

linesFilled
Int32

O número de linhas de texto na cadeia de caracteres.

Retornos

Esse método retorna uma estrutura SizeF que representa o tamanho, em unidades especificadas pela propriedade PageUnit, da cadeia de caracteres do parâmetro text desenhada com os parâmetros font e stringFormat.

Exceções

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

  • Cria uma cadeia de caracteres para medir e um objeto de fonte definido como Arial (16 pontos)

  • Define o tamanho máximo do layout da cadeia de caracteres.

  • Cria um objeto de formato de cadeia de caracteres e define seus sinalizadores de formato como DirectionVertical.

  • Cria as variáveis charactersFitted de inteiro e linesFilled um objeto size para medir a cadeia de caracteres.

  • Mede o tamanho da cadeia de caracteres e determina o número de caracteres ajustados e linhas preenchidas, usando a cadeia de caracteres, o objeto de fonte, o tamanho máximo do layout e o formato da cadeia de caracteres.

  • Desenha um retângulo vermelho usando o tamanho medido da cadeia de caracteres.

  • Desenha a cadeia de caracteres dentro do retângulo desenhado.

  • Desenha os valores do número de caracteres ajustados e linhas preenchidas.

O resultado é um retângulo vertical que envolve uma cadeia de caracteres vertical.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Comentários

O MeasureString método foi projetado para uso com cadeias de caracteres individuais e inclui uma pequena quantidade de espaço extra antes e depois da cadeia de caracteres para permitir glifos pendentes. Além disso, o DrawString método ajusta pontos de glifo para otimizar a qualidade da exibição e pode exibir uma cadeia de caracteres mais estreita do que a relatada por MeasureString. Para obter métricas adequadas para cadeias de caracteres adjacentes no layout (por exemplo, ao implementar texto formatado), use o MeasureCharacterRanges método ou um dos MeasureString métodos que usa um StringFormat e passe GenericTypographic. Verifique também se o TextRenderingHintGraphics para é AntiAlias.

Confira também

Aplica-se a