Span Kelas

Referensi

Definisi

Ruang nama:: Microsoft.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

Mengelompokkan elemen konten Sebaris lainnya. Kelas induk untuk Tebal, Hyperlink, Miring , dan Garis Bawah.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

Warisan: Object IInspectable DependencyObject TextElement Inline Span

Turunan: Microsoft.UI.Xaml.Documents.Bold

Microsoft.UI.Xaml.Documents.Hyperlink

Microsoft.UI.Xaml.Documents.Italic

Microsoft.UI.Xaml.Documents.Underline

Atribut: ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Keterangan

Anda dapat menggunakan Span sebagai elemen objek di XAML untuk mengapit teks. Ini memungkinkan penggunaan serupa dengan bagaimana Anda dapat menggunakan span tag dalam HTML. Untuk penggunaan ini, Anda akan mengatur atribut yang didukung oleh TextElement seperti FontSize atau FontFamily, sehingga Anda dapat menerapkan keputusan pemformatan teks ini ke rentang teks yang diapit. Jalankan memiliki fungsionalitas serupa dalam menerapkan properti TextElement ke rentang teks, tetapi Jalankan tidak mendukung konten campuran (properti konten Run.Text XAML-nya hanya dapat berisi teks, bukan konten campuran, dan sebaris lebih lanjut).

Rentang mendukung konten campuran jika Anda mengatur konten di XAML. Artinya, Anda dapat mencampur tag Sebaris seperti Jalankan, Tebal , dan sebagainya dengan konten teks XAML (teks biasa), tanpa batasan urutan tag versus teks harus muncul. Semua teks, baik teks biasa atau sebagaimana diapit dalam tag Sebaris , merender dalam urutan teks ditentukan dalam konten campuran. Misalnya, ini adalah XAML legal:

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

Ketika konten campuran diurai dari XAML, dan model objek teks diperiksa pada durasi, area teks apa pun yang berasal dari teks biasa menghasilkan objek Jalankan pada posisi urutan baca yang sesuai di kelas koleksi InlineCollection yang memungkinkan akses run-time. Elemen Jalankan berisi teks tetapi sebaliknya tidak memiliki kumpulan properti.

Catatan

Menempatkan konten XAML baik tag atau teks langsung dalam elemen Rentang didukung karena Span menunjukkan bahwa properti Sebarisnya adalah properti konten XAML. Untuk informasi selengkapnya tentang properti konten XAML, lihat bagian "Properti konten XAML" dari panduan sintaks XAML.

Elemen rentang biasanya digunakan sebagai elemen dalam InlineCollection, baik sebagai elemen anak dari Paragraf (menjadi bagian dari Paragraf.Sebaris) atau sebagai konten Rentang lain (menjadi bagian dari Span.Inlines).

Kelas turunan rentang

Rentang adalah kelas induk untuk beberapa kelas turunan yang menentukan wilayah teks sebaris dengan konvensi pemformatan tertentu:

Tebal
Hyperlink
Miring
Menggaris bawah Hyperlink memungkinkan perilaku klik yang menavigasi ke NavigateUri. Kelas turunan Rentang lainnya dapat dianggap sebagai dekorasi khusus kelas ke teks dan tidak menambahkan interaksi.

Konstruktor

Span()

Menginisialisasi instans baru kelas Span .

Properti

AccessKey	Mendapatkan atau mengatur kunci akses untuk elemen ini. (Diperoleh dari TextElement)
AccessKeyScopeOwner	Mendapatkan atau mengatur elemen sumber yang menyediakan cakupan kunci akses untuk elemen ini, meskipun tidak berada di pohon visual elemen sumber. (Diperoleh dari TextElement)
AllowFocusOnInteraction	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen secara otomatis mendapatkan fokus saat pengguna berinteraksi dengannya. (Diperoleh dari TextElement)
CharacterSpacing	Mendapatkan atau mengatur spasi seragam di antara karakter, dalam satuan 1/1000 dari em. (Diperoleh dari TextElement)
ContentEnd	Mendapatkan TextPointer yang mewakili akhir konten dalam elemen . (Diperoleh dari TextElement)
ContentStart	Mendapatkan TextPointer yang mewakili awal konten dalam elemen . (Diperoleh dari TextElement)
Dispatcher	Selalu kembali `null` di aplikasi SDK Aplikasi Windows. Gunakan DispatcherQueue sebagai gantinya. (Diperoleh dari DependencyObject)
DispatcherQueue	`DispatcherQueue` Mendapatkan yang dikaitkan dengan objek ini. `DispatcherQueue` 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. (Diperoleh dari TextElement)
ElementStart	Mendapatkan TextPointer yang mewakili posisi tepat sebelum awal elemen. (Diperoleh dari TextElement)
ExitDisplayModeOnAccessKeyInvoked	Mendapatkan atau mengatur nilai yang menentukan apakah tampilan kunci akses dimatikan saat kunci akses dipanggil. (Diperoleh dari TextElement)
FontFamily	Mendapatkan atau mengatur keluarga font tingkat atas pilihan untuk konten elemen. (Diperoleh dari TextElement)
FontSize	Mendapatkan atau mengatur ukuran font untuk konten elemen. (Diperoleh dari TextElement)
FontStretch	Mendapatkan atau mengatur lebar glyph font dalam keluarga untuk dipilih. (Diperoleh dari TextElement)
FontStyle	Mendapatkan atau mengatur gaya font untuk konten dalam elemen ini. (Diperoleh dari TextElement)
FontWeight	Mendapatkan atau mengatur bobot font tingkat atas untuk memilih dari keluarga font untuk konten dalam elemen ini. (Diperoleh dari TextElement)
Foreground	Mendapatkan atau mengatur Brush untuk diterapkan ke konten dalam elemen ini. (Diperoleh dari TextElement)
Inlines	Mendapatkan InlineCollection yang berisi elemen sebaris tingkat atas yang menyertakan konten Rentang.
IsAccessKeyScope	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen menentukan cakupan kunci aksesnya sendiri. (Diperoleh dari TextElement)
IsTextScaleFactorEnabled	Mendapatkan atau mengatur apakah pembekuan teks otomatis, untuk mencerminkan pengaturan ukuran teks sistem, diaktifkan. (Diperoleh dari TextElement)
KeyTipHorizontalOffset	Mendapatkan atau mengatur nilai yang menunjukkan seberapa jauh kiri atau kanan tip kunci ditempatkan dalam kaitannya dengan elemen teks. (Diperoleh dari TextElement)
KeyTipPlacementMode	Mendapatkan atau mengatur nilai yang menunjukkan di mana Tip Kunci ditempatkan dalam kaitannya dengan elemen teks. (Diperoleh dari TextElement)
KeyTipVerticalOffset	Mendapatkan atau mengatur nilai yang menunjukkan seberapa jauh tip tombol ditempatkan dalam kaitannya dengan elemen teks. (Diperoleh dari TextElement)
Language	Mendapatkan atau mengatur informasi bahasa pelokalan/globalisasi yang berlaku untuk TextElement. (Diperoleh dari TextElement)
Name	Mendapatkan atau mengatur identifikasi unik untuk objek. Nama hanya dapat diatur dari penguraian awal XAML. (Diperoleh dari TextElement)
TextDecorations	Mendapatkan atau menetapkan nilai yang menunjukkan dekorasi apa yang diterapkan ke teks. (Diperoleh dari TextElement)
XamlRoot	Mendapatkan atau mengatur XamlRoot tempat elemen ini dilihat. (Diperoleh dari TextElement)

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. (Diperoleh dari TextElement)
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 berpura-pura ketika item dihapus dari konten khusus kelas atau properti turunan. (Diperoleh dari TextElement)
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. (Diperoleh dari TextElement)
AccessKeyDisplayRequested	Terjadi ketika urutan kunci akses mulai memberi tahu kontrol bahwa mereka harus menampilkan visual kunci akses. (Diperoleh dari TextElement)
AccessKeyInvoked	Terjadi ketika pengguna menyelesaikan urutan kunci akses untuk memberi tahu elemen bahwa tindakan kunci akses harus dipanggil. (Diperoleh dari TextElement)

Berlaku untuk

Bagikan melalui