We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy and cookie policy. Image for the cookie policy date
Unfortunately, activation email could not send to your email. Please try again.
Syncfusion Feedback

How to perform font substitution in Word to PDF conversion?

Platform: WPF |
Control: DocIO

When the necessary fonts used in the Word document has not been installed in the production machine, then Essential DocIO uses the ”Microsoft Sans Serif” as default font for rendering the text. Due to this font substitution, you could see the difference with the rendered text in the generated PDF/Image files during Word to PDF/Image conversion. To know more about the default font substitution, please refer here.

 

From 2018 Volume 1 release (v16.1.0.24) onwards, Syncfusion provides support to  perform font substitution using event approach while converting a particular Word document as PDF. So, that you can choose any installed font instead of ”Microsoft Sans Serif”.

 

The following code example illustrates how to trigger `SubstituteFont` event during font substitution in Word to PDF conversion. A runnable sample application can be downloaded from here

C#:

// Loads an existing Word document.
WordDocument wordDocument = new WordDocument("template.docx", FormatType.Docx);
// Initializes the SubstituteFont event to perform font substitution during Word to PDF conversion.
wordDocument.FontSettings.SubstituteFont += new SubstituteFontEventHandler(SubstituteFont);
// Creates an instance of DocToPDFConverter.
DocToPDFConverter converter = new DocToPDFConverter();
// Converts the Word document into PDF document.
PdfDocument pdfDocument = converter.ConvertToPDF(wordDocument);
// Closes the instance of Word document object.
wordDocument.Close();
// Saves the PDF file.
pdfDocument.Save("WordtoPDF.pdf");
// Closes the instance of PDF document object.
pdfDocument.Close(true);

 

VB:

' Loads an existing Word document.
Dim wordDocument As New WordDocument("template.docx", FormatType.Docx)
' Initializes the SubstituteFont event to perform font substitution during Word to PDF conversion.
AddHandler wordDocument.FontSettings.SubstituteFont, AddressOf SubstituteFont
' Creates an instance of DocToPDFConverter.
Dim converter As New DocToPDFConverter()
' Converts the Word document into PDF document.
Dim pdfDocument As PdfDocument = converter.ConvertToPDF(wordDocument)
' Closes the instance of document object.
wordDocument.Close()
' Saves the PDF file .
pdfDocument.Save("WordtoPDF.pdf")
' Closes the instance of document object.
pdfDocument.Close(True)

 

The following code example illustrates how to set the alternate font when a specified font is not installed in the production environment by using `SubstituteFontEventHandler`.

C#:

private void SubstituteFont(object sender, SubstituteFontEventArgs args)
{
    // Sets the alternate font when a specified font is not installed in the production environment.
    if (args.OrignalFontName == "Arial Unicode MS")
        args.AlternateFontName = "Arial";
    else
        args.AlternateFontName = "Times New Roman";
}

 

VB:

Private Sub SubstituteFont(ByVal sender As Object, ByVal args As SubstituteFontEventArgs)
    ' Sets the alternate font when a specified font is not installed in the production environment.
    If args.OrignalFontName = "Arial Unicode MS" Then
        args.AlternateFontName = "Arial"
    Else
        args.AlternateFontName = "Times New Roman"
    End If
End Sub

 

If you have any questions or require clarification about this support, please let us know in the comments below. You can also contact us through our support forum or Direct Trac. We are happy to assist you as always!

2X faster development

The ultimate WPF UI toolkit to boost your development speed.
ADD COMMENT
You must log in to leave a comment

Please sign in to access our KB

This page will automatically be redirected to the sign-in page in 10 seconds.

Up arrow icon

Warning Icon You are using an outdated version of Internet Explorer that may not display all features of this and other websites. Upgrade to Internet Explorer 8 or newer for a better experience.Close Icon

Live Chat Icon For mobile