TextElement Kelas
Definisi
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.
public ref class TextElement : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
- Turunan
- Atribut
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.
Blokir dan Sebaris keduanya dianggap sebagai kelas dasar (Biasanya Anda 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 Blok teks.
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 |
Selalu kembali |
DispatcherQueue |
|
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. |