TextBlock.FontFamily Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die bevorzugte Schriftfamilie der obersten Ebene für den TextBlock 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)]
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

Eigenschaftswert

FontFamily

Ein FontFamily-Objekt, das die bevorzugte Schriftfamilie oder eine primäre bevorzugte Schriftfamilie mit einer oder mehreren Ausweichschriftfamilien angibt. Die Standardeinstellung ist die Schriftart, die durch den MessageFontFamily-Wert bestimmt wird.

Attribute: LocalizabilityAttribute

Beispiele

Das folgende Beispiel zeigt, wie das FontFamily Attribut eines TextBlock Elements festgelegt wird.

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

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

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

Hinweise

Alle FontFamily Einstellungen für untergeordnete Elemente überschreiben diese Einstellung der obersten Ebene.

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 TextBlock 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 TextBlock.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 der angefügten Eigenschaft von GetFontFamily und SetFontFamilyunterstützt. Die Verwendung angefügter Eigenschaften ist nicht üblich, da die meisten Elemente, die in einem TextBlock enthalten sein können, eine analoge nicht angefügte FontFamily Eigenschaft unterstützen, die für das TextBlock Rendern verwendet wird.

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:

Freigeben über