Graphics.MeasureCharacterRanges Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Überlädt

MeasureCharacterRanges(ReadOnlySpan<Char>, Font, RectangleF, StringFormat)	Ruft ein Array von Region -Objekten ab, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.
MeasureCharacterRanges(String, Font, RectangleF, StringFormat)	Ruft ein Array von Region -Objekten ab, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.

MeasureCharacterRanges(ReadOnlySpan<Char>, Font, RectangleF, StringFormat)

Ruft ein Array von Region -Objekten ab, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.

public:
 cli::array <System::Drawing::Region ^> ^ MeasureCharacterRanges(ReadOnlySpan<char> text, System::Drawing::Font ^ font, System::Drawing::RectangleF layoutRect, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.Region[] MeasureCharacterRanges (ReadOnlySpan<char> text, System.Drawing.Font font, System.Drawing.RectangleF layoutRect, System.Drawing.StringFormat? stringFormat);

member this.MeasureCharacterRanges : ReadOnlySpan<char> * System.Drawing.Font * System.Drawing.RectangleF * System.Drawing.StringFormat -> System.Drawing.Region[]

Public Function MeasureCharacterRanges (text As ReadOnlySpan(Of Char), font As Font, layoutRect As RectangleF, stringFormat As StringFormat) As Region()

Parameter

text

ReadOnlySpan<Char>

Zu messende Zeichenfolge.

font

Font

Font, die das Textformat der Zeichenfolge definiert.

layoutRect

RectangleF

RectangleF Struktur, die das Layoutrechteck für die Zeichenfolge angibt.

stringFormat

StringFormat

StringFormat, die Formatierungsinformationen wie zeilenabstand für die Zeichenfolge darstellt.

Gibt zurück

Region[]

Diese Methode gibt ein Array von Region Objekten zurück, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Ruft ein Array von Region -Objekten ab, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.

public:
 cli::array <System::Drawing::Region ^> ^ MeasureCharacterRanges(System::String ^ text, System::Drawing::Font ^ font, System::Drawing::RectangleF layoutRect, System::Drawing::StringFormat ^ stringFormat);

public System.Drawing.Region[] MeasureCharacterRanges (string? text, System.Drawing.Font font, System.Drawing.RectangleF layoutRect, System.Drawing.StringFormat? stringFormat);

member this.MeasureCharacterRanges : string * System.Drawing.Font * System.Drawing.RectangleF * System.Drawing.StringFormat -> System.Drawing.Region[]

Public Function MeasureCharacterRanges (text As String, font As Font, layoutRect As RectangleF, stringFormat As StringFormat) As Region()

Parameter

text

String

Zu messende Zeichenfolge.

font

Font

Font, die das Textformat der Zeichenfolge definiert.

layoutRect

RectangleF

RectangleF Struktur, die das Layoutrechteck für die Zeichenfolge angibt.

stringFormat

StringFormat

StringFormat, die Formatierungsinformationen wie zeilenabstand für die Zeichenfolge darstellt.

Gibt zurück

Region[]

Diese Methode gibt ein Array von Region Objekten zurück, von denen jeder einen Bereich von Zeichenpositionen innerhalb der angegebenen Zeichenfolge begrenzt.

Ausnahmen

ArgumentNullException

font ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Legt eine Zeichenfolge "Erster und zweiter Bereich" und eine Schriftart für die Anzeige der Zeichenfolge ("Times New Roman", 16 Punkt) fest.

• Legt zwei Zeichenbereiche innerhalb der Zeichenfolge fest (die den Wörtern "First" und "Second") entsprechen.

• Erstellt ein Rechteck, in dem die Zeichenfolge angezeigt werden soll.

• Legt die Formatierung der Zeichenfolge 3/4 einschließlich der beiden Zeichenbereiche fest.

• Zeichnet die Zeichenfolge auf dem Bildschirm.

• Misst die Zeichenbereiche, bestimmt Rechtecke, die die beiden angegebenen Bereiche gebunden haben.

• Zeichnet die beiden Rechtecke auf den Bildschirm.

Das Ergebnis ist die angezeigte Zeichenfolge mit dem ersten Bereich ("First"), der durch ein rotes Rechteck und den zweiten Bereich ("Second") begrenzt durch ein blaues Rechteck begrenzt ist.

public:
   void MeasureCharacterRangesRegions( PaintEventArgs^ e )
   {
      // Set up string.
      String^ measureString = "First and Second ranges";
      System::Drawing::Font^ stringFont = gcnew System::Drawing::Font( "Times New Roman",16.0F );

      // Set character ranges to "First" and "Second".
      array<CharacterRange>^ characterRanges = {CharacterRange(0,5),CharacterRange(10,6)};

      // Create rectangle for layout.
      float x = 50.0F;
      float y = 50.0F;
      float width = 35.0F;
      float height = 200.0F;
      RectangleF layoutRect = RectangleF(x,y,width,height);

      // Set string format.
      StringFormat^ stringFormat = gcnew StringFormat;
      stringFormat->FormatFlags = StringFormatFlags::DirectionVertical;
      stringFormat->SetMeasurableCharacterRanges( characterRanges );

      // Draw string to screen.
      e->Graphics->DrawString( measureString, stringFont, Brushes::Black, x, y, stringFormat );

      // Measure two ranges in string.
      array<System::Drawing::Region^>^stringRegions = e->Graphics->MeasureCharacterRanges( measureString, 
    stringFont, layoutRect, stringFormat );

      // Draw rectangle for first measured range.
      RectangleF measureRect1 = stringRegions[ 0 ]->GetBounds( e->Graphics );
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), Rectangle::Round( measureRect1 ) );

      // Draw rectangle for second measured range.
      RectangleF measureRect2 = stringRegions[ 1 ]->GetBounds( e->Graphics );
      e->Graphics->DrawRectangle( gcnew Pen( Color::Blue,1.0f ), Rectangle::Round( measureRect2 ) );
   }

private void MeasureCharacterRangesRegions(PaintEventArgs e)
{

    // Set up string.
    string measureString = "First and Second ranges";
    Font stringFont = new Font("Times New Roman", 16.0F);

    // Set character ranges to "First" and "Second".
    CharacterRange[] characterRanges = { new CharacterRange(0, 5), new CharacterRange(10, 6) };

    // Create rectangle for layout.
    float x = 50.0F;
    float y = 50.0F;
    float width = 35.0F;
    float height = 200.0F;
    RectangleF layoutRect = new RectangleF(x, y, width, height);

    // Set string format.
    StringFormat stringFormat = new StringFormat();
    stringFormat.FormatFlags = StringFormatFlags.DirectionVertical;
    stringFormat.SetMeasurableCharacterRanges(characterRanges);

    // Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, x, y, stringFormat);

    // Measure two ranges in string.
    Region[] stringRegions = e.Graphics.MeasureCharacterRanges(measureString, 
stringFont, layoutRect, stringFormat);

    // Draw rectangle for first measured range.
    RectangleF measureRect1 = stringRegions[0].GetBounds(e.Graphics);
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1), Rectangle.Round(measureRect1));

    // Draw rectangle for second measured range.
    RectangleF measureRect2 = stringRegions[1].GetBounds(e.Graphics);
    e.Graphics.DrawRectangle(new Pen(Color.Blue, 1), Rectangle.Round(measureRect2));
}

Private Sub MeasureCharacterRangesRegions(ByVal e As PaintEventArgs)

    ' Set up string.
    Dim measureString As String = "First and Second ranges"
    Dim stringFont As New Font("Times New Roman", 16.0F)

    ' Set character ranges to "First" and "Second".
    Dim characterRanges As CharacterRange() = _
    {New CharacterRange(0, 5), New CharacterRange(10, 6)}

    ' Create rectangle for layout.
    Dim x As Single = 50.0F
    Dim y As Single = 50.0F
    Dim width As Single = 35.0F
    Dim height As Single = 200.0F
    Dim layoutRect As New RectangleF(x, y, width, height)

    ' Set string format.
    Dim stringFormat As New StringFormat
    stringFormat.FormatFlags = StringFormatFlags.DirectionVertical
    stringFormat.SetMeasurableCharacterRanges(characterRanges)

    ' Draw string to screen.
    e.Graphics.DrawString(measureString, stringFont, Brushes.Black, _
    x, y, stringFormat)

    ' Measure two ranges in string.
    Dim stringRegions() As [Region] = e.Graphics.MeasureCharacterRanges(measureString, _
stringFont, layoutRect, stringFormat)

    ' Draw rectangle for first measured range.
    Dim measureRect1 As RectangleF = _
    stringRegions(0).GetBounds(e.Graphics)
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), _
    Rectangle.Round(measureRect1))

    ' Draw rectangle for second measured range.
    Dim measureRect2 As RectangleF = _
    stringRegions(1).GetBounds(e.Graphics)
    e.Graphics.DrawRectangle(New Pen(Color.Blue, 1), _
    Rectangle.Round(measureRect2))
End Sub

Hinweise

Die von dieser Methode zurückgegebenen Regionen sind auflösungsabhängig, daher kann es zu einem leichten Genauigkeitsverlust kommen, wenn Zeichenfolgen in einer Metadatei mit einer Auflösung aufgezeichnet und später in einer anderen Auflösung wiedergegeben werden.

Weitere Informationen

• MeasureString(String, Font)
• MeasureText(IDeviceContext, String, Font, Size, TextFormatFlags)