TextElement.FontFamily TextElement.FontFamily TextElement.FontFamily TextElement.FontFamily Property

Définition

Obtient ou définit la famille de polices de niveau supérieur par défaut pour le contenu de l’élément.Gets or sets the preferred top-level font family for the content of the element.

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; }
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

Valeur de propriété

Objet FontFamily qui spécifie 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.A FontFamily object that specifies the preferred font family, or a primary preferred font family with one or more fallback font families. La police par défaut est celle déterminée par la valeur MessageFontFamily.The default is the font determined by the MessageFontFamily value.

Exemples

L’exemple suivant montre comment définir l' FontFamily attribut à l’aide Paragraph de comme exemple d’élément.The following example shows how to set the FontFamily attribute, using Paragraph as the example 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>

L’illustration suivante montre le rendu de l’exemple précédent.The following figure shows how the preceding example renders.

![Capture d’écran Capture d’écran du texte]avec propriétés de texte:(~/add/media/textelement-fontprops.png " Texte avec propriétés de texte définies")Screenshot: Text with text properties set

L’exemple suivant montre comment définir la FontFamily propriété par programmation.The following example shows how to set the FontFamily property programmatically.

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.When multiple families are specified, the second and subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable.

Cette propriété spécifie une préférence uniquement.This property specifies a preference only. Si la famille de polices spécifiée n’est pas disponible FlowDocument , le se repasse en mode silencieux à la MessageFontFamily police déterminée par la valeur.If the specified font family is not available, the FlowDocument silently falls back to the font determined by the MessageFontFamily value.

Cette propriété de dépendance a également une utilisation de propriété jointe.This dependency property also has an attached property usage. Dans XAMLXAML, l’utilisation est <object TextElement.FontFamily="value".../>, où Object est un élément objet (en général un élément Flow) contenu dans TextBlockun, et value est l’une des valeurs de format de chaîne, comme expliqué dans les valeurs XAML.In XAMLXAML, the usage is <object TextElement.FontFamily="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is one of the string-format values as explained in XAML Values. Dans le code, l’utilisation de la propriété jointe GetFontFamily est SetFontFamily prise en charge par les méthodes et.In code, the attached property usage is supported by the GetFontFamily and SetFontFamily methods. L’utilisation de la propriété jointe n’est pas courante, car la plupart des éléments TextElement qui peuvent être contenus dans FontFamily un prennent en charge une propriété analogue non jointe, que l’hôte de contenu utilise pour le rendu.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontFamily property, which the content host uses for rendering.

Utilisation d'attributs XAMLXAML Attribute Usage

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

Valeurs XAMLXAML Values

fontFamilyNamefontFamilyName
Chaîne spécifiant un nom de famille de polices.A string specifying a font family name. Par exemple, "Arial" ou "Century Gothic".For example, "Arial" or "Century Gothic".

fontFamilyNamesListfontFamilyNamesList
Chaîne spécifiant plusieurs noms de famille de polices, séparés par une virgule (tout espace blanc après une virgule est ignoré).A string specifying multiple font family names, each separated by a comma (any white space following a comma is ignored). 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.The first font family specified serves as the primary font family; subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable. Par exemple, "Arial, Century Gothic" spécifie Arial comme famille de polices principale, avec Century Gothic comme famille de polices de secours.For example, "Arial, Century Gothic" specifies Arial as the primary font family, with Century Gothic as the fallback font family.

fontFamilyFolderReferencefontFamilyFolderReference
Chaîne spécifiant un dossier contenant la police, ainsi qu’un nom de famille de polices.A string specifying a folder containing the font, along with a font family name. Le nom de la famille de polices et le dossier sont délimités par un caractère #.The folder and font family name are delimited by a # character. La référence de dossier peut être absolue ou relative.The folder reference may be absolute, or relative. Par exemple, "Custom Fonts\#My Custom Font".For example, "Custom Fonts\#My Custom Font".

fontFamilyUriReferencefontFamilyUriReference
Chaîne spécifiant URI (Uniform Resource Identifier)uniform resource identifier (URI) pour la police, avec un nom de famille de polices.A string specifying a URI (Uniform Resource Identifier)uniform resource identifier (URI) for the font, along with a font family name. Le URIURI nom de famille de polices et sont délimités par un caractère #.The URIURI and font family name are delimited by a # character. Par exemple, "http://MyFontServer/Fonts/#My Custom Font".For example, "http://MyFontServer/Fonts/#My Custom Font".

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field FontFamilyProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

S’applique à