Aspose.Slides for .NET 20.5 Release Notes

Key	Summary	Category
SLIDESNET-41835	Performance issues related to Aspose.Slides	Investigation
SLIDESNET-41786	Add the ability to validate password to modify	Feature
SLIDESNET-40011	Align Multiple shapes in one line	Feature
SLIDESNET-38923	Feature to identify read-protected and write-protected presentations	Feature
SLIDESNET-37280	Support for Mathematical Equations (OMML)	Feature
SLIDESNET-41621	Importing Excel EMF image has broken aspect ratio	Enhancement
SLIDESNET-38545	Get real table row height, after the long text is added to a cell	Enhancement
SLIDESNET-41893	PowerPoint Waterfall Chart loses chart characteristics	Bug
SLIDESNET-41881	Graph issues while converting PPTX to PDF	Bug
SLIDESNET-41871	Specifying First Slide Number break Hyperlinks in PDF	Bug
SLIDESNET-41870	Gapwidth property not working as expected	Bug
SLIDESNET-41867	Error when trying to open PPT Presentation	Bug
SLIDESNET-41862	The margins are changed when converting the ODP to PPTX	Bug
SLIDESNET-41861	Chart improperly rendered in exported PDF	Bug
SLIDESNET-41858	Portion.getRect() returns wrong value if TextFrame contains columns	Bug
SLIDESNET-41837	Japanese characters are rendered wrong	Bug
SLIDESNET-41830	SVG is not getting imported in slide properly	Bug
SLIDESNET-41812	Roboto font is not rendered correctly in saved presentation and PDF	Bug
SLIDESNET-41795	Font Format ‘Kerning’ Applied after merging	Bug
SLIDESNET-41682	Arrows are improperly rendered in generated thumbnail	Bug
SLIDESNET-41502	Ppt changed after saving	Bug
SLIDESNET-41323	Wrong paragraphs after cloning	Bug
SLIDESNET-40971	Text losses boldness after load and save twice	Bug
SLIDESNET-40968	EMF image is not properly written as SVG	Bug
SLIDESNET-40393	Bullets appeared when export into PPT	Bug
SLIDESNET-38424	Graphic elements changed converting from pptx to pdf	Bug
SLIDESNET-33602	PowerPoint 2010 Equations are transformed to image upon save	Bug

Public API Changes

Presentation Shapes Alignment Support

Description

This new feature helps to change the placement of selected shapes on the slide. Align shapes to the margins or the edge of the slide or align them relative to each other.

To provide support of PowerPoint options from the picture above a new overloaded SlideUtil.AlignShapes method and ShapesAlignmentType enum have been added.

ShapesAlignmentType Enum

The ShapesAlignmentType determines the way to align shapes.

Possible values for the ShapesAlignmentType enum: AlignLeft, AlignRight, AlignCenter, AlignTop, AlignMiddle, AlignBottom, DistributeHorizontally, DistributeVertically.

SlideUtil.AlignShape() Method

The method changes the placement of selected shapes on the slide. Input parameters:

• ShapesAlignmentType alignmentType - determines which type of alignment will be applied.
• bool alignToSlide - if true, shapes will be aligned relative to the slide edges. Otherwise, shapes will be aligned relative to each other.
• IBaseSlide slide - parent slide.
• int[] shapeIndexes - indexes of shapes to be aligned.
• IShapeCollection shapes - a collection of shapes to be aligned.

Example:

Let’s say we want to align shapes with indexes 1, 2, and 4 along the top border of the slide. Below is a code snippet of how to achieve that.

Example:

using (Presentation pres = new Presentation("example.pptx"))
{
    ISlide slide = pres.Slides[0];
    IShape shape1 = slide.Shapes[1];
    IShape shape2 = slide.Shapes[2];
    IShape shape3 = slide.Shapes[4];
    SlideUtil.AlignShapes(ShapesAlignmentType.AlignTop, **true**, pres.Slides[0], **new** int[]
    {
            slide.Shapes.IndexOf(shape1),
            slide.Shapes.IndexOf(shape2),
            slide.Shapes.IndexOf(shape3)
    });
}

Example:

Another option shows how to align the entire collection of shapes on the slide:

using (Presentation pres = new Presentation("example.pptx"))
{
    SlideUtil.AlignShapes(ShapesAlignmentType.AlignBottom, false, pres.Slides[0].Shapes);
}

Check the Write Protection Password via IPresentationInfo Interface

IsWriteProtected property and CheckWriteProtection method have been added to IPresentationInfo interface and PresentationInfo class. This property and method allow checking whether a presentation is protected by a password to modify. The password to modify is intended to set write protection on the presentation. Write protection restricts the ability to save the presentation to the same path using host applications.

Property and method declarations:

/// <summary>
/// Gets a value that indicates whether a binded presentation is write protected.
/// </summary>
/// <remarks>
/// If the presentation is protected by a password to open, the property value equals NotDefined.
/// See <see cref="NullableBool"/> enumeration.
/// </remarks>
NullableBool IsWriteProtected { **get**; }

/// <summary>
/// Checks whether a password to modify is correct for a write protected presentation.
/// </summary>
/// <param name="password">The password to check.</param>
/// <returns>
/// True if the presentation is write protected and the password is correct. False otherwise.
/// </returns>
/// <remarks>
/// 1. You should check the <see cref="IsWriteProtected"/> property before calling this method.
/// 2. When password is null or empty, this method returns false.
/// </remarks>
/// <exception cref="InvalidOperationException"/>
bool CheckWriteProtection(string password);

Example:

The example below demonstrates how to check the password to modify the presentation:

IPresentationInfo info = PresentationFactory.Instance.GetPresentationInfo(presentationFilePath); bool isWriteProtectedByPassword = info.IsWriteProtected == NullableBool.True && info.CheckWriteProtection(“my_password”);

Check the Write Protection Password via IProtectionManager Interface

CheckWriteProtection method has been added to the IProtectionManager interface and ProtectionManager class. This method allows checking whether a presentation is protected by a password to modify. The password to modify is intended to set write protection on the presentation. Write protection restricts the ability to save the presentation to the same path using host applications.

Method declaration:

/// <summary>
/// Determines whether a presentation is a password protected to modify.
/// </summary>
/// <param name="password">The password for checking.</param>
/// <returns>True if the password is valid; otherwise, false.</returns>
/// <remarks>
/// 1. You should check the <see cref="IsWriteProtected"/> property before calling this method.
/// 2. When the password is null or empty, this method returns false.
/// </remarks>
bool CheckWriteProtection(string password);

Example:

The example below demonstrates how to check a password to modify a presentation:

using (var presentation = new Presentation(presentationFilePath))
{
`   `bool isWriteProtected = presentation.ProtectionManager.CheckWriteProtection("my_password");
}

Check Presentation Open Protection via IPresentationInfo Interface

IsPasswordProtected property has been added to IPresentationInfo interface and PresentationInfo class. This property allows checking whether a presentation is protected to open. The presentation has protection to open when a password is set to the document.

Property declaration:

/// <summary>
/// Gets a value that indicates whether a binded presentation is protected by a password to open.
/// </summary>
bool IsPasswordProtected { get; }

Example:

The example below demonstrates how to check protection to open:

IPresentationInfo info = PresentationFactory.Instance.GetPresentationInfo(presentationFilePath);
if (info.IsPasswordProtected)
{
`    `Console.WriteLine("The presentation '" + presentationFilePath + "' is protected by password to open.");
}