Added new kb article avoid-table-splits-across-pages-radpdfprocessing

Author: KB Bot

knowledge-base/avoid-table-splits-across-pages-radpdfprocessing.md

@@ -0,0 +1,117 @@
+---
+title: Avoiding Table Splits Across Pages in RadPdfProcessing
+description: Learn how to manage tables in RadPdfProcessing to prevent them from splitting across pages in a PDF document.
+type: how-to
+page_title: Prevent Table Splits Across Pages in RadPdfProcessing
+slug: avoid-table-splits-across-pages-radpdfprocessing
+tags: radpdfprocessing, tables, document-processing, positioning, page-break
+res_type: kb
+ticketid: 1686584
+---
+
+## Environment
+
+| Version | Product | Author | 
+| ---- | ---- | ---- | 
+| 2025.1.205| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+When adding tables in RadPdfProcessing using the [RadFixedDocumentEditor](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/radfixeddocumenteditor), tables may sometimes split across pages if they cannot fit within the remaining space on the current page. To ensure a table fits entirely on one page and starts on a new page if necessary, you can adopt a strategy to measure the table size and calculate the remaining page height.
+
+This knowledge base article also answers the following questions:
+- How to stop tables from splitting across pages in RadPdfProcessing?
+- How to apply page breaks before adding tables in RadPdfProcessing?
+- What is the best way to manage table positioning in RadPdfProcessing?
+
+## Solution
+
+### Using RadFixedDocumentEditor
+
+Measuring the table and calculating the remaining page height is a valid approach. Here's how you can implement it:
+
+```csharp
+var tableSize = table1.Measure().Height;
+double remainingPageHeight = availablePageHeight - tableSize;
+
+if (remainingPageHeight <= minimumRemainingHeight)
+{
+    editor.InsertPageBreak();
+    editor.InsertTable(table1);
+    editor.InsertLineBreak();
+    availablePageHeight = editor.SectionProperties.PageSize.Height 
+                         - (editor.SectionProperties.PageMargins.Top + editor.SectionProperties.PageMargins.Bottom) 
+                         - tableSize - lineBreakSize;
+}
+else
+{
+    editor.InsertTable(table1);
+    editor.InsertLineBreak();
+}
+```
+
+### Using FixedContentEditor for Precise Control
+
+For more precise positioning, you can use the [FixedContentEditor](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/fixedcontenteditor). This editor allows you to measure and draw tables with exact positioning. Below is an example implementation:
+
+```csharp
+RadFixedDocument document = new RadFixedDocument();
+RadFixedPage page = document.Pages.AddPage();
+
+FixedContentEditor editor = new FixedContentEditor(page);
+Point currentPosition = new Point(0, 0);
+
+List<Table> tables = new List<Table>(); 
+tables.Add(GenerateTable(50));  // Large table
+tables.Add(GenerateTable(15));  // Small table
+
+foreach (Table item in tables)
+{
+    Size size = item.Measure();
+
+    if (size.Height < (page.Size.Height - currentPosition.Y))
+    {
+        editor.Position.Translate(currentPosition.X, currentPosition.Y);
+        currentPosition = new Point(0, currentPosition.Y + size.Height + 10);
+        editor.DrawTable(item);
+    }
+    else
+    {
+        page = document.Pages.AddPage();
+        editor = new FixedContentEditor(page);
+        editor.DrawTable(item);
+        currentPosition = new Point(0, size.Height + 10);
+    }
+}
+
+PdfFormatProvider provider = new PdfFormatProvider();
+string outputFilePath = "exported.pdf";
+File.Delete(outputFilePath);
+File.WriteAllBytes(outputFilePath, provider.Export(document, TimeSpan.FromSeconds(10)));
+Process.Start(new ProcessStartInfo() { FileName = outputFilePath, UseShellExecute = true });
+
+private static Telerik.Windows.Documents.Fixed.Model.Editing.Tables.Table GenerateTable(int numberOfRows)
+{ 
+    Table table = new Table();
+    table.LayoutType = Telerik.Windows.Documents.Fixed.Model.Editing.Flow.TableLayoutType.FixedWidth;
+
+    for (int i = 0; i < numberOfRows; i++)
+    {
+        TableRow row = table.Rows.AddTableRow();
+        TableCell cell = row.Cells.AddTableCell();
+        cell.Blocks.AddBlock().InsertText("Row: "+i);
+    }
+    
+    return table;
+}
+```
+
+### Key Points
+1. **RadFixedDocumentEditor** is flow-based, and requires measuring and adding page breaks manually.
+2. **FixedContentEditor** provides precise control over positioning and avoids table splits by managing the drawing location explicitly.
+
+## See Also
+- [RadFixedDocumentEditor Overview](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/radfixeddocumenteditor)
+- [FixedContentEditor Overview](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/fixedcontenteditor)
+- [Drawing Tables with RadFixedDocumentEditor](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/table#drawing-table-with-radfixeddocumenteditor)
+- [Drawing Tables with FixedContentEditor](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/table#drawing-table-with-fixedcontenteditor)