TextElement.FontFamily Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia preferowaną rodzinę czcionek najwyższego poziomu dla zawartości elementu.

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

Wartość właściwości

FontFamily

Preferowana rodzina czcionek lub podstawowa preferowana rodzina czcionek z co najmniej jedną rodziną czcionek rezerwowych. Wartość domyślna to czcionka określona MessageFontFamily przez wartość .

Atrybuty

LocalizabilityAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić FontFamily atrybut przy użyciu Paragraph jako przykładowy 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>

Na poniższej ilustracji przedstawiono sposób renderowania poprzedniego przykładu.

W poniższym przykładzie pokazano, jak programowo ustawić FontFamily właściwość.

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

Uwagi

W przypadku określenia wielu rodzin druga i kolejne rodziny czcionek służą jako rodziny rezerwowe, które mają być używane w przypadkach, gdy podstawowa rodzina czcionek jest niedostępna lub nie dotyczy.

Ta właściwość określa tylko preferencje. Jeśli określona rodzina czcionek jest niedostępna, czcionka FlowDocument określana przez wartość w trybie dyskretnym powraca do czcionki MessageFontFamily .

Ta właściwość zależności ma również dołączone użycie właściwości. W języku XAML użycie to <object TextElement.FontFamily="value".../>, gdzie obiekt jest elementem obiektu (zazwyczaj elementem przepływu) zawartym w elemecie TextBlock, a wartość jest jedną z wartości formatu ciągu, jak wyjaśniono w artykule Wartości XAML. W kodzie użycie dołączonej właściwości jest obsługiwane przez GetFontFamily metody i SetFontFamily . Użycie dołączonej właściwości nie jest powszechne, ponieważ większość elementów, które mogą być zawarte w TextElement obsłudze analogiczną nieprzyłączoną FontFamily właściwość, której host zawartości używa do renderowania.

Użycie atrybutu języka XAML

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

Wartości XAML

fontFamilyName
Ciąg określający nazwę rodziny czcionek. Na przykład: "Arial" lub "Century Gothic".

fontFamilyNamesList
Ciąg określający wiele nazw rodzin czcionek, z których każda jest oddzielona przecinkiem (wszelkie białe znaki po przecinku są ignorowane). Określona pierwsza rodzina czcionek służy jako podstawowa rodzina czcionek; kolejne rodziny czcionek służą jako rodziny rezerwowe, które mają być używane w przypadkach, gdy podstawowa rodzina czcionek jest niedostępna lub nie dotyczy. Na przykład "Arial, Century Gothic" określa Arial jako podstawową rodzinę czcionek z Century Gothic jako rodziną czcionek rezerwowych.

fontFamilyFolderReference
Ciąg określający folder zawierający czcionkę wraz z nazwą rodziny czcionek. Nazwa folderu i rodziny czcionek są rozdzielane znakiem #. Odwołanie do folderu może być bezwzględne lub względne. Na przykład "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Ciąg określający jednolity identyfikator zasobu (URI) dla czcionki wraz z nazwą rodziny czcionek. Identyfikator URI i nazwa rodziny czcionek są rozdzielane znakiem #. Na przykład "http://MyFontServer/Fonts/#My Custom Font".

Informacje dotyczące właściwości zależności

Pole identyfikatora	FontFamilyProperty
Właściwości metadanych ustawione na true	AffectsMeasure, AffectsRender, Inherits