TextElement.FontFamily Properti

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur keluarga font tingkat atas pilihan untuk konten elemen.

public:
 property System::Windows::Media::FontFamily ^ FontFamily { System::Windows::Media::FontFamily ^ get(); void set(System::Windows::Media::FontFamily ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.Font, Modifiability=System.Windows.Modifiability.Unmodifiable)]
public System.Windows.Media.FontFamily FontFamily { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font, Modifiability=System.Windows.Modifiability.Unmodifiable)>]
member this.FontFamily : System.Windows.Media.FontFamily with get, set

Public Property FontFamily As FontFamily

Nilai Properti

FontFamily

Keluarga font pilihan atau keluarga font pilihan utama dengan satu atau beberapa keluarga font fallback. Defaultnya adalah font yang ditentukan oleh MessageFontFamily nilai .

Atribut

LocalizabilityAttribute

Contoh

Contoh berikut menunjukkan cara mengatur atribut FontFamily, menggunakan Paragraph sebagai elemen contoh.

<Paragraph
  FontFamily="Century Gothic, Courier New"  
  FontSize="16pt"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="DemiBold"
>
  <Run>
    This text will use the Century Gothic font (if available), with fallback to Courier New.  It 
    will render with a font size of 16 points in ultra-expanded demi-bold italic.
  </Run>
</Paragraph>

Gambar berikut menunjukkan bagaimana contoh sebelumnya dirender.

Contoh berikut menunjukkan cara mengatur properti FontFamily secara terprogram.

Run run = new Run(
    "This text will use the Century Gothic font (if available), with fallback to Courier New."
    + "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.");
Paragraph par = new Paragraph(run);

par.FontFamily = new FontFamily("Century Gothic, Courier New");
par.FontSize = 16;
par.FontStretch = FontStretches.UltraExpanded;
par.FontStyle = FontStyles.Italic;
par.FontWeight = FontWeights.DemiBold;

Dim run As New Run("This text will use the Century Gothic font (if available), with fallback to Courier New." & "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.")
Dim par As New Paragraph(run)

With par
    .FontFamily = New FontFamily("Century Gothic, Courier New")
    .FontSize = 16
    .FontStretch = FontStretches.UltraExpanded
    .FontStyle = FontStyles.Italic
    .FontWeight = FontWeights.DemiBold
End With

Keterangan

Ketika beberapa keluarga ditentukan, keluarga font kedua dan berikutnya berfungsi sebagai keluarga fallback yang akan digunakan dalam kasus di mana keluarga font utama tidak tersedia atau tidak berlaku.

Properti ini hanya menentukan preferensi. Jika keluarga font yang ditentukan tidak tersedia, diam-diam FlowDocument kembali ke font yang ditentukan oleh MessageFontFamily nilai .

Properti dependensi ini juga memiliki penggunaan properti terlampir. Dalam XAML, penggunaannya adalah <object TextElement.FontFamily="value".../>, di mana objek adalah elemen objek (biasanya elemen alur) yang terkandung dalam TextBlock, dan nilai adalah salah satu nilai format string seperti yang dijelaskan dalam Nilai XAML. Dalam kode, penggunaan properti terlampir didukung oleh GetFontFamily metode dan SetFontFamily . Penggunaan properti terlampir tidak umum, karena sebagian besar elemen yang dapat dimuat dalam TextElement mendukung properti yang tidak terpasang FontFamily analog, yang digunakan host konten untuk penyajian.

Penggunaan Atribut XAML

<object FontFamily="fontFamilyName"/>
- or -
<object FontFamily="fontFamilyNamesList"/>
- or -
<object FontFamily="fontFamilyFolderReference"/>
- or -
<object FontFamily="fontFamilyUriReference"/>

Nilai XAML

fontFamilyName String yang menentukan nama keluarga font. Misalnya, "Arial" atau "Century Gothic".

fontFamilyNamesList String yang menentukan beberapa nama keluarga font, masing-masing dipisahkan oleh koma (spasi kosong setelah koma diabaikan). Keluarga font pertama yang ditentukan berfungsi sebagai keluarga font utama; keluarga font berikutnya berfungsi sebagai keluarga fallback yang akan digunakan dalam kasus di mana keluarga font utama tidak tersedia atau tidak berlaku. Misalnya, "Arial, Century Gothic" menentukan Arial sebagai keluarga font utama, dengan Century Gothic sebagai keluarga font fallback.

fontFamilyFolderReference String yang menentukan folder yang berisi font, bersama dengan nama keluarga font. Folder dan nama keluarga font dibatasi oleh karakter # . Referensi folder mungkin absolut, atau relatif. Contohnya, "Custom Fonts\#My Custom Font".

fontFamilyUriReference String yang menentukan pengidentifikasi sumber daya seragam (URI) untuk font, bersama dengan nama keluarga font. URI dan nama keluarga font dibatasi oleh karakter # . Contohnya, "http://MyFontServer/Fonts/#My Custom Font".

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	FontFamilyProperty
Properti metadata diatur ke true	AffectsMeasure, , AffectsRenderInherits