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 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 le FontFamily d’attribut, à l’aide de Paragraph en tant que l’élément de l’exemple.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>

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

Capture d’écran : Texte avec le jeu de propriétés de texteScreenshot: Text with text properties set

L’exemple suivant montre comment définir le 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, les familles de polices suivantes servent de familles de secours à utiliser dans les cas où la famille de polices principale est indisponible ou non 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, le FlowDocument revient silencieusement à la police déterminée par la MessageFontFamily 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 la propriété jointe.This dependency property also has an attached property usage. Dans XAMLXAML, l’utilisation est <object TextElement.FontFamily="value".../>, où objet est un élément objet (en général un élément de flux) contenu dans un TextBlock, et valeur est une des valeurs de format de chaîne en tant que expliqué dans les valeurs de 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 est pris en charge par le GetFontFamily et SetFontFamily méthodes.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 qui peuvent être contenus dans un TextElement prennent en charge une analogue non jointes FontFamily propriété, qui utilise de l’hôte de contenu 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 (n’importe quel 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 la famille de polices principale ; familles de polices suivantes servent de familles de secours à utiliser dans les cas où la famille de polices principale est indisponible ou non 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 en tant que la famille de polices principale, avec siècle Gothic en tant que la 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 que d’un nom de famille de polices.A string specifying a folder containing the font, along with a font family name. Le dossier et le nom de famille de polices sont délimités par un caractère #.The folder and font family name are delimited by a # character. La référence au dossier peut être absolu ou relatif.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 un URI (Uniform Resource Identifier)uniform resource identifier (URI) pour la police, ainsi que d’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 et le nom de famille de polices 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
La valeur des propriétés de métadonnées trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

S’applique à