Merge pull request #398 from telerik/new-kb-exporting-xlsx-to-pdf-formatting-issues-f3c6937b7d494d70b65394ac207b1a45

Added new kb article exporting-xlsx-to-pdf-formatting-issues

Author: dessyordanova

knowledge-base/exporting-xlsx-to-pdf-formatting-issues.md

@@ -0,0 +1,105 @@
+---
+title: How to Eliminate Formatting Issues when Exporting XLSX to PDF Format
+description: This article provides a solution to formatting difficulties when exporting an XLSX file to PDF using the RadSpreadProcessing library.
+type: troubleshooting
+page_title: How to Eliminate Formatting Issues when Exporting XLSX to PDF Format
+slug: exporting-xlsx-to-pdf-formatting-issues
+tags: excel, pdf, font, width, column, standard
+res_type: kb
+---
+
+##Environment
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| .NET Standard | RadSpreadProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+This article demonstrates how to deal with formatting difficulties when exporting an XLSX file to PDF using the RadSpreadProcessing library in .NET Standard. 
+
+The most common scenario is:
+1. [Export an XLSX file to PDF]({%slug radspreadprocessing-formats-and-conversion-pdf-pdfformatprovider%}) using the RadSpreadProcessing library.
+2. Observe the resulting PDF file with truncated columns or different font.
+
+![Export Differences](images/exporting-xlsx-to-pdf-formatting-issues01.png)   
+
+## Solution
+The limitations of .NET Standard may cause differences in the font and text size (text measuring) when converting to PDF format.
+
+1\. To address the issue with the size discrepancy, set a [SpreadFixedTextMeasurer]({%slug radspreadprocessing-cross-platform-text-measure%}}) to handle the problem with the size:
+
+```csharp
+        SpreadTextMeasurerBase fixedTextMeasurer = new SpreadFixedTextMeasurer();
+        SpreadExtensibilityManager.TextMeasurer = fixedTextMeasurer;
+```
+
+2\. Implement a [FontsProvider]({%slug pdfprocessing-implement-fontsprovider%}) to handle differences in fonts. 
+
+```csharp
+        FontsProviderBase fontsProvider = new FontsProvider();
+        FixedExtensibilityManager.FontsProvider = fontsProvider;
+```
+
+This class provides a mechanism to read the fonts used in the document:
+
+```csharp
+    public class FontsProvider : Telerik.Windows.Documents.Extensibility.FontsProviderBase
+    {
+        public override byte[] GetFontData(Telerik.Windows.Documents.Core.Fonts.FontProperties fontProperties)
+        {
+            string fontFileName = fontProperties.FontFamilyName + ".ttf";
+            string fontFolder = Environment.GetFolderPath(Environment.SpecialFolder.Fonts);
+
+            //The fonts can differ depending on the file 
+            if (fontProperties.FontFamilyName == "Trebuchet MS")
+            {
+                if (fontProperties.FontStyle == FontStyles.Italic && fontProperties.FontWeight == FontWeights.Bold)
+                {
+                    fontFileName = $"trebucbi.ttf";
+                }
+                else if (fontProperties.FontStyle == FontStyles.Italic)
+                {
+                    fontFileName = $"trebucit.ttf";
+                }
+                else if (fontProperties.FontWeight == FontWeights.Normal)
+                {
+                    fontFileName = "trebuc.ttf";
+                }
+                else if (fontProperties.FontWeight == FontWeights.Bold)
+                {
+                    fontFileName = $"trebucbd.ttf";
+                }
+            }        
+            
+
+            //...add more fonts if needed... 
+
+            DirectoryInfo directory = new DirectoryInfo(fontFolder);
+            FileInfo[] fontFiles = directory.GetFiles();
+
+            var fontFile = fontFiles.FirstOrDefault(f => f.Name.Equals(fontFileName, StringComparison.InvariantCultureIgnoreCase));
+            if (fontFile != null)
+            {
+                var targetPath = fontFile.FullName;
+                using (FileStream fileStream = File.OpenRead(targetPath))
+                {
+                    using (MemoryStream memoryStream = new MemoryStream())
+                    {
+                        fileStream.CopyTo(memoryStream);
+                        return memoryStream.ToArray();
+                    }
+                }
+            }
+
+            return null;
+        }
+    }
+```
+Now, the font in the exported PDF document is the correct one and the text is not clipped.
+
+![Hande Export Differences](images/exporting-xlsx-to-pdf-formatting-issues02.png)    
+
+## See Also
+- [Cross-Platform Support]({%slug radspreadprocessing-cross-platform%})
+- [Text Measuring]({%slug radspreadprocessing-cross-platform-text-measure%})
+- [Fonts in PdfProcessing]({%slug radpdfprocessing-cross-platform-fonts%})
+- [How to implement FontsProvider]({%slug pdfprocessing-implement-fontsprovider%})

knowledge-base/images/exporting-xlsx-to-pdf-formatting-issues01.png

@@ -20,3 +20,5 @@ You can find a detailed **FixedExtensibilityManager** and **FontsProvider** desc
 
 >important If the FontsProvider property is not set, a default font will be used when exporting the document.
 	
+## See Also
+- [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})

knowledge-base/images/exporting-xlsx-to-pdf-formatting-issues02.png

@@ -109,7 +109,7 @@ You can assign any **SpreadTextMeasurerBase** implementation to the **SpreadExte
 
 
 ## See Also
-
+ * [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
  * [Cross-Platform Support]({%slug radspreadprocessing-cross-platform%})
  * [Using XlsxFormatProvider]({%slug radspreadprocessing-formats-and-conversion-xlsx-xlsxformatprovider%})
  * [Using PdfFormatProvider]({%slug radspreadprocessing-formats-and-conversion-pdf-pdfformatprovider%})

libraries/radpdfprocessing/cross-platform/fonts.md

@@ -69,6 +69,6 @@ The result from the export method is a document that can be opened in any applic
 >tip __RadFixedDocument__ is the base class of the __RadPdfProcessing__ library. Additional information on the library and its functionality can be found [here]({%slug radpdfprocessing-overview%}).
 
 ## See Also
-
-* [Import/Load and Export/Save RadSpreadProcessing Workbook]({%slug import-export-save-load-workbook%})
+- [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+- [Import/Load and Export/Save RadSpreadProcessing Workbook]({%slug import-export-save-load-workbook%})