Aspose.Slides for .NET 20.5 Release Notes

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.");
}