Skip to content

Commit 87d66c9

Browse files
authored
Merge branch 'hotfix/hotfix-v31.2.12' into 989214-EnableFileNameWithExtension
2 parents 1f28d6d + f358ac0 commit 87d66c9

File tree

8 files changed

+400
-32
lines changed

8 files changed

+400
-32
lines changed

Document-Processing-toc.html

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@
1717
<li>
1818
<a href="/document-processing/ai-coding-assistant/mcp-server">MCP Server</a>
1919
</li>
20+
<li>
21+
<a href="/document-processing/ai-coding-assistant/prompt-library">Prompt Library</a>
22+
</li>
2023
</ul>
2124
</li>
2225
<li>Installation<ul>
@@ -5891,6 +5894,21 @@
58915894
<li>
58925895
<a href="/document-processing/excel/excel-library/net/faqs/how-to-extract-embedded-OLE-files-from-an-Excel-workbook-as-streams">How to extract embedded OLE files from an Excel workbook as streams?</a>
58935896
</li>
5897+
<li>
5898+
<a href="/document-processing/excel/excel-library/net/faqs/how-to-copy-the-used-range-from-one-Excel-workbook-to-another">How to copy the used range from one Excel workbook to another?</a>
5899+
</li>
5900+
<li>
5901+
<a href="/document-processing/excel/excel-library/net/faqs/how-does-xlsio-handle-empty-string-display-text-in-hyperlinks">How does XlsIO handle empty string display text in hyperlinks?</a>
5902+
</li>
5903+
<li>
5904+
<a href="/document-processing/excel/excel-library/net/faqs/what-is-the-maximum-row-height-in-Excel">What is the maximum row height in Excel?</a>
5905+
</li>
5906+
<li>
5907+
<a href="/document-processing/excel/excel-library/net/faqs/does-xlsio-support-importing-HTML-images-into-Excel">Does XlsIO support importing HTML images into Excel?</a>
5908+
</li>
5909+
<li>
5910+
<a href="/document-processing/excel/excel-library/net/faqs/how-to-apply-number-formatting-to-an-entire-column-in-Excel">How to apply number formatting to an entire column in Excel?</a>
5911+
</li>
58945912
</ul>
58955913
</li>
58965914
</ul>
@@ -7039,7 +7057,8 @@
70397057
<ul>
70407058
<li>
70417059
Weekly Nuget Release
7042-
<ul><li><a href="/document-processing/release-notes/v31.2.16">v31.2.16</a></li>
7060+
<ul><li><a href="/document-processing/release-notes/v31.2.18">v31.2.18</a></li>
7061+
<li><a href="/document-processing/release-notes/v31.2.16">v31.2.16</a></li>
70437062
<li><a href="/document-processing/release-notes/v31.2.15">v31.2.15</a></li>
70447063
<li><a href="/document-processing/release-notes/v31.2.10">v31.2.10</a></li>
70457064
<li><a href="/document-processing/release-notes/v31.2.5">v31.2.5</a></li>

Document-Processing/Excel/Excel-Library/NET/Worksheet-Rows-and-Columns-Manipulation.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -950,6 +950,8 @@ End Using
950950

951951
A complete working example to expand or collapse groups in an Excel worksheet in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Format%20rows%20and%20columns/Expand%20or%20Collapse%20Groups/.NET/Expand%20or%20Collapse%20Groups).
952952

953+
N> The <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_RowHeight">RowHeight</a> or <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IRange.html#Syncfusion_XlsIO_IRange_ColumnWidth">ColumnWidth</a> of collapsed rows or columns will be 0.
954+
953955
### Subtotal
954956

955957
The XlsIO supports subtotaling a group to quickly calculate rows of related data by inserting subtotals and totals.
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
title: Hyperlink display text behavior | Syncfusion
3+
description: This page explains how Syncfusion XlsIO handles empty string display text in hyperlinks, consistent with Microsoft Excel behavior.
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# How does XlsIO handle empty string display text in hyperlinks?
10+
11+
As per Microsoft Excel behavior, hyperlinks cannot be assigned with empty display text values. When the display text of a hyperlink is set to an empty string, Excel automatically uses the hyperlink address itself as the display text. Syncfusion XlsIO follows the same behavior.
12+
13+
If a user does not provide a <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IHyperLink.html#Syncfusion_XlsIO_IHyperLink_TextToDisplay">TextToDisplay</a> value explicitly after assigning a hyperlink <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IHyperLink.html#Syncfusion_XlsIO_IHyperLink_Address">Address</a>, XlsIO uses the address value as the display text to match Excel behavior. If <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IHyperLink.html#Syncfusion_XlsIO_IHyperLink_TextToDisplay">TextToDisplay</a> is assigned after the <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IHyperLink.html#Syncfusion_XlsIO_IHyperLink_Address">Address</a>, that value is used.
14+
15+
{% tabs %}
16+
{% highlight c# tabtitle="C# [Cross-platform]" %}
17+
//Case 1: Without TextToDisplay - address itself is used as display text
18+
IHyperLink hyperlink1 = sheet.HyperLinks.Add(sheet.Range["A1"]);
19+
hyperlink1.Type = ExcelHyperLinkType.Url;
20+
hyperlink1.Address = "http://www.syncfusion.com"; //Display text will be "http://www.syncfusion.com"
21+
22+
//Case 2: With TextToDisplay - provided text is used as display text
23+
IHyperLink hyperlink2 = sheet.HyperLinks.Add(sheet.Range["A2"]);
24+
hyperlink2.Type = ExcelHyperLinkType.Url;
25+
hyperlink2.Address = "http://www.syncfusion.com";
26+
hyperlink2.TextToDisplay = "syncfusion"; //Display text will be "syncfusion"
27+
{% endhighlight %}
28+
29+
{% highlight c# tabtitle="C# [Windows-specific]" %}
30+
//Case 1: Without TextToDisplay - address itself is used as display text
31+
IHyperLink hyperlink1 = sheet.HyperLinks.Add(sheet.Range["A1"]);
32+
hyperlink1.Type = ExcelHyperLinkType.Url;
33+
hyperlink1.Address = "http://www.syncfusion.com"; //Display text will be "http://www.syncfusion.com"
34+
35+
//Case 2: With TextToDisplay - provided text is used as display text
36+
IHyperLink hyperlink2 = sheet.HyperLinks.Add(sheet.Range["A2"]);
37+
hyperlink2.Type = ExcelHyperLinkType.Url;
38+
hyperlink2.Address = "http://www.syncfusion.com";
39+
hyperlink2.TextToDisplay = "syncfusion"; //Display text will be "syncfusion"
40+
{% endhighlight %}
41+
42+
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
43+
'Case 1: Without TextToDisplay - address itself is used as display text
44+
Dim hyperlink1 As IHyperLink = sheet.HyperLinks.Add(sheet.Range("A1"))
45+
hyperlink1.Type = ExcelHyperLinkType.Url
46+
hyperlink1.Address = "http://www.syncfusion.com" 'Display text will be "http://www.syncfusion.com"
47+
48+
'Case 2: With TextToDisplay - provided text is used as display text
49+
Dim hyperlink2 As IHyperLink = sheet.HyperLinks.Add(sheet.Range("A2"))
50+
hyperlink2.Type = ExcelHyperLinkType.Url
51+
hyperlink2.Address = "http://www.syncfusion.com"
52+
hyperlink2.TextToDisplay = "syncfusion" 'Display text will be "syncfusion"
53+
{% endhighlight %}
54+
{% endtabs %}

Document-Processing/PDF/PDF-Library/NET/Working-with-Annotations.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5742,7 +5742,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
57425742

57435743
The Essential<sup>&reg;</sup> PDF supports removing comments and reviewing status from the PDF annotation.
57445744

5745-
The following code example explains how to remove comments using [RemoveAt](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedPageCollection.html#Syncfusion_Pdf_Parsing_PdfLoadedPageCollection_RemoveAt_System_Int32_) method from the existing PDF annotation.
5745+
The following code example explains how to remove comments using [RemoveAt](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedPopupAnnotationCollection.html#Syncfusion_Pdf_Parsing_PdfLoadedPopupAnnotationCollection_RemoveAt_System_Int32_) method from the existing PDF annotation.
57465746

57475747
{% tabs %}
57485748

@@ -5766,7 +5766,7 @@ PdfLoadedPopupAnnotationCollection commentsCollection = loadedRectangleAnnotatio
57665766
commentsCollection.RemoveAt(0);
57675767

57685768
//Save the document
5769-
lDoc.Save("Output.pdf");
5769+
ldoc.Save("Output.pdf");
57705770
//Closes the document
57715771
ldoc.Close(true);
57725772
{% endhighlight %}

Document-Processing/PDF/PDF-Library/NET/Working-with-Document-Conversions.md

Lines changed: 35 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ For ASP.NET Core and Xamarin applications
8383
* using Syncfusion.DocIORenderer
8484
* using Syncfusion.Pdf
8585

86-
[DocToPDFConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class is responsible for converting a Word document into PDF. The following code snippet illustrates how to convert a Word document into PDF document.
86+
[DocToPDFConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class is responsible for converting a Word document into PDF. The following code snippet illustrates how to convert a Word document into PDF document.
8787

8888
{% tabs %}
8989

@@ -162,13 +162,13 @@ wordDocument.Close()
162162
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Document%20conversion/Word-to-PDF/Converting-Word-to-PDF-document).
163163

164164
Note:
165-
* Initializing the [ChartToImageConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.OfficeChartToImageConverter.ChartToImageConverter.html) is mandatory to convert the charts present in the Word document to PDF. Otherwise the charts will not be exported to the converted PDF.
166-
* [ChartToImageConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.OfficeChartToImageConverter.ChartToImageConverter.html) is supported from .NET Framework 4.0 onwards.
165+
* Initializing the [ChartToImageConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.OfficeChartToImageConverter.ChartToImageConverter.html) is mandatory to convert the charts present in the Word document to PDF. Otherwise the charts will not be exported to the converted PDF.
166+
* [ChartToImageConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.OfficeChartToImageConverter.ChartToImageConverter.html) is supported from .NET Framework 4.0 onwards.
167167
* Total number of pages may vary based on unsupported elements in the converted PDF document when compare to Word document.
168168

169169
### Customizing the Word document to PDF conversion
170170

171-
Essential<sup>&reg;</sup> DocIO allows you to customize the Word to PDF conversion using [DocToPDFConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class with the below options:
171+
Essential<sup>&reg;</sup> DocIO allows you to customize the Word to PDF conversion using [DocToPDFConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class with the below options:
172172

173173
* Allows to determine the quality of the charts in the converted PDF.
174174
* Allows to determine the quality of the JPEG images in the converted PDF.
@@ -258,7 +258,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
258258

259259
## Converting Excel documents to PDF
260260

261-
[ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.ExcelToPDFConverter.Base~Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html) is responsible for converting an Excel document into PDF. Essential<sup>&reg;</sup> PDF allows you to convert an entire workbook or a single worksheet into PDF document. Refer to the following links for assemblies/nuget packages required based on platforms to convert Excel document into PDF.
261+
[ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPDFConverter.Base~Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html) is responsible for converting an Excel document into PDF. Essential<sup>&reg;</sup> PDF allows you to convert an entire workbook or a single worksheet into PDF document. Refer to the following links for assemblies/nuget packages required based on platforms to convert Excel document into PDF.
262262

263263
* [Assemblies Information](https://help.syncfusion.com/document-processing/pdf/pdf-library/net/assemblies-required#converting-excel-document-to-pdf)
264264
* [NuGet Information](https://help.syncfusion.com/document-processing/pdf/pdf-library/net/nuget-packages-required#converting-excel-document-to-pdf)
@@ -267,7 +267,7 @@ N> Excel to PDF conversion works proper in Blazor server-side alone and not in c
267267

268268
### Converting a Workbook to PDF
269269

270-
The following code illustrates how to convert a workbook to PDF Document using [IWorkbook](https://help.syncfusion.com/cr/document-processings/Syncfusion.XlsIO.IWorkbook.html) type in [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorkbook_) class.
270+
The following code illustrates how to convert a workbook to PDF Document using [IWorkbook](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorkbook.html) type in [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorkbook_) class.
271271

272272
{% tabs %}
273273

@@ -346,7 +346,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
346346

347347
### Converting a Worksheet to PDF
348348

349-
The following code shows how to convert a particular sheet to PDF Document using [IWorksheet](https://help.syncfusion.com/cr/document-processings/Syncfusion.XlsIO.IWorksheet.html) type in [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorksheet_) class.
349+
The following code shows how to convert a particular sheet to PDF Document using [IWorksheet](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html) type in [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorksheet_) class.
350350

351351
{% tabs %}
352352

@@ -433,7 +433,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
433433

434434
### Creating individual PDF document for each worksheet
435435

436-
The following code snippet shows how to create an individual PDF document for each worksheet in a workbook using [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorksheet_) class.
436+
The following code snippet shows how to create an individual PDF document for each worksheet in a workbook using [ExcelToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverter.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverter__ctor_Syncfusion_XlsIO_IWorksheet_) class.
437437

438438
{% tabs %}
439439

@@ -524,7 +524,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
524524

525525
### Excel with Chart to PDF
526526

527-
To preserve the charts during Excel to PDF conversion, you should initialize the [ChartToImageConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.XlsIO.IApplication.html#Syncfusion_XlsIO_IApplication_ChartToImageConverter) of [IApplication](https://help.syncfusion.com/cr/document-processings/Syncfusion.XlsIO.Base~Syncfusion.XlsIO.IApplication.html) interface, otherwise the charts present in worksheet will get skipped. The following code illustrate how to convert an Excel with chart to PDF document.
527+
To preserve the charts during Excel to PDF conversion, you should initialize the [ChartToImageConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IApplication.html#Syncfusion_XlsIO_IApplication_ChartToImageConverter) of [IApplication](https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.Base~Syncfusion.XlsIO.IApplication.html) interface, otherwise the charts present in worksheet will get skipped. The following code illustrate how to convert an Excel with chart to PDF document.
528528

529529
{% tabs %}
530530

@@ -698,7 +698,7 @@ For ASP.NET Core and Xamarin applications
698698
* using Syncfusion.DocIORenderer
699699
* using Syncfusion.Pdf
700700

701-
[DocToPDFConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.DocToPDFConverter.Base~Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class is responsible for converting a RTF to PDF. The following code snippet illustrates how to convert a RTF to PDF document.
701+
[DocToPDFConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocToPDFConverter.Base~Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class is responsible for converting a RTF to PDF. The following code snippet illustrates how to convert a RTF to PDF document.
702702

703703
{% tabs %}
704704

@@ -774,7 +774,7 @@ N> Total number of pages may vary based on unsupported elements in the converte
774774

775775
### Customizing the RTF to PDF conversion
776776

777-
Essential<sup>&reg;</sup> DocIO allows you to customize the RTF to PDF conversion using [DocToPDFConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class with the below options:
777+
Essential<sup>&reg;</sup> DocIO allows you to customize the RTF to PDF conversion using [DocToPDFConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocToPDFConverter.DocToPDFConverter.html) class with the below options:
778778

779779
* Allows to determine the quality of the JPEG images in the converted PDF.
780780
* Allows to reduce the Main Memory usage in RTF to PDF conversion by reusing the identical images.
@@ -851,7 +851,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
851851

852852
### Converting multi page TIFF to PDF
853853

854-
Multi frame TIFF image can be converted to PDF document using [PdfBitmap](https://help.syncfusion.com/cr/document-processings/Syncfusion.Pdf.Graphics.PdfBitmap.html) class. This can be done by accessing each frame of the multi frame TIFF image and rendering it in each page of the PDF document.
854+
Multi frame TIFF image can be converted to PDF document using [PdfBitmap](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfBitmap.html) class. This can be done by accessing each frame of the multi frame TIFF image and rendering it in each page of the PDF document.
855855

856856
The code snippet to illustrate the same is given below.
857857

@@ -985,7 +985,28 @@ N> 1. Essential<sup>&reg;</sup> PDF supports converting TIFF to PDF with [Syncfu
985985

986986
Essential<sup>&reg;</sup> PDF supports JBIG2 compression for best compression of monochrome images.
987987

988-
Refer the below code snippet to draw a single frame monochrome TIFF image with JBIG2 compression using [EncodingType](https://help.syncfusion.com/cr/document-processings/Syncfusion.Pdf.Graphics.EncodingType.html) Enum.
988+
Refer the below code snippet to draw a single frame monochrome TIFF image with JBIG2 compression using [EncodingType](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.EncodingType.html) Enum.
989+
990+
<table border="1">
991+
<th style="font-size:14px" width="100px">Encoding Type</th>
992+
<th style="font-size:14px">Image Type</th>
993+
<th style="font-size:14px">Compression Applied</th>
994+
<tr>
995+
<td>Default</td>
996+
<td>Non-TIFF images</td>
997+
<td>Applies <b>Deflate (DEFLATE)</b> compression to monochrome, grayscale, and color images.</td>
998+
</tr>
999+
<tr>
1000+
<td>Default</td>
1001+
<td>TIFF images</td>
1002+
<td>Monochrome TIFF images use <b>CCITT Group 4 (CCITT4)</b> compression by default.</td>
1003+
</tr>
1004+
<tr>
1005+
<td>JBIG2</td>
1006+
<td>Monochrome (bi-level)</td>
1007+
<td>Supported only in lossy mode and only for single-frame TIFF images.</td>
1008+
</tr>
1009+
</table>
9891010

9901011
{% tabs %}
9911012

@@ -1055,7 +1076,7 @@ N> 2. By default, all monochrome images will be compressed in CITTT4 compression
10551076

10561077
The XPS (XML Paper Specification) document format is a fixed document format which consists of structured XML markup that defines the layout of a document and the visual appearance of each page, along with rendering rules for distributing, archiving, rendering, processing and printing the documents.
10571078

1058-
Essential<sup>&reg;</sup> PDF provides support for converting XPS to PDF using [XPSToPdfConverter](https://help.syncfusion.com/cr/document-processings/Syncfusion.Pdf.Base~Syncfusion.XPS.XPSToPdfConverter.html) class.
1079+
Essential<sup>&reg;</sup> PDF provides support for converting XPS to PDF using [XPSToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Base~Syncfusion.XPS.XPSToPdfConverter.html) class.
10591080

10601081
The below code illustrates how to convert XPS to PDF.
10611082

0 commit comments

Comments
 (0)