TextBlock.FontFamily 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取或设置 TextBlock 的首选最常用字体系列。

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

属性值

FontFamily

一个 FontFamily 对象，该对象指定首选的字体系列，或者具有一个或多个备用字体系列的主要首选字体系列。 默认值为由 MessageFontFamily 值确定的字体。

属性

LocalizabilityAttribute

示例

以下示例演示如何设置 FontFamily 元素的属性 TextBlock 。

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

以下示例演示如何以编程方式设置 FontFamily 属性。

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

注解

子元素上的任何 FontFamily 设置都会覆盖此顶级设置。

指定多个系列时，第二个和后续字体系列充当回退系列，在主字体系列不可用或不适用的情况下使用。

此属性仅指定首选项。 如果指定的字体系列不可用，则 TextBlock 以无提示方式回退到由值确定的 MessageFontFamily 字体。

此依赖属性还具有附加的属性用法。 在 XAML 中，用法是 <object TextBlock.FontFamily="value".../>， 对象是对象 元素， (通常是包含在其中的 TextBlock流元素) ，值是 XAML 值中所述的字符串格式值之一。 在代码中，附加的属性用法受和SetFontFamily支持GetFontFamily。 附加属性用法并不常见，因为大多数元素都可以包含在 TextBlock 支持类似非附加 FontFamily 属性中，该 TextBlock 属性用于呈现。

XAML 属性用法

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

XAML 值

fontFamilyName
指定字体系列名称的字符串。  例如 "Arial" 或 "Century Gothic"。

fontFamilyNamesList
指定多个字体系列名称的字符串，每个字符串用逗号分隔 (逗号后的任何空格将被忽略) 。 指定的第一个字体系列用作主要字体系列：后续字体系列用作回退系列，在主字体系列不可用或不适用的情况下使用。 例如， "Arial, Century Gothic" 将 Arial 指定为主字体系列，将 Century 哥特式用作回退字体系列。

fontFamilyFolderReference
指定包含字体的文件夹以及字体系列名称的字符串。 文件夹和字体系列名称由 #字符分隔。 文件夹引用可以是绝对引用，也可以是相对的。 例如，"Custom Fonts\#My Custom Font"。

fontFamilyUriReference
指定字体 (URI) 以及字体系列名称的统一资源标识符的字符串。 URI 和字体系列名称由 #字符分隔。 例如，"http://MyFontServer/Fonts/#My Custom Font"。

依赖项属性信息

标识符字段	FontFamilyProperty
元数据属性设置为 true	AffectsMeasure、AffectsRender、Inherits