TextBlock.FontFamily Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia preferowaną rodzinę czcionek najwyższego poziomu dla klasy TextBlock.

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)]
public System.Windows.Media.FontFamily FontFamily { get; set; }

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

Public Property FontFamily As FontFamily

Wartość właściwości

FontFamily

FontFamily Obiekt określający preferowaną rodzinę czcionek lub podstawową preferowaną rodzinę 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 TextBlock elementu.

<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

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

TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;

Dim textBlock As New TextBlock(New Run("A bit of text content..."))

textBlock.Background = Brushes.AntiqueWhite
textBlock.Foreground = Brushes.Navy

textBlock.FontFamily = New FontFamily("Century Gothic")
textBlock.FontSize = 12
textBlock.FontStretch = FontStretches.UltraExpanded
textBlock.FontStyle = FontStyles.Italic
textBlock.FontWeight = FontWeights.UltraBold

textBlock.LineHeight = Double.NaN
textBlock.Padding = New Thickness(5, 10, 5, 10)
textBlock.TextAlignment = TextAlignment.Center
textBlock.TextWrapping = TextWrapping.Wrap

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle
textBlock.Typography.SlashedZero = True

Uwagi

Wszystkie FontFamily ustawienia elementów podrzędnych zastępują to ustawienie najwyższego poziomu.

Gdy określono wiele rodzin, drugie i kolejne rodziny czcionek służą jako rodziny rezerwowe do użycia w przypadkach, gdy podstawowa rodzina czcionek jest niedostępna lub nie ma zastosowania.

Ta właściwość określa tylko preferencje. Jeśli określona rodzina czcionek nie jest dostępna, TextBlock dyskretnie wraca do czcionki określonej przez MessageFontFamily wartość.

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 TextBlock.FontFamily="value".../>, gdzie obiekt jest elementem obiektu (zazwyczaj elementem przepływu) zawartym w elemecie TextBlock, a wartość jest jedną z wartości formatu ciągów, jak wyjaśniono w artykule Wartości XAML. W kodzie dołączone użycie właściwości jest obsługiwane przez GetFontFamily element i SetFontFamily. Użycie dołączonej właściwości nie jest powszechne, ponieważ większość elementów, które mogą być zawarte w TextBlock obsłudze analogiczną nieprzyłączoną FontFamily właściwość, która TextBlock jest używana 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, każdy oddzielony 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 do użycia 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