TextElement Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Xaml.Documents

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.

Edit

Kelas abstrak yang digunakan sebagai kelas dasar untuk kelas Blok dan Sebaris yang juga abstrak. TextElement mendukung API umum untuk kelas yang terlibat dalam model objek teks XAML, seperti properti yang mengontrol ukuran teks, keluarga font, dan sebagainya.

public ref class TextElement : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TextElement : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class TextElement : DependencyObject

Public Class TextElement
Inherits DependencyObject

Warisan: Object Platform::Object IInspectable DependencyObject TextElement

Turunan: Windows.UI.Xaml.Documents.Block

Windows.UI.Xaml.Documents.Inline

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Berbagai properti yang ditentukan oleh TextElement mendukung API umum untuk kelas yang terlibat dalam model objek teks XAML. Berikut adalah daftar properti yang paling umum digunakan:

Dengan mengatur properti TextElement, Anda bisa menerapkan properti pemformatan teks umum ke teks, baik dalam blok maupun sebaris. Ada juga cara tambahan untuk memformat teks, tetapi ini tidak didukung secara langsung oleh TextElement. Sebagai gantinya, Anda dapat menggunakan properti terlampir dari kelas Tipografi . Properti terlampir tipografi biasanya mendukung fitur atau konvensi tipografi tingkat lanjut, seperti mengakses fitur tipografi yang ditentukan pada tingkat font yang belum tentu didukung oleh semua font. Misalnya, Anda dapat mengatur Typography.Variants sebagai properti terlampir pada blok teks atau sebaris apa pun, dan ini akan memengaruhi perilaku varian font seperti yang diaktifkan oleh font tertentu yang Anda pilih untuk mengatur FontFamily pada elemen teks tersebut.

TextElement tidak secara inheren menentukan titik koneksi ke pohon visual XAML. Dengan kata lain TextElement mendefinisikan teks dan model objek teks dalam teks tersebut, tetapi belum mengaktifkan tampilan teks tersebut dalam UI. Untuk itu, Anda perlu menggunakan salah satu kontrol atau elemen yang merupakan keturunan UIElement dan dapat dihubungkan ke pohon XAML dan visual akar jendela aplikasi Anda. Ada dua elemen seperti itu dalam Windows Runtime:

TextBlock: Mendukung model objek teks sebaris hanya dengan koleksi Sebarisnya .
RichTextBlock: Mendukung model objek teks blok dengan koleksi Blok . Blok dapat berisi blok dan sebaris.

Catatan

PasswordBox, RichEditBox , dan TextBox tidak mendukung model objek teks yang didasarkan pada TextElement. RichEditBox memang mengaktifkan akses terprogram ke model objek teks yang berbeda melalui antarmuka ITextDocument .

TextElement mendefinisikan API yang mendukung pemeriksaan model objek teks sebagai objek pemrograman setelah XAML diurai. Secara khusus TextElement mengimplementasikan Nama dan Bahasa, yang properti paralel dengan nama yang sama pada FrameworkElement. TextElement juga mengimplementasikan FindName (metode utilitas untuk menemukan objek pada durasi berdasarkan bagaimana Nama diatur dalam XAML awal), dan OnDisconnectVisualChildren (untuk skenario lanjutan dan dukungan perancang).

TextElement memiliki empat properti yang menyediakan akses ke objek TextPointer dari dalam teks. Properti ini adalah: ContentStart, ContentEnd, ElementStart, ElementEnd. Objek TextPointer Runtime Windows memberi Anda titik masuk untuk traversal konten. Untuk informasi selengkapnya, lihat TextPointer.

TextElement adalah kelas yang berasal dari DependencyObject. Itu berarti dapat menentukan properti dependensi, dan masing-masing properti baca-tulis TextElement adalah properti dependensi, dengan pengidentifikasi propertinya juga didefinisikan oleh TextElement. Untuk informasi selengkapnya tentang properti dependensi apa yang diaktifkan, lihat Gambaran umum properti dependensi.

Kelas turunan TextElement

TextElement adalah kelas induk untuk dua kelas turunan yang membagi model objek teks menjadi dua konvensi penggunaan teks: Blokir, dan Sebaris. Block dan Inline keduanya dianggap sebagai kelas dasar (Anda biasanya tidak melihat <Block> tag di XAML) dan ada dalam hierarki terutama untuk menjadi kelas induk dari elemen teks praktis lainnya. Misalnya, Blokir adalah kelas induk Paragraf. Untuk informasi selengkapnya tentang cara menggunakan elemen blok dan sebaris, lihat Mulai Cepat: Menampilkan teks.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	AccessKey
1607	14393	AllowFocusOnInteraction
1607	14393	ExitDisplayModeOnAccessKeyInvoked
1703	15063	AccessKeyDisplayDismissed
1703	15063	AccessKeyDisplayRequested
1703	15063	AccessKeyInvoked
1703	15063	AccessKeyScopeOwner
1703	15063	IsAccessKeyScope
1703	15063	KeyTipHorizontalOffset
1703	15063	KeyTipPlacementMode
1703	15063	KeyTipVerticalOffset
1703	15063	TextDecorations
1903	18362	XamlRoot

Properti

AccessKey	Mendapatkan atau mengatur kunci akses untuk elemen ini.
AccessKeyProperty	Mengidentifikasi properti dependensi AccessKey .
AccessKeyScopeOwner	Mendapatkan atau mengatur elemen sumber yang menyediakan cakupan kunci akses untuk elemen ini, meskipun tidak berada di pohon visual elemen sumber.
AccessKeyScopeOwnerProperty	Mengidentifikasi properti dependensi AccessKeyScopeOwner .
AllowFocusOnInteraction	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen secara otomatis mendapatkan fokus saat pengguna berinteraksi dengannya.
AllowFocusOnInteractionProperty	Mengidentifikasi properti dependensi AllowFocusOnInteraction .
CharacterSpacing	Mendapatkan atau mengatur spasi seragam di antara karakter, dalam satuan 1/1000 dari mereka.
CharacterSpacingProperty	Mengidentifikasi properti dependensi CharacterSpacing .
ContentEnd	Mendapatkan TextPointer yang mewakili akhir konten dalam elemen .
ContentStart	Mendapatkan TextPointer yang mewakili awal konten dalam elemen .
Dispatcher	Mendapatkan CoreDispatcher yang dikaitkan dengan objek ini. CoreDispatcher mewakili fasilitas yang dapat mengakses DependencyObject pada utas UI bahkan jika kode dimulai oleh utas non-UI. (Diperoleh dari DependencyObject)
ElementEnd	Mendapatkan TextPointer yang mewakili posisi tepat setelah akhir elemen.
ElementStart	Mendapatkan TextPointer yang mewakili posisi tepat sebelum awal elemen.
ExitDisplayModeOnAccessKeyInvoked	Mendapatkan atau mengatur nilai yang menentukan apakah tampilan kunci akses ditutup saat kunci akses dipanggil.
ExitDisplayModeOnAccessKeyInvokedProperty	Mengidentifikasi properti dependensi ExitDisplayModeOnAccessKeyInvoked .
FontFamily	Mendapatkan atau mengatur keluarga font tingkat atas pilihan untuk konten elemen.
FontFamilyProperty	Mengidentifikasi properti dependensi FontFamily .
FontSize	Mendapatkan atau mengatur ukuran font untuk konten elemen.
FontSizeProperty	Mengidentifikasi properti dependensi FontSize .
FontStretch	Mendapatkan atau mengatur lebar glyph font dalam keluarga untuk dipilih.
FontStretchProperty	Mengidentifikasi properti dependensi FontStretch .
FontStyle	Mendapatkan atau mengatur gaya font untuk konten dalam elemen ini.
FontStyleProperty	Mengidentifikasi properti dependensi FontStyle .
FontWeight	Mendapatkan atau mengatur bobot font tingkat atas untuk memilih dari keluarga font untuk konten dalam elemen ini.
FontWeightProperty	Mengidentifikasi properti dependensi FontWeight .
Foreground	Mendapatkan atau mengatur Brush untuk diterapkan ke konten dalam elemen ini.
ForegroundProperty	Mengidentifikasi properti dependensi Latar Depan .
IsAccessKeyScope	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen menentukan cakupan kunci aksesnya sendiri.
IsAccessKeyScopeProperty	Mengidentifikasi properti dependensi IsAccessKeyScope .
IsTextScaleFactorEnabled	Mendapatkan atau mengatur apakah pembekuan teks otomatis, untuk mencerminkan pengaturan ukuran teks sistem, diaktifkan.
IsTextScaleFactorEnabledProperty	Mengidentifikasi properti dependensi IsTextScaleFactorEnabled .
KeyTipHorizontalOffset	Mendapatkan atau mengatur nilai yang menunjukkan seberapa jauh kiri atau kanan tip tombol ditempatkan dalam kaitannya dengan elemen teks.
KeyTipHorizontalOffsetProperty	Mengidentifikasi properti dependensi KeyTipHorizontalOffset .
KeyTipPlacementMode	Mendapatkan atau mengatur nilai yang menunjukkan di mana KeyTip ditempatkan dalam kaitannya dengan elemen teks.
KeyTipPlacementModeProperty	Mengidentifikasi properti dependensi KeyTipPlacementMode .
KeyTipVerticalOffset	Mendapatkan atau mengatur nilai yang menunjukkan seberapa jauh tip tombol ditempatkan dalam kaitannya dengan elemen teks.
KeyTipVerticalOffsetProperty	Mengidentifikasi properti dependensi KeyTipVerticalOffset .
Language	Mendapatkan atau mengatur informasi bahasa pelokalan/globalisasi yang berlaku untuk TextElement.
LanguageProperty	Mengidentifikasi properti Dependensi bahasa .
Name	Mendapatkan atau mengatur identifikasi unik untuk objek. Nama hanya dapat diatur dari penguraian awal XAML.
TextDecorations	Mendapatkan atau menetapkan nilai yang menunjukkan dekorasi apa yang diterapkan ke teks.
TextDecorationsProperty	Mengidentifikasi properti dependensi TextDecorations .
XamlRoot	Mendapatkan atau mengatur XamlRoot tempat elemen ini sedang dilihat.

Metode

ClearValue(DependencyProperty)	Menghapus nilai lokal properti dependensi. (Diperoleh dari DependencyObject)
FindName(String)	Mengambil objek dalam grafik objek model objek/runtime dengan mereferensikan nilai atribut x:Name atau Name objek.
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai dasar apa pun yang ditetapkan untuk properti dependensi, yang akan berlaku dalam kasus di mana animasi tidak aktif. (Diperoleh dari DependencyObject)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini dari DependencyObject. (Diperoleh dari DependencyObject)
OnDisconnectVisualChildren()	Ambil alih metode ini untuk mengimplementasikan bagaimana tata letak dan logika harus bersifat ketika item dihapus dari konten khusus kelas atau properti turunan.
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika nilai lokal ditetapkan. (Diperoleh dari DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Mendaftarkan fungsi pemberitahuan untuk mendengarkan perubahan pada DependencyProperty tertentu pada instans DependencyObject ini. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi pada DependencyObject. (Diperoleh dari DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Membatalkan pemberitahuan perubahan yang sebelumnya terdaftar dengan memanggil RegisterPropertyChangedCallback. (Diperoleh dari DependencyObject)

Acara

AccessKeyDisplayDismissed	Terjadi ketika urutan kunci akses selesai untuk memberi tahu kontrol bahwa mereka harus menyembunyikan visual kunci akses.
AccessKeyDisplayRequested	Terjadi ketika urutan kunci akses mulai memberi tahu kontrol bahwa mereka harus menampilkan visual kunci akses.
AccessKeyInvoked	Terjadi ketika pengguna menyelesaikan urutan kunci akses untuk memberi tahu elemen bahwa tindakan kunci akses harus dipanggil.

Berlaku untuk