Graphics.MeasureString Metoda

Reference

Definice

Obor názvů:: System.Drawing

Sestavení:: System.Drawing.Common.dll

Sestavení:: System.Drawing.dll

Balíček:: System.Drawing.Common v8.0.0

Balíček:: System.Drawing.Common v9.0.0-preview.2.24128.3

Balíček:: System.Drawing.Common v6.0.0

Balíček:: System.Drawing.Common v7.0.0

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .

Přetížení

MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(ReadOnlySpan<Char>, Font)	Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .
MeasureString(String, Font)	Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .
MeasureString(ReadOnlySpan<Char>, Font, SizeF)	Měří zadaný řetězec při kreslení se zadaným Font řetězcem v zadané oblasti rozložení.
MeasureString(ReadOnlySpan<Char>, Font, Int32)	Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .
MeasureString(String, Font, SizeF)	Měří zadaný řetězec při kreslení se zadaným Font řetězcem v zadané oblasti rozložení.
MeasureString(String, Font, Int32)	Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .
MeasureString(ReadOnlySpan<Char>, Font, PointF, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(ReadOnlySpan<Char>, Font, Int32, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(String, Font, PointF, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(String, Font, SizeF, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(String, Font, Int32, StringFormat)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(ReadOnlySpan<Char>, Font, SizeF, StringFormat, Int32, Int32)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .
MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)	Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

layoutArea: SizeF

SizeF určuje maximální oblast rozložení textu.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností řetězce zadaného v parametru text tak, jak je nakresleno s parametrem font a parametrem stringFormat .

Platí pro

MeasureString(ReadOnlySpan<Char>, Font)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností řetězce zadaného parametrem text tak, jak je nakresleno parametrem font .

Platí pro

MeasureString(String, Font)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností řetězce zadaného parametrem text tak, jak je nakresleno parametrem font .

Výjimky

ArgumentException

font je null.

ArgumentNullException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec k měření.
Vytvoří objekt písma a nastaví ho na Arial (16 bodů).
Vytvoří objekt velikosti a použije ho a objekt písma k měření velikosti řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

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

Poznámky

Metoda MeasureString je určená pro použití s jednotlivými řetězci a obsahuje malé množství nadbytečného místa před a za řetězcem, aby bylo možné převist glyfy. Metoda také upraví glyfové body tak, DrawString aby optimalizovaly kvalitu zobrazení, a může zobrazit řetězec užší, než uvádí MeasureString. Pokud chcete získat metriky vhodné pro sousední řetězce v rozložení (například při implementaci formátovaného textu), použijte metodu MeasureCharacterRanges nebo některou StringFormatz MeasureString metod, která přebírá a předává GenericTypographic. Ujistěte se také, že hodnota TextRenderingHint pro Graphics je AntiAlias.

Viz také

Platí pro

MeasureString(ReadOnlySpan<Char>, Font, SizeF)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení se zadaným Font řetězcem v zadané oblasti rozložení.

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

layoutArea: SizeF

SizeF určuje maximální oblast rozložení textu.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností řetězce zadaného parametrem text tak, jak je nakresleno parametrem font .

Platí pro

MeasureString(ReadOnlySpan<Char>, Font, Int32)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font , který definuje formát řetězce.

width: Int32

Maximální šířka řetězce v pixelech.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost řetězce zadaného v parametru textfont v jednotkách určených PageUnit vlastností.

Platí pro

MeasureString(String, Font, SizeF)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení se zadaným Font řetězcem v zadané oblasti rozložení.

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

Parametry

text: String

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

layoutArea: SizeF

SizeF určuje maximální oblast rozložení textu.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností řetězce zadaného parametrem text tak, jak je nakresleno parametrem font .

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma nastavený na Arial (16 bodů).
Nastaví maximální velikost rozložení řetězce.
Vytvoří objekt velikosti a použije ho, objekt písma a maximální velikost rozložení k měření velikosti řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

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

Poznámky

Viz také

Platí pro

MeasureString(String, Font, Int32)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Fontřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font , který definuje formát řetězce.

width: Int32

Maximální šířka řetězce v pixelech.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost řetězce zadaného v parametru textfont v jednotkách určených PageUnit vlastností.

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma nastavený na Arial (16 bodů).
Nastaví maximální šířku řetězce.
Vytvoří objekt velikosti a použije ho, objekt písma a maximální šířku řetězce k měření velikosti řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

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

Poznámky

Parametr width určuje maximální hodnotu komponenty width vrácené SizeF struktury (Width). width Pokud je parametr menší než skutečná šířka řetězce, je vrácená Width komponenta zkrácena na hodnotu představující maximální počet znaků, které se vejdou do zadané šířky. Aby se pojal celý řetězec, je vrácená Height komponenta upravena na hodnotu, která umožňuje zobrazit řetězec se zalamováním znaků.

Viz také

Platí pro

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

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

origin: PointF

PointF , který představuje levý horní roh řetězce.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost v jednotkách určených PageUnit vlastností, řetězce zadaného parametrem text tak, jak je nakresleno parametrem font a parametrem stringFormat .

Platí pro

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

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

width: Int32

Maximální šířka řetězce.

format: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Platí pro

MeasureString(String, Font, PointF, StringFormat)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

origin: PointF

PointF , který představuje levý horní roh řetězce.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma nastavený na Arial (16 bodů).
Vytvoří bod pro vyhledání levého horního rohu řetězce.
Vytvoří objekt formátu řetězce a nastaví jeho příznaky formátu na DirectionVertical.
Vytvoří objekt velikosti pro měření řetězce.
Měří velikost řetězce pomocí řetězce, objektu písma, lokalizačního bodu a formátu řetězce.
Nakreslí červený obdélník pomocí lokalizačního bodu a naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

Výsledkem je svislý obdélník ohraničující svislý řetězec.

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

Poznámky

Viz také

Platí pro

MeasureString(String, Font, SizeF, StringFormat)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font definuje textový formát řetězce.

layoutArea: SizeF

SizeF určuje maximální oblast rozložení textu.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma nastavený na Arial (16 bodů).
Nastaví maximální velikost rozložení řetězce a vytvoří objekt velikosti pro měření řetězce.
Vytvoří objekt formátu řetězce a nastaví jeho příznaky formátu na DirectionVertical.
Měří velikost řetězce pomocí řetězce, objektu písma, maximální velikosti rozložení a formátu řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

Výsledkem je svislý obdélník ohraničující svislý řetězec.

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

Poznámky

Viz také

Platí pro

MeasureString(String, Font, Int32, StringFormat)

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

width: Int32

Maximální šířka řetězce.

format: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

Návraty

SizeF

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma ho nastaví na Arial (16 bodů).
Nastaví maximální šířku řetězce.
Vytvoří objekt formátu řetězce a nastaví jeho příznaky formátu na DirectionVertical.
Vytvoří objekt velikosti pro měření řetězce.
Měří velikost řetězce pomocí řetězce, objektu písma, maximální šířky a formátu řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.

Výsledkem je svislý obdélník ohraničující svislý řetězec.

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

Poznámky

Viz také

Platí pro

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

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: ReadOnlySpan<Char>

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

layoutArea: SizeF

SizeF určuje maximální oblast rozložení textu.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, jako je například řádkování.

charactersFitted: Int32

Počet znaků v řetězci

linesFilled: Int32

Počet textových řádků v řetězci

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost řetězce v jednotkách určených PageUnit vlastností parametru text tak, jak je nakreslený s parametrem font a parametrem stringFormat .

Platí pro

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

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Zdroj:: Graphics.cs

Měří zadaný řetězec při kreslení pomocí zadaného Font a formátovaného pomocí zadaného StringFormatřetězce .

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

Parametry

text: String

Řetězec k měření.

font: Font

Font , který definuje textový formát řetězce.

layoutArea: SizeF

SizeF , která určuje maximální oblast rozložení textu.

stringFormat: StringFormat

StringFormat , který představuje informace o formátování řetězce, například řádkování.

charactersFitted: Int32

Počet znaků v řetězci

linesFilled: Int32

Počet řádků textu v řetězci

Návraty

SizeF

Tato metoda vrátí SizeF strukturu, která představuje velikost řetězce v jednotkách určených PageUnit vlastností parametru text nakresleného pomocí parametru font a parametru stringFormat .

Výjimky

ArgumentException

font je null.

Příklady

Následující příklad kódu je určen pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny Paint události. Kód provede následující akce:

Vytvoří řetězec pro měření a objekt písma nastavený na Arial (16 bodů).
Nastaví maximální velikost rozložení řetězce.
Vytvoří objekt formátu řetězce a nastaví jeho příznaky formátu na DirectionVertical.
Vytvoří celočíselné proměnné charactersFitted a linesFilled objekt velikosti pro měření řetězce.
Měří velikost řetězce a určuje počet znaků a vyplněných řádků pomocí řetězce, objektu písma, maximální velikosti rozložení a formátu řetězce.
Nakreslí červený obdélník pomocí naměřené velikosti řetězce.
Nakreslí řetězec uvnitř nakreslený obdélník.
Vykreslí hodnoty počtu namontovaných znaků a vyplněných řádků.

Výsledkem je svislý obdélník ohraničující svislý řetězec.

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

Poznámky

Metoda MeasureString je určená pro použití s jednotlivými řetězci a obsahuje malé množství nadbytečného místa před a za řetězcem, aby bylo možné převist piktogramy. Metoda také upravuje piktogramy tak, DrawString aby optimalizovaly kvalitu zobrazení, a může zobrazit řetězec užší, než uvádí .MeasureString Pokud chcete získat metriky vhodné pro sousední řetězce v rozložení (například při implementaci formátovaného textu), použijte metodu MeasureCharacterRanges nebo jednu z MeasureString metod, která přijímá StringFormat a předává GenericTypographic. Ujistěte se také, že TextRenderingHint pro Graphics je AntiAlias.

Viz také

Platí pro