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.

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.

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
19.9.0 3,266 9/12/2019
19.8.0 1,424 8/30/2019
19.7.0 10,542 7/26/2019
19.6.0 3,162 6/25/2019
19.5.0 5,005 5/31/2019
19.4.0 5,853 4/26/2019
19.3.0 3,074 4/3/2019
19.2.0 7,483 2/28/2019
19.1.0 9,308 1/30/2019
18.12.0 5,203 12/27/2018
18.11.0 4,182 11/30/2018
18.10.0 13,174 10/30/2018
18.9.0 3,304 9/30/2018
18.8.0 3,632 8/29/2018
18.7.0 9,998 7/27/2018
18.6.0 13,372 7/1/2018
18.5.0 6,429 5/30/2018
18.4.0 3,575 5/3/2018
18.3.0 3,257 4/1/2018
18.2.1 6,070 3/7/2018
18.2.0 2,100 2/28/2018
18.1.0 3,268 1/30/2018
17.12.1 5,771 12/26/2017
17.12.0 857 12/16/2017
17.11.0 1,341 11/30/2017
17.10.0 4,602 10/31/2017
17.9.1 3,559 10/12/2017
17.9.0 1,544 10/2/2017
17.8.0 9,852 8/30/2017
17.7.0 6,239 7/31/2017
17.6.0 2,505 7/1/2017
17.5.0 2,049 5/31/2017
17.4.0 2,731 4/28/2017
17.3.0 3,172 4/2/2017
17.2.0 7,977 3/1/2017
17.1.0 3,193 1/31/2017
16.12.1 4,029 1/16/2017
16.12.0 1,567 12/27/2016
16.11.0 2,426 11/30/2016
16.10.0 2,392 11/4/2016
16.9.0 3,211 10/12/2016
16.8.0 2,959 9/27/2016
16.7.0 1,541 8/22/2016
16.6.0 18,435 7/15/2016
16.5.0 3,269 6/16/2016
16.4.0 3,720 5/16/2016
16.3.0 8,288 4/11/2016
16.2.0 4,305 3/17/2016
16.1.0 6,329 2/4/2016
15.11.0 10,430 1/11/2016
15.10.0 9,255 12/10/2015
15.9.0 5,886 11/6/2015
15.8.1 944 10/16/2015
15.8.0 1,242 10/5/2015
15.7.0 3,229 9/3/2015
15.6.0 8,247 7/22/2015
15.5.0 2,771 6/16/2015
15.4.0 1,832 5/14/2015
15.3.1 1,031 4/23/2015
15.3.0 693 4/14/2015
15.2.0 11,031 3/6/2015
15.1.0 1,318 2/3/2015
14.10.0 4,674 11/28/2014
14.9.0 1,512 11/11/2014
14.8.1 1,410 10/24/2014
14.8.0 654 10/16/2014
14.7.0 1,868 9/7/2014
14.6.0 1,159 8/6/2014
14.5.0 3,159 7/16/2014
14.4.0 1,777 6/2/2014
14.3.0 2,008 5/6/2014
14.2.0 1,176 3/24/2014
14.1.2 1,590 2/17/2014
14.1.1 654 2/10/2014
14.1.0.2 571 2/6/2014
13.12.0 1,512 12/30/2013
8.4.2 5,720 6/5/2014
8.4.1 1,176 5/6/2014
8.4.0 792 3/3/2014
8.3.0.1 688 2/3/2014
8.2.0 635 12/27/2013
8.1.0 5,112 12/16/2013
8.0.0 1,662 10/25/2013
7.9.0 1,028 10/8/2013
7.8.0 748 9/3/2013
7.7.0 3,660 8/4/2013
7.6.0 826 7/5/2013
7.5.0 1,056 5/27/2013
7.4.0 7,334 4/24/2013
7.3.0 843 4/10/2013
7.2.0 1,071 3/8/2013
7.1.0 3,146 1/28/2013
7.0.0 869 12/31/2012
6.9.0 810 12/10/2012
6.8.0 878 10/30/2012
6.7.0 1,229 10/4/2012
6.6.0 746 9/13/2012
6.5.0 858 7/27/2012
6.4.0 783 6/27/2012
6.3.0 708 5/29/2012
6.2.0 751 5/7/2012
6.1.0 768 3/28/2012
6.0.0 746 3/2/2012
5.9.0.1 768 2/16/2012
5.9.0 1,190 2/16/2012
Show less