public ref class FontFamily

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.FontFamilyConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.Font)]
public class FontFamily

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Media.FontFamilyConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font)>]
type FontFamily = class

Public Class FontFamily

大多数用户界面 (UI) 元素（如 Button 和 TextBlock ）提供 FontFamily 可用于为控件的文本内容指定字体的属性。 可以通过使用 值设置该属性 FontFamily 来定义字体。 以下示例演示如何在 Extensible Application Markup Language (XAML) 和 代码中引用字体。

myTextBlock.FontFamily = new FontFamily("Comic Sans MS");
myTextBlock.FontFamily = New FontFamily("Comic Sans MS")
<TextBlock FontFamily="Comic Sans MS">Hello, world</TextBlock>
在前面的示例中，引用的字体“Comic Sans MS”通过其 友好名称引用。 此外，在此示例中，假定字体位于系统字体集合中。
在备用目录中指定字体
Windows Presentation Foundation (WPF) 应用程序可以指定目录（包含系统字体集合的目录）来解析字体引用。 字体的友好名称可以指定绝对统一的资源标识符 (URI) 值来解析字体引用，如以下可扩展应用程序标记语言 (XAML) 和代码示例所示。
// Create a new FontFamily object, using an absolute URI reference.
myTextBlock.FontFamily = new FontFamily("file:///d:/MyFonts/#Pericles Light");
' Create a new FontFamily object, using an absolute URI reference.
myTextBlock.FontFamily = New FontFamily("file:///d:/MyFonts/#Pericles Light")
<TextBlock FontFamily="file:///d:/MyFonts/#Pericles Light">
  Aegean Sea
</TextBlock>
字体的友好名称还可以指定相对 URI 值，这需要基本 URI 才能解析字体引用。 对象的 BaseUri 属性 FontFamily 对应于基 URI 值。 下面的代码示例演示如何创建由基 URI 值和相对 URI 值组成的字体引用。
// Create a new FontFamily object, using a base URI reference and a relative URI reference.
myTextBlock.FontFamily = new FontFamily(new Uri("file:///d:/MyFonts/"), "./#Pericles Light");
' Create a new FontFamily object, using a base URI reference and a relative URI reference.
myTextBlock.FontFamily = New FontFamily(New Uri("file:///d:/MyFonts/"), "./#Pericles Light")
引用作为应用程序一部分打包的字体时，可以使用基 URI 值。 例如，基 URI 值可以是“pack://application”URI，这使你可以引用打包为应用程序资源的字体。 下面的代码示例演示由基 URI 值和相对 URI 值组成的字体引用。
// The font resource reference includes the base URI reference (application directory level),
// and a relative URI reference.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "./resources/#Pericles Light");
' The font resource reference includes the base URI reference (application directory level),
' and a relative URI reference.
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "./resources/#Pericles Light")
              FontFamily在标记中将 指定为属性时，始终隐含基 URI 值 - 其值为 XAML 页的 URI。 隐含基 URI 值与友好名称字符串中的相对 URI 值一起使用，以获取字体的位置。 在以下可扩展应用程序标记语言 (XAML) 示例中，请注意，相对 URI 值使用基 URI 值的“./”表示法，表示“在当前文件夹中”。

<TextBlock FontFamily="./resources/#Pericles Light">
  Aegean Sea
</TextBlock>
WPF 应用程序可以将字体打包为内容项、资源项或库资源项。 有关详细信息，请参阅将字体与应用程序一起打包。
字体回退是指自动替换客户端应用程序选择的字体以外的字体。 调用字体回退有两个主要原因：
系统中不存在客户端应用程序指定的字体。
客户端应用程序指定的字体不包含呈现文本所需的字形。
在 WPF 中，字体回退机制使用默认回退字体系列“全局用户界面”作为替换字体。 此字体定义为复合字体，其文件名为“GlobalUserInterface.CompositeFont”。 有关复合字体的详细信息，请参阅本主题中的复合字体部分。
WPF 字体回退机制取代了以前的 Win32 字体替换技术。
在代码中定义字体回退序列
可以在代码中定义字体回退序列，从而可以定义备用字体。 创建 FontFamily 对象时，请为 String 参数提供多个字体系列名称（用逗号分隔），例如“Comic Sans MS， Verdana”。 在这种情况下，如果“Comic Sans MS”字样中的字形不可用，则使用“Verdana”字样中的字形。 如果“Comic Sans MS”和“Verdana”都没有所需的字形，则使用字体的回退字体系列，默认为“全局用户界面”。
以下示例演示如何在可扩展应用程序标记语言 (XAML) 和代码中定义字体回退序列。
myTextBlock.FontFamily = new FontFamily("Comic Sans MS, Verdana");
myTextBlock.FontFamily = New FontFamily("Comic Sans MS, Verdana")
<TextBlock FontFamily="Comic Sans MS, Verdana">Hello, world</TextBlock>
回退序列中的任何一种字体都可以指定字体位置。 在以下示例中，“Pericles Light”引用为应用程序资源，“Verdana”引用为系统字体集合成员。
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "./resources/#Pericles Light, Verdana");
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "./resources/#Pericles Light, Verdana")
<TextBlock FontFamily="./resources/#Pericles Light, Verdana">Aegean Sea</TextBlock>
WPF 平台提供复合字体功能，允许构建全系列多语言字体，并避免显示缺少字形。 复合字体取代了 Win32 字体链接、字体回退、字体绑定、字体关联和最终用户定义字符 (EUDC) 机制。
复合字体系列通过 FontFamily 和 Typeface 构造函数可供应用程序使用，就像任何其他字体系列一样。 每个复合字体系列都命名为 ，并且与其他字体一样，可以多种语言提供其名称的本地化变体。
以下标记示例演示如何将复合字体系列定义为磁盘文件。 此文件可以与任何其他已安装字体一样存储在默认 Windows 字体目录中，也可以在按名称引用系列时包括其 URI 在任何位置进行引用。
以下示例显示 “” 中的字体系列标记。CompositeFont“文件。
<FontFamily
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/composite-font"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:System="clr-namespace:System;assembly=mscorlib"
    Baseline="0.9"
    LineSpacing="1.2">
    <!-- Name mapping -->
    <FontFamily.FamilyNames>
        <System:String x:Key="en-US">Global User Interface</System:String>
    </FontFamily.FamilyNames>
    <!-- Faces to report in font chooser UI -->
    <FontFamily.FamilyTypefaces>
        <FamilyTypeface
            Weight="Normal" Stretch="Normal" Style="Normal"
            UnderlinePosition="-0.1" UnderlineThickness="0.05"
            StrikethroughPosition="0.3" StrikethroughThickness="0.05"
            CapsHeight="0.5" XHeight="0.3" />
        <FamilyTypeface
            Weight="Bold" Stretch="Normal" Style="Normal"
            UnderlinePosition="-0.1" UnderlineThickness="0.05"
            StrikethroughPosition="0.3" StrikethroughThickness="0.05"
            CapsHeight="0.5" XHeight="0.3" />
    </FontFamily.FamilyTypefaces>
    <!-- Character to family lookups (in lookup order) -->
    <FontFamily.FamilyMaps>
            Basic Latin                 0000-007F
            Latin-1 Supplement          0080-00FF
            Latin Extended-A            0100-017F
            Latin Extended-B            0180-024F
            IPA Extensions              0250-02AF
            Spacing Modifier Letters    02B0-02FF 
            Combining Diacritics Marks  0300-036F 
            Greek and Coptic            0370-03FF
            Cyrillic                    0400-04FF 
            Cyrillic Supplement         0500-052F 
            Phonetic Extensions         1D00-1D7F
            Latin Extended Additional   1E00-1EFF
            Greek Extended              1F00-1FFF
            Alpha Pres Forms Latin      FB00-FB0F -->
        <!-- CHS -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Language="zh-Hans"
            Target="Times New Roman"
            Scale="1.0" />
        <!-- CHT -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Language="zh-Hant"
            Target="Times New Roman"
            Scale="1.0" />
        <!-- Other (include JA and KO) -->    
        <FontFamilyMap
            Unicode="0000-052F, 1D00-1FFF, FB00-FB0F"
            Target="Comic Sans MS, Verdana"
            Scale="4.0" />
            Armenian                    0530-058F    
            Georgian                    10D0-10FF
            Alpha Pres Forms Armenian   FB10-FB1C -->
        <FontFamilyMap
            Unicode="0530-058F, 10D0-10FF, FB10-FB1C"
            Target="Sylfaen"
            Scale="1.0" />
        <!-- Other FontFamilyMap elements defined ... --> 
    </FontFamily.FamilyMaps>
</FontFamily>
在 WPF 安装过程中，默认 Windows 字体目录中会显示以下四种复合字体。
<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"。

			即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。

        
提交和查看相关反馈