polish article

Author: YoanKar

knowledge-base/images/html-pdf-table-no-split-rows.png

@@ -5,53 +5,44 @@ type: how-to
 page_title: Avoiding Table Row Splitting in HTML to PDF Conversion
 meta_title: Avoiding Table Row Splitting in HTML to PDF Conversion
 slug: wordsprocessing-preventing-table-row-splitting-html-pdf
-tags: wordsprocessing,telerik document processing,html-to-pdf,table-row-splitting
+tags: words, processing, telerik, document, html, pdf, conversion, table, row, splitting, split, flow, word, measure, calculate
 res_type: kb
 ticketid: 1700721
 ---
 
-## Environment
-<table>
-<tbody>
-<tr>
-<td> Product </td>
-<td>
-WordsProcessing for Telerik Document Processing
-</td>
-</tr>
-<tr>
-<td> Version </td>
-<td> Current </td>
-</tr>
-</tbody>
-</table>
+# Environment
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2025.3.806 | RadWordsProcessing |[Yoan Karamanov](https://www.telerik.com/blogs/author/yoan-karamanov)| 
 
 ## Description
 
-I want to convert HTML with tables containing uneven row heights to a PDF using Telerik Document Processing. My issue arises when some rows split across pages, even though I need them to stay intact. In my previous implementation using another library, `page-break-inside: avoid` handled this behavior correctly. However, this style does not seem to work with Telerik's methods. 
+This article shows how to use [WordsProcessing]({%slug radwordsprocessing-overview%}) and [PdfProcessing]({%slug radpdfprocessing-overview%}) libraries to convert HTML with tables to a PDF, without splitting rows across pages.
 
 This knowledge base article also answers the following questions:
 - How can I prevent table rows from splitting across pages during HTML to PDF conversion?
 - How do I handle uneven row heights in tables when exporting to PDF?
-- How can I ensure HTML table rows are preserved on a single page in Telerik Document Processing?
+- How can I ensure HTML table rows are preserved on a single page during HTML to PDF conversion?
 
 ## Solution
 
-To prevent table rows from splitting across pages, manually recreate the PDF table from scratch by copying the HTML table content to a new PDF table. Use the `Measure` method to check whether the table exceeds the page boundary. If it does, create a new page and continue building the table.
+To prevent table rows from splitting across pages, manually recreate the PDF table from scratch by copying the HTML table content to a new PDF table. Use the **Measure** method to check whether the table exceeds the page boundary. If it does, create a new page and continue building the table.
 
 ### Steps to Implement
 
-1. **Set up the HTML import settings:** Use the `HtmlFormatProvider` and implement the `LoadImageFromUri` event for resolving images in the HTML content.
+1. **Set up the HTML import settings:** Use the [HtmlFormatProvider]({%slug radwordsprocessing-formats-and-conversion-html-htmlformatprovider%}) and implement the [LoadImageFromUri]({%slug radwordsprocessing-formats-and-conversion-html-settings%}#loadimagefromuri-and-loadstylesheetfromuri-events) event for resolving images in the HTML content.
 
-2. **Load the HTML document:** Import the HTML content into a `RadFlowDocument` object.
+2. **Load the HTML document:** Import the HTML content into a [RadFlowDocument]({%slug radwordsprocessing-model-radflowdocument%}) object.
 
 3. **Extract rows from the HTML table:** Enumerate the rows from the HTML table.
 
-4. **Create a new PDF table:** For each page, create a new table and add rows while ensuring they fit within the page boundaries.
+4. **Create and format a new PDF table:** For each page, create a new table and add rows while ensuring they fit within the page boundaries, while also setting the desired formatting.
 
-5. **Check row measurements:** After adding each row, use the `Measure` method to verify whether the table exceeds the page height. If it does, move the remaining rows to a new page.
+5. **Check row measurements:** After adding each row, use the **Measure** method to verify whether the table exceeds the page height. If it does, move the remaining rows to a new page.
 
-6. **Export the PDF:** Use the `PdfFormatProvider` to save the final PDF document.
+6. **Export the PDF:** Use the [PdfFormatProvider]({%slug radpdfprocessing-formats-and-conversion-pdf-pdfformatprovider%}) to save the final PDF document.
+
+![HTML to PDF Table Without Split Rows](images/html-pdf-table-no-split-rows.png) 
 
 ### Code Example
 
@@ -61,7 +52,6 @@ const string OutputPdfPath = "..\\..\\..\\output.pdf";
 
 static void Main(string[] args)
 {
-    // Load HTML document
     HtmlFormatProvider htmlFormatProvider = new HtmlFormatProvider();
     HtmlImportSettings importSettings = new HtmlImportSettings();
 
@@ -83,6 +73,7 @@ static void Main(string[] args)
     var mainPdfDocument = new RadFixedDocument();
     int currentRowIndex = 0;
 
+    // Process rows across multiple pages
     while (currentRowIndex < htmlRows.Count)
     {
         var pdfPage = mainPdfDocument.Pages.AddPage();
@@ -93,12 +84,14 @@ static void Main(string[] args)
         {
             var testTable = CreateNewTable();
 
+            // Copy existing rows to test table
             for (int i = currentRowIndex - rowsAdded; i < currentRowIndex; i++)
                 if (i >= 0) AddRowToTable(testTable, htmlRows[i], pdfPage);
 
             AddRowToTable(testTable, htmlRows[currentRowIndex], pdfPage);
 
-            if (testTable.Measure().Height > pdfPage.Size.Height - 40 && rowsAdded > 0)
+            // Check if exceeds page height
+            if (testTable.Measure().Height > pdfPage.Size.Height && rowsAdded > 0)
                 break;
 
             AddRowToTable(pdfTable, htmlRows[currentRowIndex], pdfPage);
@@ -118,26 +111,30 @@ static void Main(string[] args)
 
 private static Telerik.Windows.Documents.Fixed.Model.Editing.Tables.Table CreateNewTable()
 {
-    var border = new Telerik.Windows.Documents.Fixed.Model.Editing.Border(2, new RgbColor(0, 0, 0));
+    var border = new Border(1, new RgbColor(0, 0, 0));
     return new Telerik.Windows.Documents.Fixed.Model.Editing.Tables.Table
     {
         DefaultCellProperties = { Borders = new Telerik.Windows.Documents.Fixed.Model.Editing.Tables.TableCellBorders(border, border, border, border) },
-        Margin = new System.Windows.Thickness(10)
+        Margin = new Thickness(10)
     };
 }
 
-private static void AddRowToTable(Telerik.Windows.Documents.Fixed.Model.Editing.Tables.Table pdfTable, Telerik.Windows.Documents.Flow.Model.TableRow htmlRow, RadFixedPage pdfPage)
+private static void AddRowToTable(Telerik.Windows.Documents.Fixed.Model.Editing.Tables.Table pdfTable, TableRow htmlRow, RadFixedPage pdfPage)
 {
     var pdfRow = pdfTable.Rows.AddTableRow();
 
     for (int i = 0; i < htmlRow.Cells.Count; i++)
     {
         var pdfCell = pdfRow.Cells.AddTableCell();
-        pdfCell.PreferredWidth = pdfPage.Size.Width * (i == 0 ? 0.10 : 0.80);
+        pdfCell.PreferredWidth = pdfPage.Size.Width * (i == 0 ? 0.05 : 0.25);
+        pdfCell.Padding = new Thickness(5);
+        pdfCell.Background = (pdfTable.Rows.Count % 2 == 0 ? new RgbColor(249, 249, 249) : new RgbColor(255, 255, 255));
 
-        foreach (var htmlBlock in htmlRow.Cells[i].Blocks.OfType<Telerik.Windows.Documents.Flow.Model.Paragraph>())
+        foreach (var htmlBlock in htmlRow.Cells[i].Blocks.OfType<Paragraph>())
         {
             var pdfBlock = pdfCell.Blocks.AddBlock();
+            pdfBlock.HorizontalAlignment = Telerik.Windows.Documents.Fixed.Model.Editing.Flow.HorizontalAlignment.Left;
+            pdfBlock.VerticalAlignment = Telerik.Windows.Documents.Fixed.Model.Editing.Flow.VerticalAlignment.Center;
 
             foreach (var htmlInline in htmlBlock.Inlines)
             {
@@ -146,8 +143,8 @@ private static void AddRowToTable(Telerik.Windows.Documents.Fixed.Model.Editing.
                     using (var stream = new MemoryStream(htmlImageInline.Image.ImageSource.Data))
                         pdfBlock.InsertImage(new Telerik.Windows.Documents.Fixed.Model.Resources.ImageSource(stream));
                 }
-                else if (htmlInline is Telerik.Windows.Documents.Flow.Model.Run run)
-                {
+                else if (htmlInline is Run run)
+                {                         
                     pdfBlock.InsertText(run.Text);
                 }
                 else if (htmlInline is Break)
@@ -161,7 +158,7 @@ private static void AddRowToTable(Telerik.Windows.Documents.Fixed.Model.Editing.
 ```
 
 ## See Also
-- [HtmlFormatProvider Overview](https://docs.telerik.com/devtools/document-processing/libraries/radwordsprocessing/formats-and-conversion/html/html-overview)
-- [RadFixedDocument API Reference](https://docs.telerik.com/devtools/document-processing/api/telerik.windows.documents.fixed.model.radfixeddocument)
-- [PdfFormatProvider Overview](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/formats-and-conversion/pdf/pdf-overview)
+* [Table]({%slug radpdfprocessing-editing-table-overview%})
+* [TableRow]({%slug radpdfprocessing-editing-table-tablerow%})
+* [TableCell]({%slug radpdfprocessing-editing-table-tablecell%})
 ---