Frequently Asked Questions
26 Nov 20255 minutes to read
The frequently asked questions about Word to PDF conversion in Essential® DocIO are listed below.
Could not find Syncfusion.OfficeChartToImageConverter assembly in .NET 3.5 Framework, does it mean there is no support for chart conversion in this Framework?
Yes, OfficeChartToImageConverter assembly is not supported in .NET 3.5 Framework and it is available in .NET 4.0 Framework.
Is it possible to convert 3D charts to PDF?
Current version of the DocIO library does not provide support for converting 3D charts to PDF format.
Is it possible to specify PDF conformance level in Word to PDF conversion?
Yes, you can specify the PDF conformance level in Word to PDF conversion. For more details, refer PDF Conformance.
Why are content controls not preserved as editable form fields in the converted PDF document even when PreserveFormFields is enabled?
Content controls behave differently from legacy form fields, such as Text, Checkbox, and Drop-down fields, during conversions to PDF format. While legacy form fields are typically preserved as editable form fields in the resulting PDF document, content controls are converted to plain text. The PreserveFormFields API specifically retains the interactive nature of legacy form fields, not content controls.
To ensure that form fields remain editable in the PDF converted from Word document, it is recommended to use Text, Checkbox, and Drop-down form fields instead of content controls in the Word document. Additionally, to preserve the form fields as editable in the resulting PDF, set the PreserveFormFields API to true.
You can download a complete working sample from GitHub.
How to validate the PDF conformance level in a DocIO-converted PDF?
PDF conformance can be verified using tools like Adobe Acrobat Pro, VeraPDF, Xodo Validator, and PDFCreator Validator. These tools check if the PDF meets compliance standards. DocIO-generated PDFs can be validated using any of these tools to ensure compliance with the required standards.
Is it possible to preserve track changes revisions in a Word document as comments in a PDF using DocIO?
When a Word document with revisions is converted to a PDF using Microsoft Word, the revisions are preserved as balloons. So, it is not possible to preserve revisions in a Word document as comments in a PDF. Using DocIO, revisions can be displayed as balloons in the converted PDF by enabling the ShowMarkup property. Refer to the documentation and GitHub sample for implementation.
Why does a Word document converted to PDF on one device not display correctly when converted on another device?
If a converted PDF does not display correctly on another device, it may be due to missing fonts. The document appears fine on a machine with the required fonts installed but may not be rendered properly on another device. To fix this, set EmbedFonts and EmbedCompleteFonts to true during Word-to-PDF conversion to include the fonts in the PDF, ensuring consistent display across all devices.
For more details with implementation, refer to the documentation.
Why are Chinese characters missing or blank in the PDF after Word-to-PDF conversion?
Chinese characters may not appear in the converted PDF if the original Word document uses fonts like Calibri, which do not support Chinese glyphs in PDFs.
To render Chinese and other Unicode characters correctly, we recommend using the Arial Unicode MS font in your Word document. If Arial Unicode MS is not installed on the machine during conversion, the characters will not display properly in the output PDF. To resolve this, install the Arial Unicode MS font on the system before converting the document.
What is the difference between font substitution and fallback fonts in Word to PDF conversion?
| Feature | Fallback Fonts | Font Substitution |
|---|---|---|
| Purpose | Handles missing glyphs in a font. | Replaces an entirely missing font. |
| When It’s Used | A font is present but lacks specific character glyphs. | The required font is not installed on the system. |
| How It Works | Uses an alternative font only for missing glyphs while keeping the original font for other characters. | Replaces the missing font with a specified alternative for all text using that font. |
| Example | Arial does not support Japanese characters, so "Noto Sans JP" is used for those glyphs. | Arial is missing on the system, so "Helvetica" is used instead. |
| Key Benefit | Preserves the original font style while ensuring all text is rendered correctly. | Ensures text consistency when the original font is unavailable. |
| Documentation link | Fallback fonts | Font substitution |
Why does the SkiaSharp exception occur during Word to PDF or image conversion in Linux?
This exception typically occurs due to version mismatches between SkiaSharp and Syncfusion NuGet packages. To avoid this, ensure that compatible versions of SkiaSharp and Syncfusion.DocIO dependencies are used. Refer to the Word to PDF conversion documentation for version compatibility details in Linux.
Why does System.TypeInitializationException occur during Word to PDF or image conversion in Linux using Syncfusion DocIO?
This error usually occurs due to an incompatible GLIBC version on the Linux system. SkiaSharp, used by DocIO for rendering, requires a minimum GLIBC version to function correctly. For example, SkiaSharp version 3.119.1 requires at least GLIBC version 2.29, which is not available in older Linux distributions like Debian 10. If a lower version is present, the conversion may fail with errors such as GLIBC_2.29 not found. To resolve this, ensure the operating system includes the required GLIBC version for the SkiaSharp version being used, or upgrade to a newer Linux distribution.
Is it possible to substitute fonts in a Word document?
No, DocIO does not support substituting fonts within a Word document. Font substitution is applied only during Word-to-PDF and image conversions to ensure rendering accuracy. To change fonts in the actual Word document, refer to: How to change font for all text in a Word document.