Skip to content

Commit 67cf19d

Browse files
author
DivyaUdhayakumar
committed
2 parents a4510e0 + aea7ff7 commit 67cf19d

38 files changed

+701
-64
lines changed

‎Document-Processing-toc.html‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5167,6 +5167,7 @@
51675167
<li><a href="/document-processing/excel/spreadsheet/blazor/cell-range">Cell Range</a></li>
51685168
<li><a href="/document-processing/excel/spreadsheet/blazor/editing">Editing</a></li>
51695169
<li><a href="/document-processing/excel/spreadsheet/blazor/formulas">Formulas</a></li>
5170+
<li><a href="/document-processing/excel/spreadsheet/blazor/formatting">Formatting</a></li>
51705171
<li><a href="/document-processing/excel/spreadsheet/blazor/contextmenu">Context Menu</a></li>
51715172
<li><a href="/document-processing/excel/spreadsheet/blazor/rows-and-columns">Rows and Columns</a></li>
51725173
<li><a href="/document-processing/excel/spreadsheet/blazor/filtering">Filtering</a></li>
@@ -5177,6 +5178,8 @@
51775178
<li><a href="/document-processing/excel/spreadsheet/blazor/protection">Protection</a></li>
51785179
<li><a href="/document-processing/excel/spreadsheet/blazor/undo-redo">Undo and Redo</a></li>
51795180
<li><a href="/document-processing/excel/spreadsheet/blazor/accessibility">Accessibility</a></li>
5181+
<li><a href="/document-processing/excel/spreadsheet/blazor/events">Events</a></li>
5182+
<li><a href="https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html">API Reference</a></li>
51805183
</ul>
51815184
</li>
51825185
</ul>
@@ -6049,6 +6052,21 @@
60496052
<li>
60506053
<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>
60516054
</li>
6055+
<li>
6056+
<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>
6057+
</li>
6058+
<li>
6059+
<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>
6060+
</li>
6061+
<li>
6062+
<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>
6063+
</li>
6064+
<li>
6065+
<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>
6066+
</li>
6067+
<li>
6068+
<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>
6069+
</li>
60526070
</ul>
60536071
</li>
60546072
</ul>

‎Document-Processing/Excel/Conversions/Chart-to-Image/NET/Chart-to-Image-Conversion.md‎

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,9 @@ Line
183183
<td>
184184
* Line<br/>
185185
* Line_Markers<br/>
186-
* Line_3D
186+
* Line_3D<br/>
187+
* Stacked_Line<br/>
188+
* Stacked_Line_Markers
187189
</td>
188190
</tr>
189191
<tr>
@@ -194,7 +196,8 @@ Pie
194196
* Pie<br/>
195197
* Pie_Exploded<br/>
196198
* Pie_3D<br/>
197-
* Pie_Exploded_3D
199+
* Pie_Exploded_3D<br/>
200+
* PieOfPie
198201
</td>
199202
</tr>
200203
<tr>
@@ -225,21 +228,32 @@ Stock
225228
</td>
226229
<td>
227230
* Stock_HighLowClose<br/>
228-
* Stock_OpenHighLowClose
231+
* Stock_OpenHighLowClose<br/>
232+
* Stock_VolumeOpenHighLowClose<br/>
233+
* Stock_VolumeHighLowClose
229234
</td>
230235
</tr>
231236
<tr>
232237
<td>
233238
Excel 2016 Charts
234239
</td>
235240
<td>
236-
* Funnel<br/>* Waterfall<br/>* Histogram<br/>* Pareto<br/></td>
241+
* Funnel<br/>
242+
* Waterfall<br/>
243+
* Histogram<br/>
244+
* Pareto<br/>
245+
* Sunburst<br/>
246+
* Box and Whisker<br/>
247+
* Treemap
248+
</td>
237249
</tr>
238250
</table>
239251

240-
N> From the above supported chart types table, Waterfall and Line_3D charts are not supported in chart to image conversion in .NET Standard 2.0 onwards.
252+
N> From the above supported chart types table, Line_3D charts are not supported in chart to image conversion in .NET Core platforms.
253+
254+
N> Only embedded charts are supported in chart to image conversion. The Chart sheets are not supported.
241255

242-
N> Only embedded charts are supported in chart to image conversion. Chart sheets are not supported.
256+
N> Pie of Pie, Sunburst, Box and Whisker, and Treemap charts are supported only in .NET Core platforms for chart to image conversion.
243257

244258
## Supported chart elements
245259
XlsIO supports the following chart elements in image conversion:

‎Document-Processing/Excel/Conversions/Chart-to-Image/overview.md‎

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,8 @@ Pie
188188
* Pie<br/>
189189
* Pie_Exploded<br/>
190190
* Pie_3D<br/>
191-
* Pie_Exploded_3D
191+
* Pie_Exploded_3D<br/>
192+
* PieOfPie
192193
</td>
193194
</tr>
194195
<tr>
@@ -229,13 +230,22 @@ Stock
229230
Excel 2016 Charts
230231
</td>
231232
<td>
232-
* Funnel<br/>* Waterfall<br/>* Histogram<br/>* Pareto<br/></td>
233+
* Funnel<br/>
234+
* Waterfall<br/>
235+
* Histogram<br/>
236+
* Pareto<br/>
237+
* Sunburst<br/>
238+
* Box and Whisker<br/>
239+
* Treemap
240+
</td>
233241
</tr>
234242
</table>
235243

236-
N> From the above supported chart types table, Waterfall and Line_3D charts are not supported in chart to image conversion in .NET Standard 2.0 onwards.
244+
N> From the above supported chart types table, Line_3D charts are not supported in chart to image conversion in .NET Core platforms.
245+
246+
N> Only embedded charts are supported in chart to image conversion. The Chart sheets are not supported.
237247

238-
N> Only embedded charts are supported in chart to image conversion. Chart sheets are not supported.
248+
N> Pie of Pie, Sunburst, Box and Whisker, and Treemap charts are supported only in .NET Core platforms for chart to image conversion.
239249

240250
## Supported chart elements
241251
XlsIO supports the following chart elements in image conversion:
@@ -248,4 +258,4 @@ XlsIO supports the following chart elements in image conversion:
248258
4. Data labels
249259
5. Grid lines
250260
6. Legend
251-
7. Trend line
261+
7. Trend line

‎Document-Processing/Excel/Conversions/Excel-to-PDF/NET/Excel-to-PDF-Converter-Settings.md‎

Lines changed: 84 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2234,4 +2234,87 @@ End Namespace
22342234
{% endhighlight %}
22352235
{% endtabs %}
22362236

2237-
A complete working example to skip warning in Excel to PDF in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Excel%20to%20PDF/Warnings/.NET/Warnings).
2237+
A complete working example to skip warning in Excel to PDF in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Excel%20to%20PDF/Warnings/.NET/Warnings).
2238+
2239+
## Show File Name
2240+
2241+
This property allows you to display the file name along with its extension in the header and/or footer when converting an Excel document to PDF. It's default value is FALSE.
2242+
2243+
The following code snippet explains how to enable the <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverterSettings.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverterSettings_ShowFileNameWithExtension">ShowFileNameWithExtension</a> property during Excel to PDF conversion.
2244+
2245+
{% tabs %}
2246+
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/Excel%20to%20PDF/Show%20file%20name%20with%20extension%20in%20PDF/.NET/ShowFileNameWithExtension/ShowFileNameWithExtension/Program.cs,180" %}
2247+
using (ExcelEngine excelEngine = new ExcelEngine())
2248+
{
2249+
IApplication application = excelEngine.Excel;
2250+
application.DefaultVersion = ExcelVersion.Xlsx;
2251+
IWorkbook workbook = application.Workbooks.Open(Path.GetFullPath(@"Data/InputTemplate.xlsx"));
2252+
2253+
//Initialize XlsIORendererSettings
2254+
XlsIORendererSettings settings = new XlsIORendererSettings();
2255+
2256+
//Enable ShowFileNameWithExtension property
2257+
settings.ShowFileNameWithExtension = true;
2258+
2259+
//Initialize XlsIORenderer
2260+
XlsIORenderer renderer = new XlsIORenderer();
2261+
2262+
//Convert the Excel document to PDF with renderer settings
2263+
PdfDocument pdfDocument = renderer.ConvertToPDF(workbook, settings);
2264+
2265+
#region Save
2266+
//Save the PDF document
2267+
pdfDocument.Save(Path.GetFullPath(@"Output/Output.pdf"));
2268+
#endregion
2269+
}
2270+
{% endhighlight %}
2271+
2272+
{% highlight c# tabtitle="C# [Windows-specific]" %}
2273+
using (ExcelEngine excelEngine = new ExcelEngine())
2274+
{
2275+
IApplication application = excelEngine.Excel;
2276+
application.DefaultVersion = ExcelVersion.Xlsx;
2277+
IWorkbook workbook = application.Workbooks.Open("InputTemplate.xlsx");
2278+
2279+
//Initialize ExcelToPdfConverterSettings
2280+
ExcelToPdfConverterSettings settings = new ExcelToPdfConverterSettings();
2281+
2282+
//Enable ShowFileNameWithExtension property
2283+
settings.ShowFileNameWithExtension = true;
2284+
2285+
//Load the Excel document into ExcelToPdfConverter
2286+
ExcelToPdfConverter converter = new ExcelToPdfConverter(workbook);
2287+
2288+
//Convert the Excel document to PDF with converter settings
2289+
PdfDocument document = converter.Convert(settings);
2290+
2291+
//Save the PDF document
2292+
document.Save("Output.pdf");
2293+
}
2294+
{% endhighlight %}
2295+
2296+
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
2297+
Using excelEngine As ExcelEngine = New ExcelEngine()
2298+
Dim application As IApplication = excelEngine.Excel
2299+
application.DefaultVersion = ExcelVersion.Xlsx
2300+
Dim workbook As IWorkbook = application.Workbooks.Open("InputTemplate.xlsx")
2301+
2302+
'Initialize ExcelToPdfConverterSettings
2303+
Dim settings As ExcelToPdfConverterSettings = New ExcelToPdfConverterSettings()
2304+
2305+
'Enable ShowFileNameWithExtension property
2306+
settings.ShowFileNameWithExtension = True
2307+
2308+
'Load the Excel document into ExcelToPdfConverter
2309+
Dim converter As ExcelToPdfConverter = New ExcelToPdfConverter(workbook)
2310+
2311+
'Convert the Excel document to PDF with converter settings
2312+
Dim document As PdfDocument = converter.Convert(settings)
2313+
2314+
'Save the PDF document
2315+
document.Save("Output.pdf")
2316+
End Using
2317+
{% endhighlight %}
2318+
{% endtabs%}
2319+
2320+
A complete working example demonstrating how to enable the <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.ExcelToPdfConverter.ExcelToPdfConverterSettings.html#Syncfusion_ExcelToPdfConverter_ExcelToPdfConverterSettings_ShowFileNameWithExtension">ShowFileNameWithExtension</a> property during Excel to PDF conversion in C# is present on <a href="https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Excel%20to%20PDF/Show%20file%20name%20with%20extension%20in%20PDF/.NET/ShowFileNameWithExtension">this GitHub page</a>.

‎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.

‎Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-support-importing-HTML-images-into-Excel.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: XlsIO support for importing HTML images into Excel | Syncfusion
3+
description: Learn whether Syncfusion XlsIO supports importing HTML images into Excel using the Syncfusion .NET Excel library (XlsIO).
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# Does XlsIO support importing HTML images into Excel?
10+
11+
No, XlsIO does not support importing HTML images into Excel. However, it does support importing HTML tables into Excel.

‎Document-Processing/Excel/Excel-Library/NET/faqs/how-does-xlsio-handle-empty-string-display-text-in-hyperlinks.md‎

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/Excel/Excel-Library/NET/faqs/what-is-the-maximum-row-height-in-Excel.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: Excel maximum row height and text overflow | Syncfusion
3+
description: Learn about Excel's maximum row height of 409 points and how Syncfusion XlsIO enforces this limitation.
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# What is the maximum row height in Excel?
10+
11+
In Microsoft Excel, the maximum row height is **409 points**. When content in a cell exceeds this height, Excel does not automatically move the text to the next row. Syncfusion XlsIO follows the same behavior to remain consistent with Excel.

‎Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md‎

Lines changed: 2 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -12,42 +12,7 @@ A cell range is a set of selected cells in a Spreadsheet, typically specified us
1212

1313
## Cell formatting
1414

15-
Cell formatting enhances the visual presentation of data by applying styles such as font changes, colors, borders, and alignment to individual cells or cell ranges. This helps organize content and emphasize important information for faster interpretation.
16-
17-
Cell formatting options include:
18-
19-
* **Bold** - Applies a heavier font weight to make the text stand out in the Spreadsheet.
20-
21-
* **Italic** - Slants the text to give it a distinct look, often used for emphasis or to highlight differences.
22-
23-
* **Underline** - Adds a line below the text, commonly used for emphasis or to indicate hyperlinks.
24-
25-
* **Strikethrough** - Draws a line through the text, often used to show completed tasks or outdated information.
26-
27-
* **Font Family** - Changes the typeface of the text (e.g., Arial, Calibri, Times New Roman, and more) to enhance readability or visual appeal.
28-
29-
* **Font Size** - Adjusts the size of the text to create visual hierarchy or improve readability in the Spreadsheet.
30-
31-
* **Font Color** - Changes the color of the text to improve visual hierarchy or to organize information using color codes.
32-
33-
* **Fill Color** - Adds color to the cell background to visually organize data or highlight important information.
34-
35-
* **Horizontal Alignment** - Controls the position of text from left to right within a cell. Options include:
36-
* **Left** - Default for text
37-
* **Center** - Useful for headings
38-
* **Right** - Default for numbers
39-
40-
* **Vertical Alignment** - Controls the position of text from top to bottom within a cell. Options include:
41-
* **Top** – Aligns content to the top of the cell
42-
* **Middle** – Centers content vertically
43-
* **Bottom** – Default alignment
44-
45-
* **Wrap Text** - Displays long content on multiple lines within a single cell, preventing it from overflowing into adjacent cells. To enable text wrapping:
46-
1. Select the target cell or range (e.g., C5).
47-
2. Go to the Home tab.
48-
3. Click Wrap Text in the ribbon to toggle text wrapping for the selected cells.
49-
50-
Cell formatting can be applied or removed from a cell or range by using the options available in the component's built-in **Ribbon** under the **Home** tab.
15+
To know more about cell formatting, refer [here](./formatting#text-and-cell-formatting).
5116

5217
## Autofill
5318

@@ -164,7 +129,7 @@ The event uses the [AutofillActionBeginEventArgs](https://help.syncfusion.com/cr
164129
{% endhighlight %}
165130
{% endtabs %}
166131

167-
**AutofillActionEnd**
132+
### AutofillActionEnd
168133

169134
The `AutofillActionEnd` event is triggered after an autofill operation has been successfully completed. This event provides detailed information about the completed autofill action, enabling further processing or logging if required.
170135

0 commit comments

Comments
 (0)