FormattedText Sınıf

Tanım

Windows Presentation Foundation (WPF) uygulamalarında metin çizmek için alt düzey denetim sağlar.Provides low-level control for drawing text in Windows Presentation Foundation (WPF) applications.

public ref class FormattedText
public class FormattedText
type FormattedText = class
Public Class FormattedText
Devralma
FormattedText

Örnekler

Aşağıdaki örnek, bir FormattedText nesnesi oluşturur ve sonra metne birkaç biçimlendirme stili uygular.The following example creates a FormattedText object and then applies several formatting styles to the text.

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

FormattedTextNesnesi, metin içindeki her karakterin ayrı ayrı biçimlendirilebileceği çok satırlı metin çizmenizi sağlar.The FormattedText object allows you to draw multi-line text, in which each character in the text can be individually formatted. Aşağıdaki örnek, birkaç biçimin uygulanmış olduğu metni gösterir.The following example shows text that has several formats applied to it.

FormattedText nesnesi kullanılarak görünen metinText displayed using FormattedText object
Biçimlendirilen metin dizesi örneğiExample of a formatted text string

WPF 'deki metin özellikleri bakımından FormattedText "alt düzey" olarak değerlendirilir ve metin grafik öğeleri olarak işlenir.In terms of text features in WPF, FormattedText is considered "low-level" because it processes text as graphical elements. WPF 'deki metnin diğer yönleri metin (,) için ayrılan denetimlerin bağlamındaki metni işler TextBlock TextBox , Flow belge modelini uygular ( Flow belgesine genel bakış) veya XPS belge MODELINI (bkz. WPF içindeki belgeler) destekler.Other aspects of text in WPF handle text in the context of controls that are dedicated to text (TextBlock, TextBox), implement the flow document model (see Flow Document Overview), or support the XPS document model (see Documents in WPF).

İçindeki ayarlayıcı yöntemlerinin birçoğu FormattedText tarafından desteklenen iliştirilmiş özelliklere benzerlikler vardır TextElement , ancak TextElement ekli ÖZELLIKLER Flow veya XPS için üst düzey metin desteği için geçerlidir.Many of the setter methods in FormattedText have similarities to attached properties that are supported by TextElement, but the TextElement attached properties apply to the higher-level text support either for flow or XPS.

Oluşturucular

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)
Kullanımdan kalktı.

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi boyutu ve fırça ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, and brush.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi boyutu, ön plan fırçası ve Pixelsperdıp değeri ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, and pixelsPerDip value.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)
Kullanımdan kalktı.

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi boyutu, fırça ve sayı değiştirme davranışıyla sınıfının yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, brush, and number substitution behavior.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double)

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi, yazı tipi boyutu, ön plan Fırçası, sayı değiştirme davranışı ve Pixelsperdıp değeri ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, number substitution behavior, and pixelsPerDip value.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)
Kullanımdan kalktı.

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi boyutu, fırça, sayı değiştirme davranışı ve metin biçimlendirme moduyla sınıfın yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, brush, number substitution behavior, and text formatting mode.

FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double)

FormattedTextBelirtilen metin, kültür, akış yönü, yazı tipi, yazı tipi boyutu, ön plan Fırçası, sayı değiştirme davranışı ve Pixelsperdıp değeri ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the FormattedText class with the specified text, culture, flow direction, typeface, font size, foreground brush, number substitution behavior, and pixelsPerDip value.

Özellikler

Baseline

İlk satırın en üstünden bir nesnenin ilk satırının taban çizgisine kadar olan mesafeyi alır FormattedText .Gets the distance from the top of the first line to the baseline of the first line of a FormattedText object.

Extent

İlk satırın en üstteki çizilmiş pikselinden son satırın en alttaki çizilmiş pikselden uzaklığı alır.Gets the distance from the topmost drawn pixel of the first line to the bottommost drawn pixel of the last line.

FlowDirection

Bir nesneyi alır veya ayarlar FlowDirection FormattedText .Gets or sets the FlowDirection of a FormattedText object.

Height

İlk satırın en üstünden nesnenin son satırının sonuna kadar olan mesafeyi alır FormattedText .Gets the distance from the top of the first line to the bottom of the last line of the FormattedText object.

LineHeight

Metin satırları arasında çizgi yüksekliğini veya satır aralığını alır.Gets the line height, or line spacing, between lines of text.

MaxLineCount

Görüntülenecek satır sayısının üst sınırını alır veya ayarlar.Gets or sets the maximum number of lines to display. Aşmayacak metin MaxLineCount görüntülenmeyecek.Text exceeding the MaxLineCount will not be displayed.

MaxTextHeight

Bir metin sütununun en büyük yüksekliğini alır veya ayarlar.Gets or sets the maximum height of a text column.

MaxTextWidth

Metin çizgisi için maksimum metin genişliğini (uzunluk) alır veya ayarlar.Gets or sets the maximum text width (length) for a line of text.

MinWidth

Belirtilen metin içeriğini tam olarak içerebilen, olası en küçük metin genişliğini alır.Gets the smallest possible text width that can fully contain the specified text content.

OverhangAfter

Metnin son satırının alt kısmından en alttaki çizilmiş piksele kadar olan mesafeyi alır.Gets the distance from the bottom of the last line of text to the bottommost drawn pixel.

OverhangLeading

Baştaki hizalama noktasından, bir satırın baştaki çizilme pikseline kadar olan en büyük mesafeyi alır.Gets the maximum distance from the leading alignment point to the leading drawn pixel of a line.

OverhangTrailing

Sonundaki pikselin son hizalama noktasına kadar olan en fazla mesafeyi alır.Gets the maximum distance from the trailing inked pixel to the trailing alignment point of a line.

PixelsPerDip

Metnin işlenmesi gereken Pixelsperdıp 'i alır veya ayarlar.Get or sets the PixelsPerDip at which the text should be rendered.

Text

Görüntülenecek metin dizesini alır.Gets the string of text to be displayed.

TextAlignment

Bir nesne içindeki metnin hizalamasını alır veya ayarlar FormattedText .Gets or sets the alignment of text within a FormattedText object.

Trimming

Metnin atlanmasından belirtilen anlama sayısını alır veya ayarlar.Gets or sets the means by which the omission of text is indicated.

Width

Sondaki boşluk karakterlerinden hariç olmak üzere bir çizginin önde gelen ve sondaki hizalama noktaları arasındaki genişliği alır.Gets the width between the leading and trailing alignment points of a line, excluding any trailing white-space characters.

WidthIncludingTrailingWhitespace

Sondaki boşluk karakterleri de dahil olmak üzere bir çizginin önde gelen ve sondaki hizalama noktaları arasındaki genişliği alır.Gets the width between the leading and trailing alignment points of a line, including any trailing white-space characters.

Yöntemler

BuildGeometry(Point)

GeometryTüm Glifler ve metin süslemeleri dahil olmak üzere, biçimlendirilen metni temsil eden bir nesne döndürür.Returns a Geometry object that represents the formatted text, including all glyphs and text decorations.

BuildHighlightGeometry(Point)

GeometryBiçimlendirilen metnin açıkton sınırlayıcı kutusunu temsil eden bir nesne döndürür.Returns a Geometry object that represents the highlight bounding box of the formatted text.

BuildHighlightGeometry(Point, Int32, Int32)

GeometryBiçimlendirilen metnin belirtilen alt dizesi için vurgulu sınırlayıcı kutusunu temsil eden bir nesne döndürür.Returns a Geometry object that represents the highlight bounding box for a specified substring of the formatted text.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetMaxTextWidths()

Metin genişliklerinin dizisini alır.Retrieves an array of text widths. Dizideki her öğe, metnin sıralı satırlarının maksimum metin genişliğini temsil eder.Each element in the array represents the maximum text width of sequential lines of text.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
SetCulture(CultureInfo)

CultureInfoNesnesindeki tüm karakter kümesi için öğesini ayarlar FormattedText .Sets the CultureInfo for the entire set of characters in the FormattedText object.

SetCulture(CultureInfo, Int32, Int32)

CultureInfoNesnedeki belirli bir karakter alt kümesi için öğesini ayarlar FormattedText .Sets the CultureInfo for a specified subset of characters in the FormattedText object.

SetFontFamily(FontFamily)

Bir nesne için yazı tipi ailesini ayarlar FormattedText .Sets the font family for a FormattedText object.

SetFontFamily(FontFamily, Int32, Int32)

Nesne içindeki belirli bir karakter alt kümesi için yazı tipi ailesini ayarlar FormattedText .Sets the font family for a specified subset of characters in the FormattedText object.

SetFontFamily(String)

Nesne içindeki tüm karakter kümesinin yazı tipi ailesini ayarlar FormattedText .Sets the font family for the entire set of characters in the FormattedText object.

SetFontFamily(String, Int32, Int32)

Nesne içindeki belirli bir karakter alt kümesi için yazı tipi ailesini ayarlar FormattedText .Sets the font family for a specified subset of characters in the FormattedText object.

SetFontSize(Double)

Nesnedeki tüm karakter kümesinin yazı tipi boyutunu ayarlar FormattedText .Sets the font size for the entire set of characters in the FormattedText object.

SetFontSize(Double, Int32, Int32)

Nesnedeki belirli bir karakter alt kümesi için yazı tipi boyutunu ayarlar FormattedText .Sets the font size for a specified subset of characters in the FormattedText object.

SetFontStretch(FontStretch)

Nesnedeki tüm karakter kümesinin yazı tipi uzatma değerini ayarlar FormattedText .Sets the font stretch value for the entire set of characters in the FormattedText object.

SetFontStretch(FontStretch, Int32, Int32)

Nesnedeki belirli bir karakter alt kümesi için yazı tipi uzatma değerini ayarlar FormattedText .Sets the font stretch value for a specified subset of characters in the FormattedText object.

SetFontStyle(FontStyle)

Nesnedeki tüm karakter kümesinin yazı tipi stilini ayarlar FormattedText .Sets the font style for the entire set of characters in the FormattedText object.

SetFontStyle(FontStyle, Int32, Int32)

Nesnedeki belirli bir karakter alt kümesi için yazı tipi stilini ayarlar FormattedText .Sets the font style for a specified subset of characters in the FormattedText object.

SetFontTypeface(Typeface)

Nesnedeki tüm karakter kümesinin yazı tipi yazı biçimini ayarlar FormattedText .Sets the font typeface for the entire set of characters in the FormattedText object.

SetFontTypeface(Typeface, Int32, Int32)

Nesnedeki belirli bir karakter alt kümesi için yazı tipi yazı biçimini ayarlar FormattedText .Sets the font typeface for a specified subset of characters in the FormattedText object.

SetFontWeight(FontWeight)

Nesnedeki tüm karakter kümesinin yazı tipi kalınlığını ayarlar FormattedText .Sets the font weight for the entire set of characters in the FormattedText object.

SetFontWeight(FontWeight, Int32, Int32)

FontWeightBir nesne içindeki belirtilen metin için değiştirir FormattedText .Changes the FontWeight for specified text within a FormattedText object.

SetForegroundBrush(Brush)

Tüm nesnenin ön planını değiştirir Brush FormattedText .Changes the foreground Brush for an entire FormattedText object.

SetForegroundBrush(Brush, Int32, Int32)

BrushBir nesne içindeki belirtilen metin için ön planı değiştirir FormattedText .Changes the foreground Brush for specified text within a FormattedText object.

SetMaxTextWidths(Double[])

Satır başına temelinde, içindeki maksimum metin genişliklerinin bir dizisini ayarlar FormattedText .Sets an array of maximum text widths within the FormattedText, on a per-line basis. Dizideki her öğe, metnin sıralı satırlarının maksimum metin genişliğini temsil eder.Each element in the array represents the maximum text width of sequential lines of text.

SetNumberSubstitution(NumberSubstitution)

Nesnedeki tüm karakter kümesinin sayı değiştirme davranışını ayarlar FormattedText .Sets the number substitution behavior for the entire set of characters in the FormattedText object.

SetNumberSubstitution(NumberSubstitution, Int32, Int32)

Bir nesne içinde belirtilen metin için sayı değiştirme davranışını ayarlar FormattedText .Sets the number substitution behavior for specified text within a FormattedText object.

SetTextDecorations(TextDecorationCollection)

TextDecorationCollectionNesnesindeki tüm karakter kümesi için öğesini ayarlar FormattedText .Sets the TextDecorationCollection for the entire set of characters in the FormattedText object.

SetTextDecorations(TextDecorationCollection, Int32, Int32)

TextDecorationCollectionBir nesne içinde belirtilen metin için ayarlar FormattedText .Sets the TextDecorationCollection for specified text within a FormattedText object.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.