TextElement.FontFamily Propriété

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtient ou définit la famille de polices de niveau supérieur par défaut pour le contenu de l’élément.

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

Valeur de propriété

FontFamily

La famille de polices préférée ou une famille de polices préférée principale avec une ou plusieurs familles de polices de secours. 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 , en utilisant Paragraph comme exemple d’élément.

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

La figure suivante montre comment l’exemple précédent s’affiche.

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

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

Remarques

Lorsque plusieurs familles sont spécifiées, la deuxième famille de polices et les suivantes servent de familles de secours à utiliser dans les cas où la famille de polices principale 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 FlowDocument 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 TextElement.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 les GetFontFamily méthodes et SetFontFamily . L’utilisation de la propriété jointe n’est pas courante, car la plupart des éléments qui peuvent être contenus dans un TextElement prennent en charge une propriété analogue non attachée FontFamily , que l’hôte de contenu utilise pour le 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 familles de polices, chacun séparé par une virgule (tout espace 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 n’est pas applicable. Par exemple, "Arial, Century Gothic" spécifie Arial comme famille de polices principale, 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 polices. Le dossier et le nom de la famille de polices 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 polices. L’URI et le nom de la famille de polices 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