TextFormatter Sınıf

Tanım

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Devralma

Object

TextFormatter

Uygulamalar

IDisposable

Örnekler

Aşağıdaki örnekte, çizim nesneleri olarak görüntülenebilen biçimlendirilmiş metin satırları oluşturmak için nesnenin TextFormatter nasıl kullanılacağı gösterilmektedir.

// Create a TextFormatter object.
TextFormatter formatter = TextFormatter.Create();

// Create common paragraph property settings.
CustomTextParagraphProperties customTextParagraphProperties
    = new CustomTextParagraphProperties();

// Format each line of text from the text store and draw it.
while (textStorePosition < customTextSource.Text.Length)
{
    // Create a textline from the text store using the TextFormatter object.
    using (TextLine myTextLine = formatter.FormatLine(
        customTextSource,
        textStorePosition,
        96 * 6,
        customTextParagraphProperties,
        null))
    {
        // Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None);

        // Update the index position in the text store.
        textStorePosition += myTextLine.Length;

        // Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height;
    }
}

' Create a TextFormatter object.
Dim formatter As TextFormatter = TextFormatter.Create()

' Create common paragraph property settings.
Dim customTextParagraphProperties As New CustomTextParagraphProperties()

' Format each line of text from the text store and draw it.
Do While textStorePosition < customTextSource.Text.Length
    ' Create a textline from the text store using the TextFormatter object.
    Using myTextLine As TextLine = formatter.FormatLine(customTextSource, textStorePosition, 96 * 6, customTextParagraphProperties, Nothing)
        ' Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None)

        ' Update the index position in the text store.
        textStorePosition += myTextLine.Length

        ' Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height
    End Using
Loop

Açıklamalar

TextFormatter , metin biçimlendirme ve metin satırlarını kesmeye yönelik hizmetler sağlayan WPF metin altyapısıdır. TextFormatter farklı metin karakter biçimlerini ve paragraf stillerini işleyebilir ve uluslararası metin düzeni desteği içerir.

Geleneksel metin API'sinin aksine, TextFormatter bir dizi geri çağırma yöntemi aracılığıyla bir metin düzeni istemcisiyle etkileşim kurar. İstemcinin sınıfın bir uygulamasında bu yöntemleri sağlamasını TextSource gerektirir. Aşağıdaki diyagramda, metin biçimlendirici istemcisi ile metin düzeni istemcisinin etkileşimi gösterilmektedir.

Metin düzeni istemcisi ile TextFormatter nesnesi arasındaki etkileşim

Metin Biçimlendirme Hizmetleri

TextFormatter OpenType tipografisi gibi metin özelliklerine yönelik desteğin yanı sıra metin çalıştırması, satır ve paragraf düzeyi özellikleri için destek sağlar.

Aşağıdaki tabloda, metin özellikleri için desteklenen temel TextFormatter hizmetlerin listesi yer alır.

Aşağıdaki tablo, paragraf düzeyi özellikler için desteklenen temel TextFormatter hizmetlerin listesidir.

Aşağıdaki tabloda satır düzeyi özellikler için desteklenen temel TextFormatter hizmetlerin listesi yer alır.

Aşağıdaki tablo, metin çalışma düzeyi özellikleri için desteklenen temel TextFormatter hizmetlerin listesidir.

Oluşturucular

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• Gelişmiş Metin Biçimlendirme Örneği