如何在WPF（.NET 8）中正确渲染PUA与EUDC字符？

问题描述 #

我正在开发基于.NET 8的WPF应用，需要显示PUA（私有使用区域）和EUDC（扩展用户定义字符）中的特殊字符，但遇到渲染异常——字符要么完全不显示，要么渲染错误。直接指定EUDC字体路径的方式（如<TextBox FontFamily="C:\WINDOWS\FONTS\EUDC.TTE#EUDC" />）仅在TextBox中生效，RichTextBox无法正常显示，且这种硬编码路径的方式并不合理。求其他可行的显示方法。

对应的XAML示例：

<Window
    x:Class="FONTTESTWPF.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    Title="MainWindow"
    Width="800"
    Height="450"
    mc:Ignorable="d">
    <Grid>
        <StackPanel Margin="0" Orientation="Vertical">
            <TextBlock
                Margin="7"
                FontSize="18"
                Text="RichTextBox:" />

            <!-- 无法显示字符 -->
            <RichTextBox
                Margin="7,0,7,0"
                FontFamily="C:\WINDOWS\FONTS\EUDC.TTE#EUDC"
                FontSize="23" />

            <TextBlock
                Margin="7"
                FontSize="18"
                Text="TextBox:" />

            <!-- 可正常显示字符 -->
            <TextBox
                Margin="7,0,7,0"
                FontFamily="C:\WINDOWS\FONTS\EUDC.TTE#EUDC"
                FontSize="23" />
        </StackPanel>
    </Grid>
</Window>

可行解决方案 #

1. 利用系统字体回退机制注册EUDC #

WPF的字体回退机制会自动为找不到对应字符的字体匹配包含该字符的字体。通过代码将EUDC添加到全局字体回退列表，所有控件（包括RichTextBox）都会自动用EUDC渲染PUA/EUDC字符，无需单独指定字体路径。

在App.xaml.cs的OnStartup方法中添加代码：

using System.Windows;
using System.Windows.Media;

namespace FONTTESTWPF
{
    public partial class App : Application
    {
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);

            // 添加EUDC到字体回退集合，优先级设为默认
            FontFamily.FamilyMaps.Add(new FontFamilyMap
            {
                Target = new FontFamily("EUDC"),
                Language = "x-generic",
                Scale = 1.0
            });
        }
    }
}

设置后，控件使用常规字体（如宋体、微软雅黑）即可，遇到PUA/EUDC字符时WPF会自动切换到EUDC渲染。

2. 为RichTextBox的段落显式设置字体 #

RichTextBox基于FlowDocument，直接设置控件的FontFamily可能无法作用于内部内容。需为段落单独指定字体：

XAML直接设置：

<RichTextBox Margin="7,0,7,0" FontSize="23">
    <FlowDocument>
        <Paragraph FontFamily="EUDC">
            <!-- 输入或绑定PUA/EUDC字符 -->
        </Paragraph>
    </FlowDocument>
</RichTextBox>

代码动态设置：

var richTextBox = new RichTextBox();
var paragraph = new Paragraph(new Run("你的PUA/EUDC字符"));
paragraph.FontFamily = new FontFamily("EUDC");
richTextBox.Document.Blocks.Add(paragraph);

直接使用FontFamily="EUDC"即可，系统会自动定位到EUDC字体文件，无需硬编码路径。

3. 自定义字体映射文件 #

创建字体映射文件，将PUA区域字符绑定到EUDC，适合精细控制字符渲染的场景：

1. 创建CustomFontMap.fontmap文件：

<FontFamilyMapCollection xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
  <FontFamilyMap
    Target="EUDC"
    Unicode="E000-F8FF" <!-- PUA字符范围 -->
    Language="x-generic"
    Scale="1.0" />
</FontFamilyMapCollection>

2. 在App.xaml中引用该文件：

<Application x:Class="FONTTESTWPF.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <FontFamilyMapCollection x:Key="CustomFontMap" Source="CustomFontMap.fontmap" />
    </Application.Resources>
</Application>

3. 在代码中应用映射：

var customMap = Resources["CustomFontMap"] as FontFamilyMapCollection;
foreach (var map in customMap)
{
    FontFamily.FamilyMaps.Add(map);
}

关键说明 #

• 避免硬编码路径：直接使用FontFamily="EUDC"即可，系统会自动识别字体文件，提升应用兼容性。
• RichTextBox的特殊性：字体设置需作用于内部的Block元素（如Paragraph），而非直接设置控件的FontFamily属性。

内容的提问来源于stack exchange，提问作者Alexey