TextElement.FontFamily 属性

定义

命名空间:

System.Windows.Documents

程序集:

PresentationFramework.dll

获取或设置元素内容的首选顶级字体系列。

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

属性值

FontFamily

首选字体系列或具有一个或多个回退字体系列的主要首选字体系列。 默认值为由 MessageFontFamily 值确定的字体。

属性

LocalizabilityAttribute

示例

以下示例将 Paragraph 作为示例元素，演示如何设置 FontFamily 属性。

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

下图显示了上述示例的呈现方式。

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

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

注解

如果指定了多个系列，则第二个和后续字体系列将用作后备系列，用于主字体系列不可用或不适用的情况。

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

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

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