FormattedText Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Media

Bütünleştirilmiş Kod:: PresentationCore.dll

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

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 çeşitli biçimlendirme stilleri 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 tek tek biçimlendirilebileceği çok satırlı metin çizmenize olanak tanır. Aşağıdaki örnekte, birkaç biçim uygulanmış metin gösterilmektedir.

FormattedText nesnesi kullanılarak görüntülenen metin 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 metni metne ayrılmış denetimler bağlamında işler (TextBlock, TextBox), akış belgesi modelini uygular (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 benzerliklere sahiptir, ancak TextElement ekli özellikler akış veya XPS için üst düzey metin desteği için geçerlidir.

Oluşturucular

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.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)	Belirtilen metin, kültür, akış yönü, yazı biçimi, yazı tipi boyutu, ön plan fırçası ve pikselPerDip değeriyle sınıfını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ın yeni bir örneğini FormattedText 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ı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, 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ın yeni bir örneğini FormattedText başlatır.

Özellikler

Baseline	İlk satırın üstünden nesnenin ilk satırının taban çizgisine olan uzaklığı FormattedText alır.
Extent	İlk çizginin en üstteki çizilmiş pikselinden son çizginin en alttaki çizilmiş pikseline olan uzaklığı alır.
FlowDirection	Bir FormattedText nesnenin öğesini FlowDirection alır veya ayarlar.
Height	İlk satırın üstünden nesnenin son satırının altına olan mesafeyi 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 (uzunluğu) 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	Baştaki hizalama noktasından bir çizginin baştaki çizilmiş pikseline kadar olan maksimum uzaklığı alır.
OverhangTrailing	Sondaki mürekkeple gösterilen pikselden bir çizginin sonundaki 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 FormattedText içindeki metnin hizalamasını alır veya ayarlar.
Trimming	Metnin atlandığı ortalamayı alır veya ayarlar.
Width	Bir satırın başındaki ve sonundaki hizalama noktaları arasındaki genişliği alır ve sonundaki boşluk karakterlerini dışlar.
WidthIncludingTrailingWhitespace	Bir çizginin başındaki ve sonundaki hizalama noktaları arasındaki genişliği (sondaki boşluk karakterleri dahil) alır.

Yöntemler

BuildGeometry(Point)	Tüm glifler ve metin süslemeleri dahil olmak üzere biçimlendirilmiş metni temsil eden bir Geometry 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.
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.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetMaxTextWidths()	Metin genişliklerinden oluşan bir dizi alır. Dizideki her öğe, sıralı metin satırlarının en büyük metin genişliğini temsil eder.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
SetCulture(CultureInfo)	CultureInfo nesnesindeki tüm karakter kümesinin değerini FormattedText ayarlar.
SetCulture(CultureInfo, Int32, Int32)	nesnesinde CultureInfo FormattedText belirtilen karakter alt kümesini ayarlar.
SetFontFamily(FontFamily)	Bir FormattedText nesne için yazı tipi ailesini ayarlar.
SetFontFamily(FontFamily, Int32, Int32)	Nesnedeki belirtilen 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.
SetFontFamily(String, Int32, Int32)	Nesnedeki belirtilen karakter FormattedText alt kümesi için yazı tipi ailesini ayarlar.
SetFontSize(Double)	Nesnedeki tüm karakter FormattedText kümesinin yazı tipi boyutunu ayarlar.
SetFontSize(Double, Int32, Int32)	Nesnedeki belirtilen karakter FormattedText alt kümesi için yazı tipi boyutunu ayarlar.
SetFontStretch(FontStretch)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi uzatma değerini ayarlar.
SetFontStretch(FontStretch, Int32, Int32)	Nesnedeki belirtilen karakter FormattedText alt kümesi için yazı tipi esnetme değerini ayarlar.
SetFontStyle(FontStyle)	Nesnedeki karakter FormattedText kümesinin tamamı için yazı tipi stilini ayarlar.
SetFontStyle(FontStyle, Int32, Int32)	Nesnedeki belirtilen karakter FormattedText alt kümesi için yazı tipi stilini ayarlar.
SetFontTypeface(Typeface)	Nesnedeki tüm karakter FormattedText kümesinin yazı tipi yazı tipini ayarlar.
SetFontTypeface(Typeface, Int32, Int32)	Nesnedeki belirtilen karakter FormattedText alt kümesi için yazı tipi yazı tipini ayarlar.
SetFontWeight(FontWeight)	Nesnedeki tüm karakter kümesinin yazı tipi kalınlığını FormattedText ayarlar.
SetFontWeight(FontWeight, Int32, Int32)	Nesne FormattedText içinde FontWeight belirtilen metnin değerini değiştirir.
SetForegroundBrush(Brush)	Nesnenin tamamı FormattedText için ön planı Brush değiştirir.
SetForegroundBrush(Brush, Int32, Int32)	Nesne FormattedText içinde belirtilen metin için ön planı Brush 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)	Nesnedeki karakter FormattedText kümesinin tamamı için sayı değiştirme davranışını ayarlar.
SetNumberSubstitution(NumberSubstitution, Int32, Int32)	Nesne FormattedText içinde belirtilen metin için sayı değiştirme davranışını ayarlar.
SetTextDecorations(TextDecorationCollection)	TextDecorationCollection nesnesindeki tüm karakter kümesinin değerini FormattedText ayarlar.
SetTextDecorations(TextDecorationCollection, Int32, Int32)	Bir FormattedText nesne içinde TextDecorationCollection belirtilen metin için değerini ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır