Graphics.MeasureString Metode

Referensi

Definisi

Ruang nama:: System.Drawing

Rakitan:: System.Drawing.Common.dll

Rakitan:: System.Drawing.dll

Paket:: System.Drawing.Common v8.0.0

Paket:: System.Drawing.Common v9.0.0-preview.2.24128.3

Paket:: System.Drawing.Common v6.0.0

Paket:: System.Drawing.Common v7.0.0

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font.

Overload

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(ReadOnlySpan<Char>, Font)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font.
MeasureString(String, Font)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font.
MeasureString(ReadOnlySpan<Char>, Font, SizeF)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dalam area tata letak yang ditentukan.
MeasureString(ReadOnlySpan<Char>, Font, Int32)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font.
MeasureString(String, Font, SizeF)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dalam area tata letak yang ditentukan.
MeasureString(String, Font, Int32)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font.
MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(String, Font, PointF, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(String, Font, SizeF, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(String, Font, Int32, StringFormat)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.
MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)	Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan StringFormat.

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

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font menentukan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Metode ini mengembalikan SizeF struktur yang mewakili ukuran, dalam unit yang ditentukan oleh PageUnit properti , dari string yang ditentukan dalam parameter seperti yang digambar text dengan font parameter dan stringFormat parameter .

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font yang menentukan format teks string.

Mengembalikan

SizeF

Metode ini mengembalikan SizeF struktur yang mewakili ukuran, dalam unit yang ditentukan oleh PageUnit properti , dari string yang ditentukan oleh parameter seperti yang text digambar dengan font parameter .

Berlaku untuk

MeasureString(String, Font)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font yang menentukan format teks string.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

ArgumentNullException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk diukur.
Membuat objek font dan mengaturnya ke Arial (16 titik).
Membuat objek ukuran dan menggunakannya dan objek font untuk mengukur ukuran string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

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

Keterangan

Metode MeasureString ini dirancang untuk digunakan dengan string individual dan mencakup sejumlah kecil ruang ekstra sebelum dan sesudah string untuk memungkinkan glyph yang berlebihan. Selain itu DrawString , metode menyesuaikan titik glyph untuk mengoptimalkan kualitas tampilan dan mungkin menampilkan string yang lebih sempit daripada yang dilaporkan oleh MeasureString. Untuk mendapatkan metrik yang cocok untuk string yang berdekatan dalam tata letak (misalnya, saat menerapkan teks yang diformat), gunakan MeasureCharacterRanges metode atau salah MeasureString satu metode yang mengambil StringFormat, dan lulus GenericTypographic. Selain itu TextRenderingHint , pastikan untuk Graphics adalah AntiAlias.

Lihat juga

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dalam area tata letak yang ditentukan.

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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font menentukan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

Mengembalikan

SizeF

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font yang mendefinisikan format string.

width: Int32

Lebar maksimum string dalam piksel.

Mengembalikan

SizeF

Metode ini mengembalikan SizeF struktur yang mewakili ukuran, dalam unit yang ditentukan oleh PageUnit properti , dari string yang ditentukan dalam parameter seperti yang text digambar dengan font parameter .

Berlaku untuk

MeasureString(String, Font, SizeF)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dalam area tata letak yang ditentukan.

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

Parameter

text: String

String untuk diukur.

font: Font

Font menentukan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk diukur dan objek font diatur ke Arial (16 titik).
Mengatur ukuran tata letak maksimum string.
Membuat objek ukuran dan menggunakannya, objek font, dan ukuran tata letak maksimum untuk mengukur ukuran string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

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

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, Int32)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font yang mendefinisikan format string.

width: Int32

Lebar maksimum string dalam piksel.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk diukur dan objek font diatur ke Arial (16 titik).
Mengatur lebar maksimum string.
Membuat objek ukuran dan menggunakannya, objek font, dan lebar string maksimum untuk mengukur ukuran string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

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

Keterangan

Parameter width menentukan nilai maksimum komponen lebar dari struktur yang dikembalikan SizeF (Width). width Jika parameter kurang dari lebar aktual string, komponen yang dikembalikan dipotong Width menjadi nilai yang mewakili jumlah karakter maksimum yang akan pas dalam lebar yang ditentukan. Untuk mengakomodasi seluruh string, komponen yang dikembalikan Height disesuaikan dengan nilai yang memungkinkan menampilkan string dengan pembungkus karakter.

Lihat juga

Berlaku untuk

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

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font menentukan format teks string.

origin: PointF

PointF struktur yang mewakili sudut kiri atas string.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Berlaku untuk

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

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font yang menentukan format teks string.

width: Int32

Lebar maksimum string.

format: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Berlaku untuk

MeasureString(String, Font, PointF, StringFormat)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font menentukan format teks string.

origin: PointF

PointF struktur yang mewakili sudut kiri atas string.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk mengukur dan objek font diatur ke Arial (16 titik)
Membuat titik untuk menemukan sudut kiri atas string.
Membuat objek format string dan mengatur bendera formatnya ke DirectionVertical.
Membuat objek ukuran untuk mengukur string.
Mengukur ukuran string, menggunakan string, objek font, titik lokasi, dan format string.
Menggambar persegi panjang merah menggunakan titik lokasi dan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

Hasilnya adalah persegi panjang vertikal yang mencakup string vertikal.

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

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, SizeF, StringFormat)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font menentukan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk diukur dan objek font diatur ke Arial (16 titik).
Mengatur ukuran tata letak maksimum string, membuat objek ukuran untuk mengukur string.
Membuat objek format string dan mengatur bendera formatnya ke DirectionVertical.
Mengukur ukuran string, menggunakan string, objek font, ukuran tata letak maksimum, dan format string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

Hasilnya adalah persegi panjang vertikal yang mencakup string vertikal.

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

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, Int32, StringFormat)

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font yang menentukan format teks string.

width: Int32

Lebar maksimum string.

format: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

Mengembalikan

SizeF

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk mengukur dan objek font mengaturnya ke Arial (16 titik).
Mengatur lebar maksimum string.
Membuat objek format string dan mengatur bendera formatnya ke DirectionVertical.
Membuat objek ukuran untuk mengukur string.
Mengukur ukuran string, menggunakan string, objek font, lebar maksimum, dan format string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.

Hasilnya adalah persegi panjang vertikal yang mencakup string vertikal.

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

Keterangan

Lihat juga

Berlaku untuk

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

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: ReadOnlySpan<Char>

String untuk diukur.

font: Font

Font yang menentukan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

charactersFitted: Int32

Jumlah karakter dalam string.

linesFilled: Int32

Jumlah baris teks dalam string.

Mengembalikan

SizeF

Metode ini mengembalikan SizeF struktur yang mewakili ukuran string, dalam unit yang ditentukan oleh PageUnit properti , dari parameter seperti yang text digambar dengan font parameter dan stringFormat parameter .

Berlaku untuk

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

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Sumber:: Graphics.cs

Mengukur string yang ditentukan saat digambar dengan yang ditentukan Font dan diformat dengan yang ditentukan 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

Parameter

text: String

String untuk diukur.

font: Font

Font yang mendefinisikan format teks string.

layoutArea: SizeF

SizeF struktur yang menentukan area tata letak maksimum untuk teks.

stringFormat: StringFormat

StringFormat yang mewakili informasi pemformatan, seperti penspasian baris, untuk string.

charactersFitted: Int32

Jumlah karakter dalam string.

linesFilled: Int32

Jumlah baris teks dalam string.

Mengembalikan

SizeF

Metode ini mengembalikan SizeF struktur yang mewakili ukuran string, dalam unit yang ditentukan oleh PageUnit properti , dari text parameter seperti yang digambar dengan font parameter dan stringFormat parameter .

Pengecualian

ArgumentException

fontadalah null.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Kode melakukan tindakan berikut:

Membuat string untuk mengukur dan objek font diatur ke Arial (16 titik)
Mengatur ukuran tata letak maksimum string.
Membuat objek format string dan mengatur bendera formatnya ke DirectionVertical.
Membuat variabel bilangan charactersFitted bulat dan linesFilled dan objek ukuran untuk mengukur string.
Mengukur ukuran string dan menentukan jumlah karakter yang pas dan baris yang diisi, menggunakan string, objek font, ukuran tata letak maksimum, dan format string.
Menggambar persegi panjang merah menggunakan ukuran string yang diukur.
Menggambar string dalam persegi panjang yang digambar.
Menggambar nilai jumlah karakter yang pas dan garis terisi.

Hasilnya adalah persegi panjang vertikal yang mengapit string vertikal.

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

Keterangan

Metode MeasureString ini dirancang untuk digunakan dengan string individual dan mencakup sejumlah kecil ruang ekstra sebelum dan sesudah string untuk memungkinkan glyph yang berlebihan. Selain itu DrawString , metode menyesuaikan titik glyph untuk mengoptimalkan kualitas tampilan dan mungkin menampilkan string yang lebih sempit daripada yang dilaporkan oleh MeasureString. Untuk mendapatkan metrik yang cocok untuk string yang berdekatan dalam tata letak (misalnya, saat menerapkan teks yang diformat), gunakan MeasureCharacterRanges metode atau salah MeasureString satu metode yang mengambil StringFormat dan melewati GenericTypographic. Pastikan TextRenderingHint juga untuk Graphics adalah AntiAlias.

Lihat juga

Berlaku untuk

Bagikan melalui

Graphics.MeasureString Metode

Definisi

Overload

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

Parameter

Mengembalikan

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font)

Parameter

Mengembalikan

Berlaku untuk

MeasureString(String, Font)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Parameter

Mengembalikan

Berlaku untuk

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Parameter

Mengembalikan

Berlaku untuk

MeasureString(String, Font, SizeF)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, Int32)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Berlaku untuk

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

Parameter

Mengembalikan

Berlaku untuk

MeasureString(String, Font, PointF, StringFormat)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, SizeF, StringFormat)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

MeasureString(String, Font, Int32, StringFormat)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Berlaku untuk