Added support for custom ellipsis for the ClampLines feature

Source/QuestPDF.Examples/TextExamples.cs

@@ -1084,5 +1084,26 @@ namespace QuestPDF.Examples
                      }
                  });
          }
+         
+         [Test]
+         public void ClampLines()
+         {
+             RenderingTest
+                 .Create()
+                 .PageSize(300, 100)
+                
+                 .ProduceImages()
+                 .ShowResults()
+                 .Render(container =>
+                 {
+                     container
+                         .Padding(5)
+                         .MinimalBox()
+                         .Border(1)
+                         .Padding(10)
+                         .Text(Placeholders.Paragraph())
+                         .ClampLines(2, " [...]");
+                 });
+         }
     }
 }

Source/QuestPDF/Elements/Text/TextBlock.cs

@@ -17,6 +17,7 @@ namespace QuestPDF.Elements.Text
         
         public TextHorizontalAlignment? Alignment { get; set; }
         public int? LineClamp { get; set; }
+        public string LineClampEllipsis { get; set; }
         public List<ITextBlockItem> Items { get; set; } = new();
 
         private SkParagraph Paragraph { get; set; }
@@ -230,11 +231,14 @@ namespace QuestPDF.Elements.Text
 
         private void BuildParagraph()
         {
+            using var clampLinesEllipsis = new SkText(LineClampEllipsis);
+            
             var paragraphStyle = new ParagraphStyleConfiguration
             {
                 Alignment = MapAlignment(Alignment ?? TextHorizontalAlignment.Start),
                 Direction = MapDirection(ContentDirection),
-                MaxLinesVisible = LineClamp ?? 1_000_000
+                MaxLinesVisible = LineClamp ?? 1_000_000,
+                LineClampEllipsis = clampLinesEllipsis.Instance
             };
             
             var builder = SkParagraphBuilderPoolManager.Get(paragraphStyle);

Source/QuestPDF/Fluent/TextExtensions.cs

@@ -111,9 +111,10 @@ namespace QuestPDF.Fluent
         }
 
         /// <include file='../Resources/Documentation.xml' path='documentation/doc[@for="text.clampLines"]/*' />
-        public TextBlockDescriptor ClampLines(int maxLines)
+        public TextBlockDescriptor ClampLines(int maxLines, string ellipsis = TextDescriptor.DefaultLineClampEllipsis)
         {
             TextBlock.LineClamp = maxLines;
+            TextBlock.LineClampEllipsis = ellipsis;
             return this;
         }
     }
@@ -123,6 +124,8 @@ namespace QuestPDF.Fluent
         internal TextBlock TextBlock { get; } = new();
         private TextStyle? DefaultStyle { get; set; }
 
+        internal const string DefaultLineClampEllipsis = "…";
+        
         /// <summary>
         /// Applies a consistent text style for the whole content within this <see cref="TextExtensions.Text">Text</see> element.
         /// </summary>
@@ -178,9 +181,10 @@ namespace QuestPDF.Fluent
         }
 
         /// <include file='../Resources/Documentation.xml' path='documentation/doc[@for="text.clampLines"]/*' />
-        public void ClampLines(int maxLines)
+        public void ClampLines(int maxLines, string ellipsis = DefaultLineClampEllipsis)
         {
             TextBlock.LineClamp = maxLines;
+            TextBlock.LineClampEllipsis = ellipsis;
         }
         
         [Obsolete("This method is not supported since the 2024.3 version. Please split your text into separate paragraphs, combine using the Column element that also provides the Spacing capability.")]

Source/QuestPDF/Skia/Text/SkParagraphBuilder.cs

@@ -9,6 +9,7 @@ internal record struct ParagraphStyleConfiguration
     public TextAlign Alignment;
     public TextDirection Direction;
     public int MaxLinesVisible;
+    public IntPtr LineClampEllipsis; // SKText
 
     internal enum TextAlign
     {