Graphics.MeasureCharacterRanges Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Überlädt

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)	Ruft ein Array von Region-Objekten ab, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.
MeasureCharacterRanges(ReadOnlySpan<Char>, Font, RectangleF, StringFormat)	Ruft ein Array von Region-Objekten ab, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Quelle:

Graphics.cs

Ruft ein Array von Region-Objekten ab, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.

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, das Formatierungsinformationen für die Zeichenfolge darstellt, z. B. Zeilenabstand.

Gibt zurück

Region[]

Diese Methode gibt ein Array von Region-Objekten zurück, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.

Ausnahmen

ArgumentNullException

font ist null

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. 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 den Bildschirm.

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

• Zeichnet die beiden Rechtecke auf den Bildschirm.

Das Ergebnis ist die angezeigte Zeichenfolge, wobei der erste Bereich ("First") durch ein rotes Rechteck und der zweite Bereich ("Second") 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, sodass es zu einem leichten Genauigkeitsverlust kommen kann, wenn Zeichenfolgen in einer Metadatei mit einer Auflösung aufgezeichnet und später mit einer anderen Auflösung wiedergegeben werden.

Weitere Informationen

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

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

Quelle:

Graphics.cs

Ruft ein Array von Region-Objekten ab, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.

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, das Formatierungsinformationen für die Zeichenfolge darstellt, z. B. Zeilenabstand.

Gibt zurück

Region[]

Diese Methode gibt ein Array von Region-Objekten zurück, von denen jedes einen Bereich von Zeichenpositionen in der angegebenen Zeichenfolge umschließt.