TextBlock.FontFamily Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit la famille de polices de niveau supérieur par défaut pour 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

Valeur de propriété

FontFamily

Objet FontFamily spécifiant la famille de polices par défaut ou une famille de polices par défaut principale assortie d’une ou plusieurs familles de polices de base. La police par défaut est déterminée par la valeur MessageFontFamily.

Attributs

LocalizabilityAttribute

Exemples

L’exemple suivant montre comment définir l’attribut FontFamily d’un TextBlock élément.

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

L’exemple suivant montre comment définir la FontFamily propriété par programmation.

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

Remarques

Tous FontFamily les paramètres sur les éléments enfants remplacent ce paramètre de niveau supérieur.

Lorsque plusieurs familles sont spécifiées, la deuxième et les familles de police suivantes servent de familles de secours à utiliser dans les cas où la famille de polices primaire n’est pas disponible ou n’est pas applicable.

Cette propriété spécifie une préférence uniquement. Si la famille de polices spécifiée n’est pas disponible, le TextBlock revient silencieusement à la police déterminée par la MessageFontFamily valeur.

Cette propriété de dépendance a également une utilisation de propriété jointe. En XAML, l’utilisation est <object TextBlock.FontFamily="value".../>, où object est un élément objet (généralement un élément de flux) contenu dans un TextBlock, et la valeur est l’une des valeurs de format de chaîne, comme expliqué dans Valeurs XAML. Dans le code, l’utilisation de la propriété jointe est prise en charge par GetFontFamily et SetFontFamily. L’utilisation de la propriété jointe n’est pas courante, car la plupart des éléments qui peuvent être contenus dans une TextBlock propriété prennent en charge une propriété non attachée FontFamily analogue, que le service utilise pour le TextBlock rendu.

Utilisation d'attributs XAML

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

Valeurs XAML

fontFamilyName
Chaîne spécifiant un nom de famille de polices.  Par exemple, "Arial" ou "Century Gothic".

fontFamilyNamesList
Chaîne spécifiant plusieurs noms de famille de polices, chacun séparé par une virgule (tout espace blanc suivant une virgule est ignoré). La première famille de polices spécifiée sert de famille de polices principale ; les familles de polices suivantes servent de familles de secours à utiliser dans les cas où la famille de polices principale n’est pas disponible ou ne s’applique pas. Par exemple, "Arial, Century Gothic" spécifie Arial comme famille de polices primaire, avec Century Gothic comme famille de polices de secours.

fontFamilyFolderReference
Chaîne spécifiant un dossier contenant la police, ainsi qu’un nom de famille de police. Le dossier et le nom de la famille de police sont délimités par un caractère # . La référence de dossier peut être absolue ou relative. Par exemple : "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Chaîne spécifiant un URI (Uniform Resource Identifier) pour la police, ainsi qu’un nom de famille de police. L’URI et le nom de la famille de police sont délimités par un caractère # . Par exemple : "http://MyFontServer/Fonts/#My Custom Font".

Informations sur les propriétés de dépendance

Champ Identificateur	FontFamilyProperty
Propriétés de métadonnées définies sur true	AffectsMeasure, AffectsRender, Inherits