有些字透過 Aspose.Words 轉成 PDF 後，會變成空白框(square box)或是變成 空白字

前言

有些情況在透過 Aspose.Words 另存成 PDF 檔後，
有些字在 PDF 中會變成 空白框(square box) 或是變成 空白，
但那些字又不自造字，怎麼會這樣子呢?
例如，U+2FA6(⾦) 這個字，可是在 Word 中明明可以正常顯示。

解法

測試的 C# 程式如下(請先加入 Aspose.Words 套件)，

var docxPath = @"c:\temp\h2docx.docx";
var pdfPath = @"c:\temp\h2pdf.pdf";
var doc = new Aspose.Words.Document();
var docBuilder = new Aspose.Words.DocumentBuilder(doc);
var html = @"<div>U+2FA6(⾦) vs U+91D1(金)</div>";
docBuilder.InsertHtml(html);
doc.Save(docxPath);
doc.Save(pdfPath);

產生的 Word 及 PDF 如上圖所示，
在 Word 檔中字型使用「Times New Roman」，
有同事說，如果是 「Microsoft YaHei」 字型，在 PDF 中顯示似乎是正常的。

那…
我們要如何將字型從 「Times New Roman」 改成 「Microsoft YaHei」 呢?
也就是將文字加到 Word Doc 時，就將字型設定成 「Microsoft YaHei」。

這時，我們可以透過 INodeChangingCallback.NodeInserted method ，在將文字寫到 Word 時，把字型強迫換成 「Microsoft YaHei」 。
所以建立一個 HandleNodeChangingFontChanger Class 來實作 INodeChangingCallback 介面，

public class HandleNodeChangingFontChanger : INodeChangingCallback
{
    /// <summary>
    /// 預設為標楷體
    /// </summary>
    private string _fontName = "DFKai-SB";
    public HandleNodeChangingFontChanger()
    {}
    public HandleNodeChangingFontChanger(string fontName)
    {
        _fontName = fontName;
    }
    void INodeChangingCallback.NodeInserted(NodeChangingArgs args)
    {
        if (args.Node.NodeType == NodeType.Run)
        {
            Aspose.Words.Font font = ((Run)args.Node).Font;
            font.Name = _fontName;
        }
    }

    void INodeChangingCallback.NodeInserting(NodeChangingArgs args)
    {}

    void INodeChangingCallback.NodeRemoved(NodeChangingArgs args)
    {}

    void INodeChangingCallback.NodeRemoving(NodeChangingArgs args)
    {}
}

再來就是設定 doc 的 NodeChangingCallback 屬性為上面建立的 HandleNodeChangingFontChanger Class，並設定要更改的字型為 「Microsoft YaHei」

var docxPath = @"c:\temp\h2docx.docx";
var pdfPath = @"c:\temp\h2pdf.pdf";
var doc = new Aspose.Words.Document();
var fontName = "Microsoft YaHei";
doc.NodeChangingCallback = new HandleNodeChangingFontChanger(fontName);
var docBuilder = new Aspose.Words.DocumentBuilder(doc);
var html = @"<div>U+2FA6(⾦) vs U+91D1(金)</div>";
docBuilder.InsertHtml(html);
doc.Save(docxPath);
doc.Save(pdfPath);

執行程式後可以發現 Word 中的字型已變成了 「Microsoft YaHei」 字型，
而在 PDF 中的 U+2FA6(⾦) 這個字，也可以正常顯示了。

參考資源

U+2FA6(⾦)
標楷體支援的 Unicode
INodeChangingCallback.NodeInserted method