Skip to content

Commit 499ba3a

Browse files
Merge pull request #3975 from syncfusion-content/Revamp_PPT
Task 1044136: Revamp User Guide Documentation in PowerPoint presentation library
2 parents b72c8e0 + bc70e85 commit 499ba3a

55 files changed

Lines changed: 3087 additions & 2743 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Document-Processing-toc.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8014,7 +8014,7 @@
80148014
<a href="/document-processing/powerpoint/powerpoint-library/net/faqs/migrate-from-net-framework-to-net-core">Migrate from .NET Framework to .NET Core</a>
80158015
</li>
80168016
<li>
8017-
<a href="/document-processing/powerpoint/powerpoint-library/net/faqs/multithreading-powerpoint-reading-faqs">Multithreading in PowerPoint Library</a>
8017+
<a href="/document-processing/powerpoint/powerpoint-library/net/faqs/multithreading-in-powerpoint-library-faqs">Multithreading in PowerPoint Library</a>
80188018
</li>
80198019
</ul>
80208020
</li>

Document-Processing/PowerPoint/PowerPoint-Library/NET/Assemblies-Required.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ Assembly
1919
</th>
2020
</tr>
2121
</thead>
22-
<tbody>
2322
<tr>
2423
<td>
2524
@@ -57,7 +56,7 @@ T> * Upgrade quickly with no manual effort.
5756
T> Note: To avoid trial watermark when using NuGet packages, it is recommended to register license key in application. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) for information on registering Syncfusion<sup>&reg;</sup> license key in your application to use our components.
5857
T> Refer [here](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/nuget-packages-required) for more information on the required NuGet packages.
5958

60-
#### Retired Platforms
59+
### Retired Platforms
6160

6261
The following assemblies need to be referenced in your application based on the platform.
6362

@@ -94,7 +93,6 @@ Assembly
9493
</th>
9594
</tr>
9695
</thead>
97-
<tbody>
9896
<tr>
9997
<td>
10098
@@ -136,7 +134,7 @@ Syncfusion.PresentationRenderer.NET<br/>Syncfusion.Pdf.Imaging.NET<br/>Syncfusio
136134
</tr>
137135
</table>
138136

139-
#### Retired Platforms
137+
### Retired Platforms
140138

141139
The following assemblies need to be referenced in your application based on the platform.
142140

@@ -184,7 +182,6 @@ Assembly
184182
</th>
185183
</tr>
186184
</thead>
187-
<tbody>
188185
<tr>
189186
<td>
190187
{{'[WPF](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-image/net/convert-powerpoint-to-image-in-wpf)' | markdownify}}, {{'[Windows Forms](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-image/net/convert-powerpoint-to-image-in-windows-forms)' | markdownify}} and {{'[ASP.NET MVC](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-image/net/convert-powerpoint-to-image-in-asp-net-mvc)' | markdownify}}<br/></td><td>
@@ -232,7 +229,7 @@ Syncfusion.SfChart.UWP<br/>
232229
</tr>
233230
</table>
234231

235-
#### Retired Platforms
232+
### Retired Platforms
236233

237234
The following assemblies need to be referenced in your application based on the platform.
238235

@@ -279,7 +276,6 @@ Assembly
279276
</th>
280277
</tr>
281278
</thead>
282-
<tbody>
283279
<tr>
284280
<td>
285281
WPF, Windows Forms and ASP.NET MVC<br/>
@@ -298,10 +294,9 @@ Syncfusion.OfficeChartToImageConverter.Portable<br/>
298294
Syncfusion.SfChart.Portable<br/>
299295
</td>
300296
</tr>
301-
</tbody>
302297
</table>
303298

304-
#### Retired Platforms
299+
### Retired Platforms
305300

306301
The following assemblies need to be referenced in your application based on the platform.
307302

-75.4 KB
Loading

Document-Processing/PowerPoint/PowerPoint-Library/NET/Charts/Chart-Data-Labels.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -274,3 +274,9 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
274274
## See Also
275275

276276
* [How to change text of data labels for Chart in Presentation](https://support.syncfusion.com/kb/article/13828/how-to-change-the-text-in-data-labels-inside-a-chart-in-presentation-using-c-in-aspnet-core)
277+
* [Chart Area in PowerPoint](Chart-Area)
278+
* [Chart Axis in PowerPoint](Chart-Axis)
279+
* [Chart Title in PowerPoint](Chart-Title)
280+
* [Chart Legend in PowerPoint](Chart-Legend)
281+
* [Chart Plot Area in PowerPoint](Chart-Plot-Area)
282+
* [Chart Series in PowerPoint](Chart-Series)

Document-Processing/PowerPoint/PowerPoint-Library/NET/Document-Object-Model.md

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,6 @@ documentation: UG
99

1010
To create or modify a PowerPoint Presentation, you need to understand how elements are organized in the Essential<sup>&reg;</sup> Presentation Document Object Model (DOM). The following figure illustrates the hierarchy of the major DOM elements.
1111

12-
## DOM hierarchy
13-
| Element | Type | Description |
14-
|---------|------|-------------|
15-
| `IPresentation` | Root | Represents the entire PowerPoint presentation file. |
16-
| `ISlide` | Collection member | Represents a single slide within a presentation. |
17-
| `NotesSlide` | Associated element | Stores the speaker notes for a slide. |
18-
| `IShape` | Collection member | Represents a shape, picture, table, chart, or placeholder inside a slide. |
19-
| `ITextBody` | Shape child | Holds the formatted text content of a shape. |
20-
| `IParagraph` | TextBody child | Represents a paragraph within a text body. |
21-
| `ITextPart` | Paragraph child | Represents a run of text within a paragraph. |
22-
| `IPlaceholder` | Shape variant | Represents a layout placeholder on a slide. |
2312

2413
![Document Object Model of the Essential Presentation library](DocumentObjectModel_images/DocumentObjectModel_img1.png)
2514

Document-Processing/PowerPoint/PowerPoint-Library/NET/FAQ.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -9,27 +9,27 @@ documentation: UG
99

1010
The frequently asked questions in Essential<sup>&reg;</sup> PowerPoint Presentations are listed below.
1111

12-
## Why I get an exception when trying to load a PPT file?
12+
## Why do I get an exception when trying to load a PPT file?
1313

14-
The current version of Presentation library supports only .PPTX format - Microsoft Office 2007 and later version.
14+
The current version of the Presentation library supports only the .pptx format (Microsoft Office 2007 and later versions).
1515

1616
## Is it possible to print the Presentation slides?
1717

18-
Yes, you can print the PowerPoint presentations by using its ability to convert the slides as images and by using the [PrintDocument](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.printing.printdocument?redirectedfrom=MSDN&view=dotnet-plat-ext-7.0# "") class. For more details, refer to [Printing](http://www.google.com/# "")
18+
Yes, you can print PowerPoint presentations by converting the slides to images and using the [PrintDocument](https://learn.microsoft.com/en-us/dotnet/api/system.drawing.printing.printdocument?view=net-11.0-pp) class. For more details, refer to the [Printing](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-image/net/presentation-to-image) documentation.
1919

20-
## Does adding audio and video to a Presentation is supported?
20+
## Is adding audio and video to a Presentation supported?
2121

22-
At present, there is no support to add audio and video to Presentation by using Essential<sup>&reg;</sup> Presentation library.
22+
No, the current version of the Essential<sup>&reg;</sup> Presentation library does not support adding audio and video to a Presentation. For feature requests, contact Syncfusion support.
2323

24-
## What measure does Essential<sup>&reg;</sup> Presentation use to add slide elements such as textbox, shape, picture and charts?
24+
## What unit of measurement does Essential<sup>&reg;</sup> Presentation use to add slide elements such as text box, shape, picture, and chart?
2525

26-
We use Points to add any slide elements in a Presentation.
26+
Essential<sup>&reg;</sup> Presentation uses **points** as the unit of measurement when adding slide elements such as text boxes, shapes, pictures, and charts.
2727

28-
## Does Essential<sup>&reg;</sup> Presentation supports cloning a slide in the Presentation?
28+
## Does Essential<sup>&reg;</sup> Presentation support cloning a slide in the Presentation?
2929

3030
Yes, Essential<sup>&reg;</sup> Presentation library supports cloning as follows:
3131

32-
* Slide in the Presentation can be cloned from one Presentation to another or within a same Presentation.
32+
* A slide in the Presentation can be cloned from one Presentation to another, or within the same Presentation.
3333
* An entire Presentation can also be cloned as an independent copy of the original.
3434

3535
## Could not find Syncfusion.OfficeChartToImageConverter assembly in .NET 3.5 Framework, does it mean there is no support for chart conversion in this framework?
@@ -38,27 +38,27 @@ Yes, OfficeChartToImageConverter assembly is not supported in .NET 3.5 Framework
3838

3939
## Can chart data be refreshed?
4040

41-
Yes, Essential<sup>&reg;</sup> Presentation supports refreshing the chart data. For more details, refer to [Working with charts](/document-processing/powerpoint/powerpoint-library/net/working-with-charts)
41+
Yes, Essential<sup>&reg;</sup> Presentation supports refreshing the chart data. For more details, refer to [Working with charts](/document-processing/powerpoint/powerpoint-library/net/working-with-charts).
4242

4343
## Is it possible to convert 3D charts to PDF or image?
4444

45-
Current version of the Essential<sup>&reg;</sup> Presentation library does not provide support for converting 3D charts to PDF or image format.
45+
No, the current version of the Essential<sup>&reg;</sup> Presentation library does not support converting 3D charts to PDF or image format.
4646

47-
## How to improve the image quality while converting the Presentation slides to image?
47+
## How do I improve the image quality when converting Presentation slides to images?
4848

49-
You can improve the quality of converted images by specifying the image resolution. Refer [Converting PowerPoint presentation to Images](/document-processing/powerpoint/powerpoint-library/net/getting-started#converting-powerpoint-presentation-to-images)
49+
You can improve the quality of converted images by specifying the image resolution (DPI). Refer to [Converting PowerPoint presentation to Images](/document-processing/powerpoint/powerpoint-library/net/getting-started#converting-powerpoint-presentation-to-images).
5050

51-
## What are the NuGet packages to be installed to perform PowerPoint Presentation to PDF conversion in Linux OS?
51+
## What are the NuGet packages required to perform PowerPoint Presentation to PDF conversion in Linux OS?
5252

53-
In Linux OS, perform PowerPoint presentation to PDF conversion using the .NET Core (Targeting .netcoreapp) application. Refer to [PowerPoint presentation to PDF conversion NuGet packages](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/nuget-packages-required#converting-powerpoint-presentation-into-pdf) to know about the packages required to deploy the .NET Core (Targeting .netcoreapp) applications with PowerPoint presentation to PDF conversion capabilities.
53+
On Linux OS, perform PowerPoint presentation to PDF conversion using a .NET Core (Targeting .netcoreapp) application. Refer to [PowerPoint presentation to PDF conversion NuGet packages](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/nuget-packages-required#converting-powerpoint-presentation-into-pdf) for the base Syncfusion PowerPoint NuGet packages required to deploy the .NET Core application with PDF conversion capabilities.
5454

5555
In addition to the previous NuGet packages, your application needs to install the following NuGet packages.
5656

5757
<table>
5858
<thead>
5959
<tr>
6060
<th width="20%">
61-
Version
61+
Syncfusion Version
6262
</th>
6363
<th width="40%">
6464
NuGet packages to install
@@ -150,11 +150,11 @@ Install the SkiaSharp.Linux NuGet package for the .NET Core application in Linux
150150

151151
* [Does the PowerPoint library support multithreading and thread-safety?](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/faqs/multithreading-powerpoint-reading-faqs#does-the-powerpoint-library-support-multithreading-and-thread-safety)
152152

153-
## Does PPTX file support sensitivity labels?
154-
No, Presentation library processes the file-level information of PowerPoint. Sensitivity labels are organization-level settings and are not stored within the PPTX file itself. As a result, the Presentation library does not support set or get or preserve sensitivity labels.
153+
## Does a PPTX file support sensitivity labels?
154+
No. The Presentation library processes the file-level information of a PowerPoint file. Sensitivity labels are organization-level settings applied through Microsoft Purview and are not stored within the PPTX file itself. As a result, the Presentation library does not support setting, getting, or preserving sensitivity labels. For background, see [Microsoft sensitivity labels overview](https://learn.microsoft.com/en-us/purview/sensitivity-labels).
155155

156-
## Can Presentation library Open a PPTX file with Sensitivity Labels Applied?
157-
If a PPTX file is encrypted due to its sensitivity label configuration, Presentation library cannot open it because the content is stored in an encrypted format and requires an authorized Microsoft account for access.
156+
## Can the Presentation library open a PPTX file with sensitivity labels applied?
157+
If a PPTX file is encrypted due to its sensitivity label configuration, the Presentation library cannot open it because the content is stored in an encrypted format and requires an authorized Microsoft account for access. To detect this case before calling `Open`, wrap the call in a try/catch and handle the file-format/encryption exception, or remove the sensitivity label in Microsoft PowerPoint before opening.
158158

159159
## Does the PowerPoint library support asynchronous methods to open or save a presentation?
160-
No, the Syncfusion PowerPoint library does not provide asynchronous APIs for opening or saving presentations. However, the library is highly optimized for performance and is threadsafe, allowing you to perform presentation processing operations.
160+
No, the Syncfusion PowerPoint library does not provide asynchronous APIs for opening or saving presentations. However, the library is highly optimized for performance and is thread-safe, allowing you to perform presentation-processing operations off the UI thread.
Lines changed: 32 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,45 @@
11
---
22
title: Feature Matrix in .NET PowerPoint Library | Syncfusion
3-
description: Explore the supported features of Syncfusion® Essential PowerPoint for working with PowerPoint 2007–2016 presentations programmatically.
3+
description: Explore the supported features of Syncfusion® Essential PowerPoint for working with PowerPoint 2007–2016 and later OOXML presentations programmatically.
44
platform: document-processing
55
control: Presentation
66
documentation: UG
77
---
88

99
# Feature Matrix in .NET PowerPoint Library
1010

11-
Syncfusion® Essential PowerPoint is a [.NET PowerPoint library](https://www.syncfusion.com/document-sdk/net-powerpoint-library) that provides comprehensive support for creating, editing, and managing PowerPoint presentations programmatically. It allows seamless handling of slides, shapes, charts, SmartArt, tables, and more.
11+
Syncfusion® Essential PowerPoint is the [.NET PowerPoint library](https://www.syncfusion.com/document-sdk/net-powerpoint-library) that provides comprehensive support for creating, editing, and managing PowerPoint presentations programmatically. It allows seamless handling of features such as slides, shapes, charts, SmartArt, and tables.
1212

13-
The following table outlines the supported features for PowerPoint 2007–2016 presentations.
13+
For prerequisites and setup, refer to the [Assemblies Required](Assemblies-Required) and [NuGet Packages Required](NuGet-Packages-Required) pages. For a quick start, see the [Getting Started](Getting-Started) guide.
14+
15+
The following table outlines the supported features for PowerPoint 2007–2016 and later OOXML presentations.
1416

1517
## Document Content Features
1618

17-
<table>
18-
<tr>
19-
<td>
20-
{{'**Document Content Features**'| markdownify }}
21-
</td>
22-
<td>
23-
{{'**PowerPoint 2007–2016**'| markdownify }}
24-
</td>
25-
</tr>
26-
<tr><td>Create PowerPoint presentations from scratch or edit an existing presentation.</td><td> Yes </td></tr>
27-
<tr><td>Open existing PowerPoint presentations from the file system or stream.</td><td> Yes </td></tr>
28-
<tr><td>Save PowerPoint presentation to a local file, stream, or stream it to a client browser.</td><td> Yes </td></tr>
29-
<tr><td>Create, access, and modify paragraphs and text.</td><td> Yes </td></tr>
30-
<tr><td>Create, access, and modify bullets and numbering.</td><td> Yes </td></tr>
31-
<tr><td>Create, access, and modify images.</td><td> Yes </td></tr>
32-
<tr><td>Create, access, and modify tables, rows, and cells.</td><td> Yes </td></tr>
33-
<tr><td>Create, access, and modify shapes.</td><td> Yes </td></tr>
34-
<tr><td>Create, access, and modify charts.</td><td> Yes </td></tr>
35-
<tr><td>Access and modify placeholders.</td><td> Yes </td></tr>
36-
<tr><td>Create, access, and modify SmartArt diagrams.</td><td> Yes </td></tr>
37-
<tr><td>Create, access, and modify sections.</td><td> Yes </td></tr>
38-
<tr><td>Create, access, and modify animation and slide transition.</td><td> Yes </td></tr>
39-
<tr><td>Create, access, and modify hyperlinks.</td><td> Yes </td></tr>
40-
<tr><td>Create, access, and modify slide notes.</td><td> Yes </td></tr>
41-
<tr><td>Copy and move slide elements between PowerPoint presentations.</td><td> Yes </td></tr>
42-
<tr><td>Merge multiple PowerPoint presentations.</td><td> Yes </td></tr>
43-
<tr><td>Encrypt and open password-protected PowerPoint presentations.</td><td> Yes </td></tr>
44-
<tr><td>Iterate over slide content.</td><td> Yes </td></tr>
45-
<tr><td>Insert OLE objects in PowerPoint presentations.</td><td> Yes </td></tr>
46-
<tr><td>Access and modify built-in document properties.</td><td> Yes </td></tr>
47-
<tr><td>Create, access, and modify custom document properties.</td><td> Yes </td></tr>
48-
</table>
19+
| Document Content Features | PowerPoint 2007–2016 and later |
20+
| --- | :---: |
21+
| Create PowerPoint presentations from scratch or edit an existing presentation. | Yes |
22+
| Open existing PowerPoint presentations from the file system or stream. | Yes |
23+
| Save a PowerPoint presentation to a local file, stream, or stream it to a client browser. | Yes |
24+
| Create, access, and modify paragraphs and text. | Yes |
25+
| Create, access, and modify bullets and numbering. | Yes |
26+
| Create, access, and modify images. | Yes |
27+
| Create, access, and modify tables, rows, and cells. | Yes |
28+
| Create, access, and modify shapes. | Yes |
29+
| Create, access, and modify charts. | Yes |
30+
| Create, access, and modify placeholders. | Yes |
31+
| Create, access, and modify SmartArt diagrams. | Yes |
32+
| Create, access, and modify sections. | Yes |
33+
| Create, access, and modify animations. | Yes |
34+
| Create, access, and modify slide transitions. | Yes |
35+
| Create, access, and modify hyperlinks. | Yes |
36+
| Create, access, and modify slide notes. | Yes |
37+
| Copy and move slide elements between PowerPoint presentations. | Yes |
38+
| Merge multiple PowerPoint presentations. | Yes |
39+
| Encrypt and open password-protected PowerPoint presentations. | Yes |
40+
| Traverse slide content programmatically. | Yes |
41+
| Insert OLE objects in PowerPoint presentations. | Yes |
42+
| Create, access, and modify built-in document properties. | Yes |
43+
| Create, access, and modify custom document properties. | Yes |
44+
45+

0 commit comments

Comments
 (0)