Graphics.MeasureString 方法

參考

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v8.0.0

套件:: System.Drawing.Common v9.0.0-preview.2.24128.3

套件:: System.Drawing.Common v6.0.0

套件:: System.Drawing.Common v7.0.0

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

以指定的 Font 物件繪製時，測量指定的字串。

多載

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font)	以指定的 Font 物件繪製時，測量指定的字串。
MeasureString(String, Font)	以指定的 Font 物件繪製時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font, SizeF)	在指定之配置區域中使用指定的 Font 繪製時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font, Int32)	以指定的 Font 物件繪製時，測量指定的字串。
MeasureString(String, Font, SizeF)	在指定之配置區域中使用指定的 Font 繪製時，測量指定的字串。
MeasureString(String, Font, Int32)	以指定的 Font 物件繪製時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(String, Font, PointF, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(String, Font, SizeF, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(String, Font, Int32, StringFormat)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。
MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)	以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

適用於

MeasureString(ReadOnlySpan<Char>, Font)

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 物件繪製時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

適用於

MeasureString(String, Font)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 物件繪製時，測量指定的字串。

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

例外狀況

ArgumentException

font 為 null。

ArgumentNullException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串。
建立字型物件，並將其設定為 Arial (16 點) 。
建立 size 物件，並使用它和字型對象來測量字串的大小。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

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

備註

方法 MeasureString 的設計目的是要與個別字串搭配使用，而且在字串前後包含少量的額外空間，以允許過度暫留字元。此外，方法 DrawString 會調整圖像點，以優化顯示品質，而且可能會顯示比所報告窄的 MeasureString字串。例如，若要取得適用於版面配置中相鄰字串的計量 (，例如，在實作格式化文字) 時，請使用 MeasureCharacterRanges 方法或採用StringFormat的其中一個MeasureString方法，並傳遞 GenericTypographic。此外，請確定 TextRenderingHint 的 Graphics 為 AntiAlias。

另請參閱

適用於

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

來源:: Graphics.cs

來源:: Graphics.cs

在指定之配置區域中使用指定的 Font 繪製時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

適用於

MeasureString(ReadOnlySpan<Char>, Font, Int32)

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 物件繪製時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的格式。

width: Int32

字串的最大寬度，以像素為單位。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

適用於

MeasureString(String, Font, SizeF)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

在指定之配置區域中使用指定的 Font 繪製時，測量指定的字串。

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將字型物件設定為 Arial (16 點) 。
設定字串的版面配置大小上限。
建立 size 物件，並使用它、字型物件和最大版面配置大小來測量字串的大小。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

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

備註

另請參閱

適用於

MeasureString(String, Font, Int32)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 物件繪製時，測量指定的字串。

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

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

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的格式。

width: Int32

字串的最大寬度，以像素為單位。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數繪製時的大小，而使用的單位是由 font 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將字型物件設定為 Arial (16 點) 。
設定字串的最大寬度。
建立 size 物件，並使用它、字型物件和字串寬度上限來測量字串的大小。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

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

備註

參數 width 會指定傳 SizeF 回結構的寬度元件最大值， (Width) 。 width如果參數小於字串的實際寬度，則傳Width回的元件會截斷為值，代表符合指定寬度的最大字元數。為了容納整個字串，傳 Height 回的元件會調整為允許以字元換行顯示字串的值。

方法 MeasureString 的設計目的是要搭配個別字串使用，而且在字串前後包含少量的額外空間，以允許過度附加字元。此外，此方法 DrawString 會調整圖像點以優化顯示品質，而且可能會顯示比所報告的更窄的 MeasureString字串。若要取得適用於版面設定 (中相鄰字串的計量，例如，實作格式化文字) 時，請使用 MeasureCharacterRanges 方法或採用的其中一個 MeasureString 方法 StringFormat，並傳遞 GenericTypographic。此外，請確定 TextRenderingHint 的 Graphics 為 AntiAlias。

另請參閱

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

origin: PointF

PointF 結構，表示字串的左上角。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

width: Int32

字串的最大寬度。

format: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

適用於

MeasureString(String, Font, PointF, StringFormat)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

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

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

origin: PointF

PointF 結構，表示字串的左上角。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將字型物件設定為 Arial (16 點)
建立一個點，以找出字串的左上角。
建立字串格式物件，並將其格式旗標設定為 DirectionVertical。
建立size對象來測量字串。
使用字串、字型物件、尋找點和字串格式來測量字串的大小。
使用尋找點和字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

結果是以垂直字串括住的垂直矩形。

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

備註

另請參閱

適用於

MeasureString(String, Font, SizeF, StringFormat)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

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

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將字型物件設定為 Arial (16 點) 。
設定字串的版面配置大小上限，建立大小對象來測量字串。
建立字串格式物件，並將其格式旗標設定為 DirectionVertical。
使用字串、字型物件、配置大小上限和字串格式來測量字串的大小。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

結果是以垂直字串括住的垂直矩形。

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

備註

另請參閱

適用於

MeasureString(String, Font, Int32, StringFormat)

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

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

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

width: Int32

字串的最大寬度。

format: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 PageUnit 參數中所指定的字串以 text 參數和 font 參數繪製時的大小，而使用的單位是由 stringFormat 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將它設定為 Arial (16 點) 。
設定字串的最大寬度。
建立字串格式物件，並將其格式旗標設定為 DirectionVertical。
建立size對象來測量字串。
使用字串、字型物件、最大寬度和字串格式來測量字串的大小。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。

結果是以垂直字串括住的垂直矩形。

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

備註

另請參閱

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

參數

text: ReadOnlySpan<Char>

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

charactersFitted: Int32

字串中的字元數。

linesFilled: Int32

字串中的文字行數。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 text 參數的字串以 font 參數和 stringFormat 參數繪製時的大小，而使用的單位是由 PageUnit 屬性所指定。

適用於

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

來源:: Graphics.cs

來源:: Graphics.cs

來源:: Graphics.cs

以指定的 Font 繪製並以指定的 StringFormat 設定格式時，測量指定的字串。

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

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

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

參數

text: String

要測量的字串。

font: Font

Font，定義字串的文字格式。

layoutArea: SizeF

SizeF 結構，指定文字的最大配置區域。

stringFormat: StringFormat

StringFormat，表示字串的格式設定資訊，例如行距。

charactersFitted: Int32

字串中的字元數。

linesFilled: Int32

字串中的文字行數。

傳回

SizeF

這個方法會傳回 SizeF 結構，表示 text 參數的字串以 font 參數和 stringFormat 參數繪製時的大小，而使用的單位是由 PageUnit 屬性所指定。

例外狀況

ArgumentException

font 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。此程式碼會執行下列動作：

建立要測量的字串，並將字型物件設定為 Arial (16 點)
設定字串的版面配置大小上限。
建立字串格式物件，並將其格式旗標設定為 DirectionVertical。
建立整數變數 charactersFitted 和和 linesFilled size對象來測量字串。
測量字串的大小，並決定使用字串、字型物件、配置大小上限和字串格式填滿的字元數。
使用字串的測量大小繪製紅色矩形。
繪製矩形內的字串。
繪製填滿字元數和行數的值。

結果是以垂直字串括住的垂直矩形。

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

備註

方法 MeasureString 的設計目的是要與個別字串搭配使用，而且在字串前後包含少量的額外空間，以允許過度暫留字元。此外，方法 DrawString 會調整圖像點，以優化顯示品質，而且可能會顯示比所報告窄的 MeasureString字串。例如，若要取得適用於版面配置中相鄰字串的計量 (，例如，在實作格式化文字) 時，請使用 MeasureCharacterRanges 方法或採用 StringFormat 並傳遞GenericTypographic的其中一種方法MeasureString。也請確定 TextRenderingHint 的 Graphics 為 AntiAlias。

另請參閱

適用於