Graphics.MeasureCharacterRanges Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Aşırı Yüklemeler

MeasureCharacterRanges(ReadOnlySpan<Char>, Font, RectangleF, StringFormat)	Her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi alır.
MeasureCharacterRanges(String, Font, RectangleF, StringFormat)	Her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi alır.

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

Kaynak:

Graphics.cs

Her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi alır.

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()

Parametreler

text

ReadOnlySpan<Char>

Ölçülecek dize.

font

Font

Dizenin metin biçimini tanımlayan Font.

layoutRect

RectangleF

dize için düzen dikdörtgenini belirten RectangleF yapısı.

stringFormat

StringFormat

dize için satır aralığı gibi biçimlendirme bilgilerini temsil eden StringFormat.

Döndürülenler

Region[]

Bu yöntem, her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi döndürür.

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Kaynak:

Graphics.cs

Her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi alır.

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()

Parametreler

text

String

Ölçülecek dize.

font

Font

Dizenin metin biçimini tanımlayan Font.

layoutRect

RectangleF

dize için düzen dikdörtgenini belirten RectangleF yapısı.

stringFormat

StringFormat

dize için satır aralığı gibi biçimlendirme bilgilerini temsil eden StringFormat.

Döndürülenler

Region[]

Bu yöntem, her biri belirtilen dize içindeki karakter konumları aralığını sınırlayan bir Region nesnesi dizisi döndürür.

Özel durumlar

ArgumentNullException

font null.

Örnekler

Aşağıdaki kod örneği Windows Forms ile kullanılmak üzere tasarlanmıştır ve Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod aşağıdaki eylemleri gerçekleştirir:

• Dizenin görüntülenmesi için "Birinci ve İkinci aralıklar" dizesini ve yazı tipini ("Times New Roman", 16 punto) ayarlar.

• Dize içinde iki karakter aralığı ayarlar ("İlk" ve "İkinci" sözcüklerine karşılık gelir).

• Dizenin görüntüleneceği bir dikdörtgen oluşturur.

• İki karakter aralığı dahil olmak üzere 3/4 dizesinin biçimlendirmesini ayarlar.

• Dizeyi ekrana çizer.

• Karakter aralıklarını ölçer, belirtilen iki aralığı sınırlayan dikdörtgenleri belirler.

• İki dikdörtgeni ekrana çizer.

Sonuç, ilk aralık ("İlk") kırmızı dikdörtgenle sınırlanmış ve ikinci aralık ("saniye") mavi dikdörtgenle sınırlanmış olarak görüntülenen dizedir.

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

Açıklamalar

Bu yöntem tarafından döndürülen bölgeler çözüme bağlıdır, bu nedenle dizeler bir meta dosyaya tek çözünürlükte kaydedilirse ve daha sonra farklı bir çözünürlükte oynatılırsa hafif bir doğruluk kaybı olabilir.

Ayrıca bkz.

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