FormattedText Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Windows Presentation Foundation (WPF) uygulamalarında metin çizmek için alt düzey denetim sağlar.

public ref class FormattedText

public class FormattedText

type FormattedText = class

Public Class FormattedText

Devralma

Object

FormattedText

Örnekler

Aşağıdaki örnek bir FormattedText nesne oluşturur ve sonra metne birkaç biçimlendirme stili uygular.

protected override void OnRender(DrawingContext drawingContext)
{
    string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";

    // Create the initial formatted text string.
    FormattedText formattedText = new FormattedText(
        testString,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface("Verdana"),
        32,
        Brushes.Black);

    // Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300;
    formattedText.MaxTextHeight = 240;

    // Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    // The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

    // Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11);

    // Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(
                            new LinearGradientBrush(
                            Colors.Orange,
                            Colors.Teal,
                            90.0),
                            6, 11);

    // Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28);

    // Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, new Point(10, 0));
}

Protected Overrides Sub OnRender(ByVal drawingContext As DrawingContext)
    Dim testString As String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor"

    ' Create the initial formatted text string.
    Dim formattedText As New FormattedText(testString, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface("Verdana"), 32, Brushes.Black)

    ' Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300
    formattedText.MaxTextHeight = 240

    ' Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    ' The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5)

    ' Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11)

    ' Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(New LinearGradientBrush(Colors.Orange, Colors.Teal, 90.0), 6, 11)

    ' Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28)

    ' Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, New Point(10, 0))
End Sub

Açıklamalar

FormattedText nesnesi, metindeki her karakterin ayrı ayrı biçimlendirilebildiği çok satırlı metin çizmenize olanak tanır. Aşağıdaki örnekte, çeşitli biçimler uygulanmış metin gösterilmektedir.

Biçimlendirilmiş metin dizesi örneği

WPF'deki metin özellikleri açısından, FormattedText metni grafik öğeleri olarak işlediğinden "alt düzey" olarak kabul edilir. WPF'deki metnin diğer yönleri metinleri metne ayrılmış denetimler bağlamında işler (TextBlock, TextBox), akış belgesi modelini uygulayın (bkz . Akış Belgesine Genel Bakış) veya XPS belge modelini destekler (bkz. WPF'deki belgeler).

içindeki FormattedText ayarlayıcı yöntemlerinin birçoğu tarafından TextElementdesteklenen ekli özelliklerle benzerlik gösterir, ancak TextElement eklenen özellikler akış veya XPS için üst düzey metin desteğine uygulanır.

Oluşturucular

Name	Description
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)	Sınıfın FormattedText yeni bir örneğini belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, ön plan fırçası ve pikselPerDip değeriyle başlatır.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double)	Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, ön plan fırçası, sayı değiştirme davranışı ve pikselPerDip değeri ile sınıfın yeni bir örneğini FormattedText başlatır.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double)	Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, ön plan fırçası, sayı değiştirme davranışı ve pikselPerDip değeri ile sınıfın yeni bir örneğini FormattedText başlatır.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)	Geçersiz. Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, fırça, sayı değiştirme davranışı ve metin biçimlendirme modu ile sınıfın yeni bir örneğini FormattedText başlatır.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)	Geçersiz. Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, fırça ve sayı değiştirme davranışıyla sınıfın yeni bir örneğini FormattedText başlatır.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)	Geçersiz. Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu ve fırça ile sınıfının yeni bir örneğini FormattedText başlatır.

Özellikler

Name	Description
Baseline	İlk satırın üstünden nesnenin ilk satırının taban çizgisine olan uzaklığı FormattedText alır.
Extent	İlk satırın en üstteki çizilmiş pikselinden son satırın en alttaki çizilmiş pikseline olan uzaklığı alır.
FlowDirection	Bir FlowDirection nesnenin öğesini FormattedText alır veya ayarlar.
Height	İlk satırın üstünden nesnenin son satırının en altına olan uzaklığı FormattedText alır.
LineHeight	Metin satırları arasındaki satır yüksekliğini veya satır aralığını alır.
MaxLineCount	Görüntülenecek en fazla satır sayısını alır veya ayarlar. değerini aşan MaxLineCount metin görüntülenmez.
MaxTextHeight	Metin sütununun en yüksek yüksekliğini alır veya ayarlar.
MaxTextWidth	Bir metin satırı için en büyük metin genişliğini (uzunluk) alır veya ayarlar.
MinWidth	Belirtilen metin içeriğini tam olarak içerebilen mümkün olan en küçük metin genişliğini alır.
OverhangAfter	Metnin son satırının altından en alttaki çizilmiş piksele olan uzaklığı alır.
OverhangLeading	Öndeki hizalama noktasından bir çizginin öndeki çizilmiş pikseline kadar olan maksimum uzaklığı alır.
OverhangTrailing	Sondaki mürekkepli pikselden bir çizginin sondaki hizalama noktasına olan maksimum uzaklığı alır.
PixelsPerDip	Metnin işlenmesi gereken PixelsPerDip'i alın veya ayarlar.
Text	Görüntülenecek metin dizesini alır.
TextAlignment	Nesne içindeki FormattedText metnin hizalamasını alır veya ayarlar.
Trimming	Metnin atlandığı araçları alır veya ayarlar.
Width	Bir çizginin başındaki ve sonundaki hizalama noktaları arasındaki genişliği alır ve sondaki boşluk karakterleri hariç olur.
WidthIncludingTrailingWhitespace	Sondaki boşluk karakterleri de dahil olmak üzere bir çizginin baştaki ve sondaki hizalama noktaları arasındaki genişliği alır.

Yöntemler

Name	Description
BuildGeometry(Point)	Tüm glifler ve metin süslemeleri de dahil olmak üzere biçimlendirilmiş metni temsil eden bir Geometry nesne döndürür.
BuildHighlightGeometry(Point, Int32, Int32)	Geometry Biçimlendirilmiş metnin belirtilen alt dizesi için vurgu sınırlayıcı kutusunu temsil eden bir nesne döndürür.
BuildHighlightGeometry(Point)	Biçimlendirilmiş metnin vurgu sınırlayıcı kutusunu temsil eden bir Geometry nesne döndürür.
GetMaxTextWidths()	Metin genişlikleri dizisini alır. Dizideki her öğe, sıralı metin satırlarının en büyük metin genişliğini temsil eder.
SetCulture(CultureInfo, Int32, Int32)	nesnesinde CultureInfoFormattedText belirtilen karakter alt kümesini ayarlar.
SetCulture(CultureInfo)	CultureInfo Nesnedeki karakter kümesinin tamamı için öğesini FormattedText ayarlar.
SetFontFamily(FontFamily, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi ailesini ayarlar.
SetFontFamily(FontFamily)	Bir FormattedText nesne için yazı tipi ailesini ayarlar.
SetFontFamily(String, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi ailesini ayarlar.
SetFontFamily(String)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi ailesini ayarlar.
SetFontSize(Double, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi boyutunu ayarlar.
SetFontSize(Double)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi boyutunu ayarlar.
SetFontStretch(FontStretch, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi genişletme değerini ayarlar.
SetFontStretch(FontStretch)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi genişletme değerini ayarlar.
SetFontStyle(FontStyle, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi stilini ayarlar.
SetFontStyle(FontStyle)	Nesnedeki tüm karakter FormattedText kümesinin yazı tipi stilini ayarlar.
SetFontTypeface(Typeface, Int32, Int32)	Nesnedeki belirli bir karakter FormattedText alt kümesi için yazı tipi yazı tipini ayarlar.
SetFontTypeface(Typeface)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi yazı tipini ayarlar.
SetFontWeight(FontWeight, Int32, Int32)	Nesne FontWeight içinde FormattedText belirtilen metnin değerini değiştirir.
SetFontWeight(FontWeight)	Nesnedeki tüm karakter kümesinin yazı tipi kalınlığını FormattedText ayarlar.
SetForegroundBrush(Brush, Int32, Int32)	Nesne içinde Brush belirtilen metin için ön planı FormattedText değiştirir.
SetForegroundBrush(Brush)	Nesnenin tamamı Brush için ön planı FormattedText değiştirir.
SetMaxTextWidths(Double[])	içindeki en büyük metin genişliklerinden oluşan bir diziyi FormattedTextsatır başına olarak ayarlar. Dizideki her öğe, sıralı metin satırlarının en büyük metin genişliğini temsil eder.
SetNumberSubstitution(NumberSubstitution, Int32, Int32)	Nesne FormattedText içinde belirtilen metin için sayı değiştirme davranışını ayarlar.
SetNumberSubstitution(NumberSubstitution)	Nesnedeki karakter FormattedText kümesinin tamamı için sayı değiştirme davranışını ayarlar.
SetTextDecorations(TextDecorationCollection, Int32, Int32)	Bir TextDecorationCollection nesne içinde FormattedText belirtilen metin için değerini ayarlar.
SetTextDecorations(TextDecorationCollection)	TextDecorationCollection Nesnedeki karakter kümesinin tamamı için öğesini FormattedText ayarlar.

Ayrıca bkz.

• GlyphRun
• DrawingContext