Graphics.MeasureCharacterRanges Yöntem

Başvuru

Tanım

Ad Alanı:: System.Drawing

Bütünleştirilmiş Kod:: System.Drawing.Common.dll

Bütünleştirilmiş Kod:: System.Drawing.dll

Paket:: System.Drawing.Common v10.0.0-preview.1.25080.3

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Kaynak:: Graphics.cs

Kaynak:: Graphics.cs

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.

Şunlara uygulanır

.NET 10 (package-provided) ve diğer sürümler

Ürün	Sürümler
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
Windows Desktop	8, 9, 10

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Kaynak:: Graphics.cs

Kaynak:: Graphics.cs

Kaynak:: Graphics.cs

Kaynak:: Graphics.cs

Kaynak:: Graphics.cs

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

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.

Şunlara uygulanır

.NET 10 (package-provided) ve diğer sürümler

Ürün	Sürümler
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Aracılığıyla paylaş

Graphics.MeasureCharacterRanges Yöntem

Tanım

Aşırı Yüklemeler

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

Parametreler

Döndürülenler

Şunlara uygulanır

MeasureCharacterRanges(String, Font, RectangleF, StringFormat)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar