FormattedText Kelas

Definisi

Ruang nama:: System.Windows.Media

Rakitan:: PresentationCore.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan kontrol tingkat rendah untuk menggambar teks di aplikasi Windows Presentation Foundation (WPF).

public ref class FormattedText

public class FormattedText

type FormattedText = class

Public Class FormattedText

Warisan: Object
FormattedText

Contoh

Contoh berikut membuat FormattedText objek lalu menerapkan beberapa gaya pemformatan ke teks.

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

Keterangan

Objek FormattedText memungkinkan Anda menggambar teks multibaris, di mana setiap karakter dalam teks dapat diformat satu per satu. Contoh berikut menunjukkan teks yang memiliki beberapa format yang diterapkan padanya.

Teks ditampilkan menggunakan objek FormattedText Contoh string teks yang diformat

Dalam hal fitur teks di WPF, FormattedText dianggap "tingkat rendah" karena memproses teks sebagai elemen grafis. Aspek teks lain dalam WPF menangani teks dalam konteks kontrol yang didedikasikan untuk teks (TextBlock, TextBox), menerapkan model dokumen alur (lihat Gambaran Umum Dokumen Alur), atau mendukung model dokumen XPS (lihat Dokumen di WPF).

Banyak metode setter memiliki FormattedText kesamaan dengan properti terlampir yang didukung oleh TextElement, tetapi TextElement properti terlampir berlaku untuk dukungan teks tingkat lebih tinggi baik untuk alur atau XPS.

Konstruktor

Nama	Deskripsi
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, Double)	Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, typeface, ukuran font, kuas latar depan, dan nilai pixelsPerDip yang ditentukan.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, Double)	Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, typeface, ukuran font, kuas latar depan, perilaku penggantian angka, dan nilai pixelsPerDip yang ditentukan.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode, Double)	Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, typeface, ukuran font, kuas latar depan, perilaku penggantian angka, dan nilai pixelsPerDip yang ditentukan.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution, TextFormattingMode)	Kedaluwarsa. Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, typeface, ukuran font, kuas, perilaku penggantian angka, dan mode pemformatan teks yang ditentukan.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush, NumberSubstitution)	Kedaluwarsa. Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, jenis huruf, ukuran font, kuas, dan perilaku penggantian angka yang ditentukan.
FormattedText(String, CultureInfo, FlowDirection, Typeface, Double, Brush)	Kedaluwarsa. Menginisialisasi instans FormattedText baru kelas dengan teks, budaya, arah alur, typeface, ukuran font, dan kuas yang ditentukan.

Properti

Nama	Deskripsi
Baseline	Mendapatkan jarak dari bagian atas baris pertama ke garis besar baris FormattedText pertama objek.
Extent	Mendapatkan jarak dari piksel tergambar paling atas dari baris pertama ke piksel paling bawah yang digambar dari baris terakhir.
FlowDirection	Mendapatkan atau mengatur FlowDirection FormattedText objek.
Height	Mendapatkan jarak dari bagian atas baris pertama ke bagian bawah baris FormattedText terakhir objek.
LineHeight	Mendapatkan tinggi baris, atau penspasian baris, di antara baris teks.
MaxLineCount	Mendapatkan atau mengatur jumlah baris maksimum yang akan ditampilkan. Teks yang MaxLineCount melebihi tidak akan ditampilkan.
MaxTextHeight	Mendapatkan atau mengatur tinggi maksimum kolom teks.
MaxTextWidth	Mendapatkan atau mengatur lebar teks maksimum (panjang) untuk baris teks.
MinWidth	Mendapatkan lebar teks sekecil mungkin yang dapat sepenuhnya berisi konten teks yang ditentukan.
OverhangAfter	Mendapatkan jarak dari bagian bawah baris terakhir teks ke piksel terbawah yang digambar.
OverhangLeading	Mendapatkan jarak maksimum dari titik perataan di depan ke piksel garis yang digambar di depan.
OverhangTrailing	Mendapatkan jarak maksimum dari piksel bertinta berikutnya ke titik perataan berikutnya dari garis.
PixelsPerDip	Dapatkan atau atur PixelsPerDip tempat teks harus dirender.
Text	Mendapatkan string teks yang akan ditampilkan.
TextAlignment	Mendapatkan atau mengatur perataan teks dalam FormattedText objek.
Trimming	Mendapatkan atau mengatur cara di mana kelalaian teks ditunjukkan.
Width	Mendapatkan lebar antara titik perataan garis di depan dan belakang, tidak termasuk karakter spasi putih berikutnya.
WidthIncludingTrailingWhitespace	Mendapatkan lebar antara titik perataan garis di depan dan belakang, termasuk karakter spasi putih berikutnya.

Metode

Nama	Deskripsi
BuildGeometry(Point)	Mengembalikan Geometry objek yang mewakili teks yang diformat, termasuk semua glyph dan dekorasi teks.
BuildHighlightGeometry(Point, Int32, Int32)	Mengembalikan Geometry objek yang mewakili kotak batas sorotan untuk substring tertentu dari teks yang diformat.
BuildHighlightGeometry(Point)	Mengembalikan Geometry objek yang mewakili kotak batas sorotan dari teks yang diformat.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetMaxTextWidths()	Mengambil array lebar teks. Setiap elemen dalam array mewakili lebar teks maksimum baris teks berurutan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SetCulture(CultureInfo, Int32, Int32)	CultureInfo Mengatur untuk subset karakter tertentu dalam FormattedText objek.
SetCulture(CultureInfo)	CultureInfo Mengatur untuk seluruh set karakter dalam FormattedText objek.
SetFontFamily(FontFamily, Int32, Int32)	Mengatur keluarga font untuk subset karakter tertentu dalam FormattedText objek.
SetFontFamily(FontFamily)	Mengatur keluarga font untuk objek FormattedText .
SetFontFamily(String, Int32, Int32)	Mengatur keluarga font untuk subset karakter tertentu dalam FormattedText objek.
SetFontFamily(String)	Mengatur keluarga font untuk seluruh set karakter dalam FormattedText objek.
SetFontSize(Double, Int32, Int32)	Mengatur ukuran font untuk subset karakter tertentu dalam FormattedText objek.
SetFontSize(Double)	Mengatur ukuran font untuk seluruh set karakter dalam FormattedText objek.
SetFontStretch(FontStretch, Int32, Int32)	Mengatur nilai peregangan font untuk subset karakter tertentu dalam FormattedText objek.
SetFontStretch(FontStretch)	Mengatur nilai peregangan font untuk seluruh set karakter dalam FormattedText objek.
SetFontStyle(FontStyle, Int32, Int32)	Mengatur gaya font untuk subset karakter tertentu dalam FormattedText objek.
SetFontStyle(FontStyle)	Mengatur gaya font untuk seluruh set karakter dalam FormattedText objek.
SetFontTypeface(Typeface, Int32, Int32)	Mengatur typeface font untuk subkumpulan karakter tertentu dalam FormattedText objek.
SetFontTypeface(Typeface)	Mengatur typeface font untuk seluruh set karakter dalam FormattedText objek.
SetFontWeight(FontWeight, Int32, Int32)	FontWeight Mengubah untuk teks yang ditentukan dalam FormattedText objek.
SetFontWeight(FontWeight)	Mengatur bobot font untuk seluruh set karakter dalam FormattedText objek.
SetForegroundBrush(Brush, Int32, Int32)	Mengubah latar depan Brush untuk teks tertentu dalam FormattedText objek.
SetForegroundBrush(Brush)	Mengubah latar depan Brush untuk seluruh FormattedText objek.
SetMaxTextWidths(Double[])	Mengatur array lebar teks maksimum dalam FormattedText, berdasarkan per baris. Setiap elemen dalam array mewakili lebar teks maksimum baris teks berurutan.
SetNumberSubstitution(NumberSubstitution, Int32, Int32)	Mengatur perilaku penggantian angka untuk teks tertentu dalam FormattedText objek.
SetNumberSubstitution(NumberSubstitution)	Mengatur perilaku penggantian angka untuk seluruh set karakter dalam FormattedText objek.
SetTextDecorations(TextDecorationCollection, Int32, Int32)	TextDecorationCollection Mengatur untuk teks yang ditentukan dalam FormattedText objek.
SetTextDecorations(TextDecorationCollection)	TextDecorationCollection Mengatur untuk seluruh set karakter dalam FormattedText objek.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?