Aspose.Slides.NET 17.11.0

Aspose.Slides is a PowerPoint management library for working with Microsoft PowerPoint files without using Microsoft PowerPoint. It allows developers to work with PPT, PPS, POT, PPTX, PPSX, POTX and ODP files on ASP.NET web applications, web services and Windows applications.

There is a newer version of this package available.
See the version list below for details.
Install-Package Aspose.Slides.NET -Version 17.11.0
dotnet add package Aspose.Slides.NET --version 17.11.0
<PackageReference Include="Aspose.Slides.NET" Version="17.11.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Aspose.Slides.NET --version 17.11.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Aspose.Slides.NET, 17.11.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Aspose.Slides.NET as a Cake Addin
#addin nuget:?package=Aspose.Slides.NET&version=17.11.0

// Install Aspose.Slides.NET as a Cake Tool
#tool nuget:?package=Aspose.Slides.NET&version=17.11.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

SLIDESNET-39490 - List of supported font file extensions
SLIDESNET-39228 - Rendering comments when saving Presentation documents into image
SLIDESNET-39197 - Support for End Paragraph Run Properties
SLIDESNET-38055 - Set slide hidden doesn't work when saving to Odp format
SLIDESNET-39232 - Improve rendering comments into PDF / HTML
SLIDESNET-39379 - Extend support for Hidden Slides for Open Document Presentation format
SLIDESNET-38206 - Pptx to pdf conversion giving OutOfMemoryError
SLIDESNET-38305 - Open and save PPTX changes part types
SLIDESNET-39485 - Pdf not properly generated from pptx
SLIDESNET-39486 - Thumbnails not properly generated from pptx
SLIDESNET-39147 - OleObjectFrame getting resized on double clicking
SLIDESNET-36240 - Slide animation duration is not extracted from animation
SLIDESNET-36946 - Text missing on generated thumbnail
SLIDESNET-36947 - The text is backwards and misaligned
SLIDESNET-39259 - Wrong character spacing in generated SVG and thumbnail
SLIDESNET-39271 - PptxReadException (A generic error occurred in GDI+) on loading presentation
SLIDESNET-39274 - PptxReadException on loading presentation
SLIDESNET-39320 - Text is improperly indented in generated thumbnails
SLIDESNET-39349 - Direction of the characters and "Yen-sign" changed when converting to image
SLIDESNET-39364 - PptxRead exception on loading presentaiton
SLIDESNET-39403 - Exception on saving Ppt
SLIDESNET-39420 - NullReference exception is thrown on removing slide
SLIDESNET-39424 - Problem saving a presentation from PPT to PPTM
SLIDESNET-39451 - NullPointerException on exporting to HTML
SLIDESNET-39455 - Clone PPTX does not retain layout/master
SLIDESNET-39465 - Video play mode for video frame resets on cloning slide
SLIDESNET-39469 - Presentation repair message appears for cloned presentation
SLIDESNET-39495 - Can not open pptx after saving

=Public API Changes


=Possibility to control look and layouting of notes and comments in exported document

A new NotesCommentsLayoutingOptions property has been added to PdfOptions, TiffOptions, SwfOptions and HtmlOptions classes. It allows specifying notes and comments look and layouting during document export.

NotesCommentsLayoutingOptions property is of type INotesCommentsLayoutingOptions that has the following properties:

NotesPositions NotesPosition - Gets or sets the position of the notes on the page.
CommentsPositions CommentsPosition - Gets or sets the position of the comments on the page.
Color CommentsAreaColor - Gets or sets the color of comments area.
int CommentsAreaWidth - Gets or sets the width of the comments area in pixels.

NotesPosition property is of type NotesPositions that is enumeration and has three members:

None - Specifies that notes should not be displayed at all.
BottomFull - Specifies that notes should be fully displayed using additional pages as it is needed.
BottomTruncated - Specifies that notes should be displayed in only one page.

CommentsPosition property is of type CommentsPosition that is enumeration and has three members:

None - Specifies that comments should not be displayed at all.
Bottom - Specifies that comments should be displayed using additional pages, following the page of the slide.
Right - Specifies that comments should be displayed to the right of the page.

NotesPosition and CommentsPosition properties have values None by default.

For example, the following code allows exporting presentation to PDF document with comments placed right and truncated notes (shown only on first page).

using (Presentation presentation = new Presentation("Presentation.pptx"))
{
   PdfOptions opt = new PdfOptions();
   opt.NotesCommentsLayouting.NotesPosition = NotesPositions.BottomTruncated;
   opt.NotesCommentsLayouting.CommentsPosition = CommentsPositions.Right;
   presentation.Save("PresOut.pdf", SaveFormat.Pdf, opt);
}

The following code allows changing default color of comments area and the width of comments area:

using (Presentation presentation = new Presentation("comments.pptx"))
{
   PdfOptions opt = new PdfOptions();
   opt.NotesCommentsLayouting.NotesPosition = NotesPositions.BottomTruncated;
   opt.NotesCommentsLayouting.CommentsPosition = CommentsPositions.Right;
   opt.NotesCommentsLayouting.CommentsAreaWidth = 300;
   opt.NotesCommentsLayouting.CommentsAreaColor = Color.Azure;
   presentation.Save("PresOut.pdf", SaveFormat.Pdf, opt);
}

Elements SwfNotes, TiffNotes, HtmlNotes and PdfNotes of SaveFormat enumeration and property IncludeComments of SwfOptions, TiffOptions, HtmlOptions and PdfOptions are obsolete now.

Pay attention, NotesCommentsLayouting.NotesPosition has no effect when you use obsolete elements of SaveFormat. And if you use obsolete property IncludeComments of SwfOptions, TiffOptions, HtmlOptions or PdfOptions classes then NotesCommentsLayouting.CommentsPosition, NotesCommentsLayouting.CommentsAreaWidth and NotesCommentsLayouting.CommentsAreaColor have no effect too.


=Possibility to export a presentation to a set of Bitmap objects

All added methods accept an object of type INotesCommentsLayoutingOptions, which allows to specify look and layouting of notes and comments in received Bitmap objects.

The following methods have been added to the Presentation class and the IPresentation interface:

Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting);
Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting, int[] slides);
Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting, float scaleX, float scaleY);
Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting, int[] slides, float scaleX, float scaleY);
Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting, Size imageSize);
Bitmap[] GetThumbnails(INotesCommentsLayoutingOptions notesCommentsLayouting, int[] slides, Size imageSize);

The following examples allows getting a set of Bitmap objects for all existing slides with the arrangement of comments on the right, including full notes.

using (Presentation presentation = new Presentation("comments.pptx"))
{
   NotesCommentsLayoutingOptions options = new NotesCommentsLayoutingOptions();
   options.CommentsPosition = CommentsPositions.Right;
   options.NotesPosition = NotesPositions.BottomFull;

   Bitmap[] bmps = presentation.GetThumbnails(options);
}

To obtain an image of a specific slide, for example, slides 2 and 7, without displaying comments and with notes truncated to the size of the page, you can use the following code.

using (Presentation presentation = new Presentation("comments.pptx"))
{
   NotesCommentsLayoutingOptions options = new NotesCommentsLayoutingOptions();
   options.NotesPosition = NotesPositions.BottomTruncated;

   Bitmap[] bmps = presentation.GetThumbnails(options, new int[] { 2, 7 });
}

The following methods have been added to the Slides class and ISlides interface:

Bitmap GetThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting);
Bitmap GetThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, float scaleX, float scaleY);
Bitmap GetThumbnail(INotesCommentsLayoutingOptions notesCommentsLayouting, Size imageSize);
void RenderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Graphics graphics, int width, int height);
void RenderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Graphics graphics, float scale);
void RenderToGraphics(INotesCommentsLayoutingOptions notesCommentsLayouting, Graphics graphics);

To get an image of the third presentation slide with the comments displayed on the right, you can use the following code:

using (Presentation presentation = new Presentation("comments.pptx"))
{
   NotesCommentsLayoutingOptions options = new NotesCommentsLayoutingOptions();
   options.CommentsPosition = CommentsPositions.Right;

   Bitmap bmp = presentation.Slides[2].GetThumbnail(options);
}

Note that the GetThumbnail and RenderToGraphics methods of the Slide class can throw an exception of type InvalidOperationException if the NotesCommentsLayouting.NotesPosition property takes the value NotesPositions.BottomFull. This is due to the fact that when you send NotesCommentsLayouting.NotesPosition, which has the value NotesPositions.BottomFull, the notes may be too long and go beyond the page.

Methods RenderToGraphics (bool withNotes, Graphics graphics, int width, int height), RenderToGraphics (bool withNotes, Graphics graphics, float scale) and RenderToGraphics (bool withNotes, Graphics graphics) of the Slides class and methods GetThumbnail (float scaleX, float scaleY), GetThumbnail (Size imageSize) of the NotesSlide class are marked as obsolete now.


=Property Paragraph.EndParagraphPortionFormat has been added

A new property EndParagraphPortionFormat has been added. This property specifies the portion properties that are to be used if another portion is inserted after the last one.

IParagraph paragraph = autoShape.TextFrame.Paragraphs0;
IPortionFormat endParaPortionFormat = paragraph.EndParagraphPortionFormat;

Dependencies

This package has no dependencies.

NuGet packages (10)

Showing the top 5 NuGet packages that depend on Aspose.Slides.NET:

Package Downloads
Aspose.Total
Aspose.Total for .NET is the most complete package of all .NET file format APIs offered by Aspose. It empowers developers to create, edit, render, print and convert between a wide range of popular document formats within any .NET, C#, ASP.NET and VB.NET applications.
Zny.ServiceClient.DemoTest
微服务DEMO测试
Verify.Aspose
Extends Verify (https://github.com/VerifyTests/Verify) to allow verification via Aspose.
Aspose.ApprovalTests
Extends ApprovalTests to allow approval via Aspose.
SenseNet.Preview.Aspose.PreviewImageGenerators
Aspose Preview image generator classes for the sensenet platform.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
21.5.0 2,405 5/18/2021
21.4.0 25,372 4/18/2021
21.3.0 9,012 3/19/2021
21.2.0 11,530 2/16/2021
21.1.0 14,940 1/21/2021
20.12.0 16,878 12/10/2020
20.11.1 2,072 12/10/2020
20.11.0 15,661 12/23/2020
20.10.0 12,426 10/19/2020
20.9.0 7,091 9/25/2020
20.8.0 25,208 8/17/2020
20.7.0 13,037 7/17/2020
20.6.0 22,810 6/12/2020
20.5.0 15,529 5/7/2020
20.4.0 12,243 4/22/2020
20.3.0 12,675 3/23/2020
20.2.0 27,298 2/17/2020
20.1.0 29,982 1/17/2020
19.12.0 22,241 12/31/2019
19.11.0 28,762 11/27/2019
19.10.0 31,373 10/29/2019
19.9.0 26,816 9/12/2019
19.8.0 8,050 8/30/2019
19.7.0 26,191 7/26/2019
19.6.0 9,548 6/25/2019
19.5.0 8,887 5/31/2019
19.4.0 21,962 4/26/2019
19.3.0 7,499 4/3/2019
19.2.0 12,949 2/28/2019
19.1.0 68,633 1/30/2019
18.12.0 13,462 12/27/2018
18.11.0 10,255 11/30/2018
18.10.0 36,182 10/30/2018
18.9.0 5,955 9/30/2018
18.8.0 8,497 8/29/2018
18.7.0 16,167 7/27/2018
18.6.0 25,837 7/1/2018
18.5.0 10,500 5/30/2018
18.4.0 10,880 5/3/2018
18.3.0 6,456 4/1/2018
18.2.1 41,101 3/7/2018
18.2.0 3,157 2/28/2018
18.1.0 12,204 1/30/2018
17.12.1 8,978 12/26/2017
17.12.0 1,241 12/16/2017
17.11.0 3,274 11/30/2017
17.10.0 9,075 10/31/2017
17.9.1 4,208 10/12/2017
17.9.0 2,529 10/2/2017
17.8.0 20,025 8/30/2017
17.7.0 7,524 7/31/2017
17.6.0 4,470 7/1/2017
17.5.0 3,050 5/31/2017
17.4.0 4,110 4/28/2017
17.3.0 5,177 4/2/2017
17.2.0 15,668 3/1/2017
17.1.0 3,967 1/31/2017
16.12.1 8,608 1/16/2017
16.12.0 2,269 12/27/2016
16.11.0 3,454 11/30/2016
16.10.0 8,217 11/4/2016
16.9.0 4,350 10/12/2016
16.8.0 5,382 9/27/2016
16.7.0 1,987 8/22/2016
16.6.0 30,813 7/15/2016
16.5.0 5,775 6/16/2016
16.4.0 4,664 5/16/2016
16.3.0 15,457 4/11/2016
16.2.0 5,176 3/17/2016
16.1.0 9,963 2/4/2016
15.11.0 14,252 1/11/2016
15.10.0 9,953 12/10/2015
15.9.0 6,328 11/6/2015
15.8.1 1,318 10/16/2015
15.8.0 1,643 10/5/2015
15.7.0 5,523 9/3/2015
15.6.0 15,899 7/22/2015
15.5.0 3,540 6/16/2015
15.4.0 2,900 5/14/2015
15.3.1 1,426 4/23/2015
15.3.0 1,078 4/14/2015
15.2.0 22,810 3/6/2015
15.1.0 4,297 2/3/2015
14.10.0 5,505 11/28/2014
14.9.0 2,092 11/11/2014
14.8.1 1,801 10/24/2014
14.8.0 1,057 10/16/2014
14.7.0 2,340 9/7/2014
14.6.0 1,818 8/6/2014
14.5.0 3,792 7/16/2014
14.4.0 2,203 6/2/2014
14.3.0 2,794 5/6/2014
14.2.0 1,600 3/24/2014
14.1.2 2,347 2/17/2014
14.1.1 1,198 2/10/2014
14.1.0.2 1,115 2/6/2014
13.12.0 2,083 12/30/2013
8.4.2 17,174 6/5/2014
8.4.1 1,636 5/6/2014
8.4.0 1,364 3/3/2014
8.3.0.1 1,080 2/3/2014
8.2.0 1,065 12/27/2013
8.1.0 6,546 12/16/2013
8.0.0 2,104 10/25/2013
7.9.0 1,448 10/8/2013
7.8.0 1,120 9/3/2013
7.7.0 7,115 8/4/2013
7.6.0 1,473 7/5/2013
7.5.0 3,079 5/27/2013
7.4.0 7,919 4/24/2013
7.3.0 1,222 4/10/2013
7.2.0 1,609 3/8/2013
7.1.0 3,529 1/28/2013
7.0.0 1,486 12/31/2012
6.9.0 1,207 12/10/2012
6.8.0 1,264 10/30/2012
6.7.0 1,686 10/4/2012
6.6.0 1,134 9/13/2012
6.5.0 1,274 7/27/2012
6.4.0 1,164 6/27/2012
6.3.0 1,103 5/29/2012
6.2.0 1,197 5/7/2012
6.1.0 1,161 3/28/2012
6.0.0 1,132 3/2/2012
5.9.0.1 2,344 2/16/2012
5.9.0 2,009 2/16/2012
Show less