Graphics.MeasureString Método

Referência

Definição

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v9.0.0-rc.1.24451.1

Pacote:: System.Drawing.Common v8.0.8

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.

Sobrecargas

MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(String, Font, Int32, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(String, Font, SizeF, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(String, Font, PointF, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.
MeasureString(ReadOnlySpan<Char>, Font)	Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.
MeasureString(String, Font, Int32)	Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.
MeasureString(String, Font, SizeF)	Mede a cadeia de caracteres especificada quando desenhada com o Font especificado dentro da área de layout especificada.
MeasureString(ReadOnlySpan<Char>, Font, Int32)	Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.
MeasureString(ReadOnlySpan<Char>, Font, SizeF)	Mede a cadeia de caracteres especificada quando desenhada com o Font especificado dentro da área de layout especificada.
MeasureString(String, Font)	Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.
MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)	Mede a cadeia de caracteres especificada quando desenhada com a Font especificada e formatada com o StringFormatespecificado.

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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 informações de formatação, como espaçamento de linha, para a cadeia de caracteres.

Retornos

SizeF

Esse 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 desenhado com o parâmetro font e o parâmetro stringFormat.

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

charactersFitted: Int32

Número de caracteres na cadeia de caracteres.

linesFilled: Int32

Número de linhas de texto na cadeia de caracteres.

Retornos

SizeF

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

Exceções

ArgumentException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 inteiros charactersFitted e linesFilled e um objeto de tamanho 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 de 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 contém 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormat e passa GenericTypographic. Verifique também se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

charactersFitted: Int32

Número de caracteres na cadeia de caracteres.

linesFilled: Int32

Número de linhas de texto na cadeia de caracteres.

Retornos

SizeF

Aplica-se a

MeasureString(String, Font, Int32, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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 informações de formatação, como espaçamento de linha, para a cadeia de caracteres.

Retornos

SizeF

Exceções

ArgumentException

font é null.

Exemplos

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

Cria uma cadeia de caracteres para medir e um objeto de fonte o 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 de tamanho 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 de 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 contém 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, SizeF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

Retornos

SizeF

Exceções

ArgumentException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 de 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 contém 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, PointF, StringFormat)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

Retornos

SizeF

Esse 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

ArgumentException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 de tamanho 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 de 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 contém 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

Retornos

SizeF

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.

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

SizeF

Aplica-se a

MeasureString(String, Font, Int32)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.

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

SizeF

Exceções

ArgumentException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 de tamanho e o usa, o objeto de fonte 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 parâmetro width especifica o valor máximo do componente de largura da estrutura de SizeF retornada (Width). Se o parâmetro width for menor que a largura real da cadeia de caracteres, o componente de Width retornado será truncado para um valor que representa o número máximo de caracteres que se ajustará à largura especificada. Para acomodar toda a cadeia de caracteres, o componente de Height retornado é ajustado para um valor que permite exibir a cadeia de caracteres com encapsulamento de caractere.

O método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

MeasureString(String, Font, SizeF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado dentro da á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

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

Retornos

SizeF

Exceções

ArgumentException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 tamanho e o usa, o objeto de fonte 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.

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

SizeF

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Font especificado dentro da á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

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

Retornos

SizeF

Aplica-se a

MeasureString(String, Font)

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

Mede a cadeia de caracteres especificada quando desenhada com o Fontespecificado.

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

SizeF

Exceções

ArgumentException

font é null.

ArgumentNullException

font é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. 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 de tamanho e o usa e o objeto de fonte 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 método MeasureString 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 a sobreposição de glifos. Além disso, o método DrawString 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 método MeasureCharacterRanges ou um dos métodos MeasureString que usa um StringFormate passe GenericTypographic. Além disso, verifique se o TextRenderingHint do Graphics está AntiAlias.

Confira também

Aplica-se a

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

Origem:: Graphics.cs

Origem:: Graphics.cs

Origem:: Graphics.cs

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

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

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

stringFormat: StringFormat

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

Retornos

SizeF

Aplica-se a

Compartilhar via

Graphics.MeasureString Método

Definição

Sobrecargas

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

Parâmetros

Retornos

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Aplica-se a

MeasureString(String, Font, Int32, StringFormat)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

MeasureString(String, Font, SizeF, StringFormat)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

MeasureString(String, Font, PointF, StringFormat)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font)

Parâmetros

Retornos

Aplica-se a

MeasureString(String, Font, Int32)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

MeasureString(String, Font, SizeF)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Parâmetros

Retornos

Aplica-se a

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Parâmetros

Retornos

Aplica-se a

MeasureString(String, Font)

Parâmetros

Retornos

Exceções