TextElement.FontFamily Eigenschaft

Definition

Ruft die bevorzugte Schriftfamilie der obersten Ebene für den Inhalt des Elements ab oder legt sie fest.

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

Eigenschaftswert

Die bevorzugte Schriftfamilie oder eine primäre bevorzugte Schriftfamilie mit einer oder mehreren Fallbackschriftfamilien. Die Standardeinstellung ist die Schriftart, die durch den MessageFontFamily-Wert bestimmt wird.

Attribute

Beispiele

Das folgende Beispiel zeigt, wie das FontFamily-Attribut gesetzt wird, wobei Paragraph als Beispielelement verwendet wird.

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

Die folgende Abbildung zeigt, wie das vorherige Beispiel gerendert wird.

Screenshot: Text mit festgelegten Texteigenschaften

Das folgende Beispiel zeigt, wie Sie die FontFamily-Eigenschaft programmatisch einstellen können.

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

Hinweise

Wenn mehrere Familien angegeben werden, dienen die zweite und nachfolgende Schriftfamilien als Fallbackfamilien, die in Fällen verwendet werden können, in denen die primäre Schriftfamilie nicht verfügbar ist oder nicht zutreffend ist.

Diese Eigenschaft gibt nur eine Einstellung an. Wenn die angegebene Schriftfamilie nicht verfügbar ist, greift die FlowDocument unbeaufsichtigt auf die schriftart zurück, die durch den MessageFontFamily Wert bestimmt wird.

Diese Abhängigkeitseigenschaft verfügt auch über eine angefügte Eigenschaftsverwendung. In XAML ist <object TextElement.FontFamily="value".../>die Verwendung , wobei das Objekt ein Objektelement (in der Regel ein Flowelement) ist, das in einem TextBlockenthalten ist, und der Wert einer der Werte im Zeichenfolgenformat ist, wie in XAML-Werte erläutert. Im Code wird die Verwendung angefügter Eigenschaften von den GetFontFamily Methoden und SetFontFamily unterstützt. Die Verwendung angefügter Eigenschaften ist nicht üblich, da die meisten Elemente, die in einem TextElement enthalten sein können, eine analoge nicht angefügte FontFamily Eigenschaft unterstützen, die der Inhaltshost zum Rendern verwendet.

Verwendung von XAML-Attributen

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

XAML-Werte

fontFamilyName
Eine Zeichenfolge, die einen Schriftfamiliennamen angibt.  Zum Beispiel: "Arial" oder "Century Gothic".

fontFamilyNamesList
Eine Zeichenfolge, die mehrere Schriftfamiliennamen angibt, die jeweils durch ein Komma getrennt sind (alle Leerzeichen nach einem Komma werden ignoriert). Die erste angegebene Schriftfamilie dient als primäre Schriftfamilie; nachfolgende Schriftfamilien dienen als Fallbackfamilien, die in Fällen verwendet werden können, in denen die primäre Schriftfamilie nicht verfügbar ist oder nicht anwendbar ist. Gibt beispielsweise "Arial, Century Gothic" Arial als primäre Schriftfamilie an, wobei Century Gothic die Fallbackschriftfamilie ist.

fontFamilyFolderReference
Eine Zeichenfolge, die einen Ordner angibt, der die Schriftart enthält, sowie einen Namen der Schriftfamilie. Der Name des Ordners und der Schriftfamilie wird durch ein #-Zeichen getrennt. Der Ordnerverweis kann absolut oder relativ sein. Beispiel: "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Eine Zeichenfolge, die einen URI (Uniform Resource Identifier) für die Schriftart angibt, zusammen mit einem Schriftfamiliennamen. Der URI und der Name der Schriftfamilie werden durch ein #-Zeichen getrennt. Beispiel: "http://MyFontServer/Fonts/#My Custom Font".

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld FontFamilyProperty
Metadateneigenschaften auf true festgelegt AffectsMeasure, AffectsRender, Inherits

Gilt für: