Graphics.MeasureCharacterRanges Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Aşırı Yüklemeler

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

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Kaynak:

Graphics.cs

Her biri Region belirtilen dize içindeki bir karakter konumları aralığını sınırlayan bir nesne 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

Font dizenin metin biçimini tanımlar.

layoutRect

RectangleF

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

stringFormat

StringFormat

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

Döndürülenler

Region[]

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

Özel durumlar

ArgumentNullException

font, null değeridir.

Örnekler

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

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

• 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.

• ekrana iki dikdörtgen çizer.

Sonuç, ilk aralığın ("İlk") kırmızı dikdörtgenle, ikinci aralığın ("İkinci") mavi dikdörtgenle sınırlandığı 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ünürlüğe bağımlı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)

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

Kaynak:

Graphics.cs

Her biri Region belirtilen dize içindeki bir karakter konumları aralığını sınırlayan bir nesne 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

Font dizenin metin biçimini tanımlar.

layoutRect

RectangleF

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

stringFormat

StringFormat

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

Döndürülenler

Region[]

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