TextElement.FontFamily Özellik

Tanım

Öğenin içeriği için tercih edilen en üst düzey yazı tipi ailesini alır veya ayarlar.Gets or sets the preferred top-level font family for the content of the element.

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

Özellik Değeri

FontFamily

Bir veya daha fazla geri dönüş yazı tipi ailelerine sahip tercih edilen yazı tipi ailesi veya birincil tercih edilen yazı tipiThe preferred font family or a primary preferred font family with one or more fallback font families. Varsayılan değer tarafından belirlenen yazı tipidir MessageFontFamily .The default is the font determined by the MessageFontFamily value.

Öznitelikler

Örnekler

Aşağıdaki örnek, FontFamily örnek öğesi olarak kullanarak özniteliğinin nasıl ayarlanacağını gösterir Paragraph .The following example shows how to set the FontFamily attribute, using Paragraph as the example element.

<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>

Aşağıdaki şekilde, önceki örneğin nasıl işlediğini gösterilmektedir.The following figure shows how the preceding example renders.

Ekran görüntüsü: metin özellikleri ayarlanmış metinScreenshot: Text with text properties set

Aşağıdaki örnek, FontFamily özelliğinin programlı olarak nasıl ayarlanacağını gösterir.The following example shows how to set the FontFamily property programmatically.

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

Açıklamalar

Birden çok aileleri belirtildiğinde ikinci ve sonraki yazı tipi aileleri, birincil yazı tipi ailesinin kullanılamadığı veya geçerli olmadığı durumlarda kullanılacak geri dönüş aileleri olarak görev yapar.When multiple families are specified, the second and subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable.

Bu özellik yalnızca bir tercihi belirtir.This property specifies a preference only. Belirtilen yazı tipi ailesi yoksa, FlowDocument sessizce değer tarafından belirlenen yazı tipine geri döner MessageFontFamily .If the specified font family is not available, the FlowDocument silently falls back to the font determined by the MessageFontFamily value.

Bu bağımlılık özelliğinde ayrıca iliştirilmiş bir özellik kullanımı vardır.This dependency property also has an attached property usage. ' De, XAMLXAML kullanımı, <object TextElement.FontFamily="value".../> nesnenin bir nesne öğesi olduğu (genellikle bir akış öğesi) bir nesne Öğesı olduğu TextBlock ve değer xaml değerlerinde açıklanan dize biçimi değerlerinden biridir.In XAMLXAML, the usage is <object TextElement.FontFamily="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is one of the string-format values as explained in XAML Values. Kodda, eklenen özellik kullanımı GetFontFamily ve yöntemleri tarafından desteklenir SetFontFamily .In code, the attached property usage is supported by the GetFontFamily and SetFontFamily methods. Eklenmiş özellik kullanımı yaygın değildir, çünkü içinde yer alan öğelerin çoğu, TextElement FontFamily içerik konağın işleme için kullandığı, benzer bir eklenmemiş özelliği destekler.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontFamily property, which the content host uses for rendering.

XAML Öznitelik KullanımıXAML Attribute Usage

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

XAML DeğerleriXAML Values

fontFamilyNamefontFamilyName
Yazı tipi aile adını belirten bir dize.A string specifying a font family name. Örneğin "Arial" veya "Century Gothic" olabilir.For example, "Arial" or "Century Gothic".

fontFamilyNamesListfontFamilyNamesList
Birden çok yazı tipi aile adı belirten bir dize, her biri virgül ile ayrılır (virgülden sonraki boşluk yok sayılır).A string specifying multiple font family names, each separated by a comma (any white space following a comma is ignored). Belirtilen ilk yazı tipi ailesi, birincil yazı tipi ailesi olarak işlev görür; Sonraki yazı tipi aileleri, birincil yazı tipi ailesinin kullanılamadığı veya geçerli olmadığı durumlarda kullanılacak geri dönüş aileleri olarak görev yapar.The first font family specified serves as the primary font family; subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable. Örneğin, "Arial, Century Gothic" geri dönüş yazı tipi ailesi olarak Century Gothic ile birincil yazı tipi ailesi olarak Arial belirtir.For example, "Arial, Century Gothic" specifies Arial as the primary font family, with Century Gothic as the fallback font family.

fontFamilyFolderReferencefontFamilyFolderReference
Yazı tipi içeren bir klasörü belirten bir dize, yazı tipi aile adıyla birlikte.A string specifying a folder containing the font, along with a font family name. Klasör ve yazı tipi aile adı bir # karakteriyle sınırlandırılmıştır.The folder and font family name are delimited by a # character. Klasör başvurusu mutlak veya göreli olabilir.The folder reference may be absolute, or relative. Örneğin, "Custom Fonts\#My Custom Font".For example, "Custom Fonts\#My Custom Font".

fontFamilyUriReferencefontFamilyUriReference
Yazı tipi için bir Tekdüzen Kaynak tanımlayıcısı (URI) ve bir yazı tipi aile adı belirten bir dize.A string specifying a uniform resource identifier (URI) for the font, along with a font family name. URI ve yazı tipi aile adı bir # karakteriyle sınırlandırılmıştır.The URI and font family name are delimited by a # character. Örneğin, "http://MyFontServer/Fonts/#My Custom Font".For example, "http://MyFontServer/Fonts/#My Custom Font".

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanıIdentifier field FontFamilyProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Şunlara uygulanır