TextBlock.FontFamily Proprietà

Definizione

Ottiene o imposta la famiglia di caratteri di primo livello preferita per 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

Valore della proprietà

FontFamily

Oggetto FontFamily che specifica la famiglia di caratteri preferita oppure famiglia di caratteri preferita principale con una o più famiglie di caratteri di fallback. Il valore predefinito è il tipo di carattere determinato dal valore di MessageFontFamily.

Attributi

Esempio

Nell'esempio seguente viene illustrato come impostare l'attributo FontFamily di un TextBlock elemento.

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

Nell'esempio seguente viene illustrato come impostare la FontFamily proprietà a livello di codice.

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

Commenti

Tutte FontFamily le impostazioni sugli elementi figlio eseguono l'override di questa impostazione di primo livello.

Quando vengono specificate più famiglie, le famiglie di caratteri seconde e successive fungono da famiglie di fallback da usare nei casi in cui la famiglia di caratteri primaria non è disponibile o non applicabile.

Questa proprietà specifica solo una preferenza. Se la famiglia di caratteri specificata non è disponibile, il TextBlock carattere viene restituito in modo invisibile al carattere determinato dal MessageFontFamily valore.

Questa proprietà di dipendenza ha anche un utilizzo di proprietà collegato. In XAML l'utilizzo è , dove l'oggetto è <object TextBlock.FontFamily="value".../>un elemento oggetto (in genere un elemento di flusso) contenuto in un TextBlockoggetto e il valore è uno dei valori in formato stringa, come illustrato in Valori XAML. Nel codice l'utilizzo della proprietà associata è supportato da GetFontFamily e SetFontFamily. L'utilizzo della proprietà associata non è comune, perché la maggior parte degli elementi che possono essere contenuti in un supporto di una TextBlock proprietà analoga non attaccata FontFamily , utilizzata per il TextBlock rendering.

Uso della sintassi XAML per gli attributi

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

Valori XAML

fontFamilyName
Stringa che specifica un nome di famiglia di caratteri. Ad esempio, "Arial" o "Century Gothic".

fontFamilyNamesList
Stringa che specifica più nomi di famiglia di caratteri, ognuno separato da una virgola (qualsiasi spazio vuoto che segue una virgola viene ignorato). La prima famiglia di caratteri specificata funge da famiglia di caratteri primaria; le famiglie di caratteri successive fungono da famiglie di fallback da usare nei casi in cui la famiglia di caratteri primaria non è disponibile o non applicabile. Ad esempio, "Arial, Century Gothic" specifica Arial come famiglia di caratteri principale, con Century Gothic come famiglia di caratteri di fallback.

fontFamilyFolderReference
Stringa che specifica una cartella contenente il tipo di carattere, insieme a un nome di famiglia di caratteri. La cartella e il nome della famiglia di caratteri sono delimitati da un carattere #. Il riferimento alla cartella può essere assoluto o relativo. Ad esempio: "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Stringa che specifica un URI (Uniform Resource Identifier) per il tipo di carattere, insieme a un nome di famiglia di caratteri. L'URI e il nome della famiglia di caratteri sono delimitati da un carattere #. Ad esempio: "http://MyFontServer/Fonts/#My Custom Font".

Informazioni proprietà di dipendenza

Campo Identificatore FontFamilyProperty
Proprietà dei metadati impostate su true AffectsMeasure, AffectsRender, Inherits

Si applica a