Aspose.Slides for Java 20.5 Release Notes

Presentation pres = new Presentation();
try {
    // Create DigitalSignature object with PFX file and PFX password 
    DigitalSignature signature = new DigitalSignature("testsignature1.pfx", "testpass1");

    // Comment new digital signature
    signature.setComments("Aspose.Slides digital signing test.");

    // Add digital signature to presentation
    pres.getDigitalSignatures().add(signature);

    // Save presentation
    pres.save("SomePresentationSigned.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

// Open presentation
Presentation pres = new Presentation("SomePresentationSigned.pptx");
try {
    if (pres.getDigitalSignatures().size() > 0)
    {
        boolean allSignaturesAreValid = true;

        System.out.println("Signatures used to sign the presentation: ");

        // Check if all digital signatures are valid
        for (IDigitalSignature signature : pres.getDigitalSignatures())
        {
            System.out.println(signature.getComments() + ", "
                + signature.getSignTime().toString() + " -- " + (signature.isValid() ? "VALID" : "INVALID"));
            allSignaturesAreValid &= signature.isValid();
        }

        if (allSignaturesAreValid)
            System.out.println("Presentation is genuine, all signatures are valid.");
        else 
            System.out.println("Presentation has been modified since signing.");
    }
} finally {
    if (pres != null) pres.dispose();
}

/**
  * <p>
  * Represents a collection of digital signatures attached to a document.
  * </p>
  */
public interface IDigitalSignatureCollection extends IGenericCollection<IDigitalSignature>
{
    /**
      * <p>
      * Returns the signature by index.
      * </p>
      */
    public IDigitalSignature get_Item(int index);

    /**
      * <p>
      * Adds the signature at the end of collection.
      * </p>
      * @param digitalSignature Signature to add.
      */
    public void add(IDigitalSignature digitalSignature);

    /**
      * <p>
      * Removes the signature at the specified index.
      * </p>
      * @param index Index of the signature that should be deleted.
      */
    public void removeAt(int index);

    /**
      * <p>
      * Removes all signatures from collection.
      * </p>
      */
    public void clear();
}

/**
   * <p>
   * Digital signature in signed file.
   * </p>
   */
public interface IDigitalSignature 
{
    /**
    * <p>
    * Certificate object that was used to sign the document.
    * Read-only {@link byte[]}.
    * </p>
    */
    public byte[] getCertificate();

    /**
    * <p>
    * If this digital signature is valid and the document has not been tampered with, this value will be true.
    * Read-only {@code boolean}.
    * </p>
    */
    public boolean isValid();

    /**
    * <p>
    * The time when the document was signed.
    * Read-only {@link java.util.Date}.
    * </p>
    */
    public java.util.Date getSignTime();


    /**
    * <p>
    * The purpose of signature.
    * Read/write {@link String}.
    * </p>
    */
    public String getComments();
    public void setComments(String value);
}

/**
   * <p>
   * Returns the collection of signatures used to sign the presentation.
   * Read-only {@link IDigitalSignatureCollection}.
   * </p>
   */
public final IDigitalSignatureCollection getDigitalSignatures()

/**
   * <p>
   * Gets a value that indicates whether a binded presentation is write protected.
   * </p>
   * If the presentation is protected by a password to open, the property value equals NotDefined.
   * See {@link NullableBool} enumeration.
   */
public byte isWriteProtected();

/**
   * <p>
   * Checks whether a password to modify is correct for a write protected presentation.
   * </p>
   * @return
   * True if the presentation is write protected and the password is correct. False otherwise.
   * @exception InvalidOperationException
   * If a presentation is protected by a password to open or format does not support write protection
   * @param password The password to check.
   * <p>
   * 1. You should check the {@code IsWriteProtected}({@link #isWriteProtected}) property before calling this method.
   * 2. When password is null or empty, this method returns false.
   * </p>
   */
public boolean checkWriteProtection(String password);

IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo(presentationFilePath);
boolean isWriteProtectedByPassword = info.isWriteProtected() == NullableBool.True && info.checkWriteProtection("my_password");

/**
   * <p>
   * Determines whether a presentation is a password protected to modify.
   * </p>
   * @return True if the password is valid; otherwise, false.
   * @param password The password for checking.
   * <p>
   * 1. You should check the {@code isWriteProtected}({@link #isWriteProtected}) method before calling this method.
   * 2. When the password is null or empty, this method returns false.
   * </p>
   */
public boolean checkWriteProtection(String password);

Presentation presentation = new Presentation(presentationFilePath);
try {
    boolean isWriteProtected = presentation.getProtectionManager().checkWriteProtection("my_password");
} finally {
    if (presentation != null) presentation.dispose();
}

/**
   * <p>
   * Gets a value that indicates whether a binded presentation is protected by a password to open.
   * </p>
   */
public boolean isPasswordProtected();

IPresentationInfo info = PresentationFactory.getInstance().getPresentationInfo(presentationFilePath);
if (info.isPasswordProtected())
{
    System.out.println("The presentation '" + presentationFilePath + "' is protected by password to open.");
}

Presentation pres = new Presentation("example.pptx");
try {
    ISlide slide = pres.getSlides().get_Item(0);
    IShape shape1 = slide.getShapes().get_Item(1);
    IShape shape2 = slide.getShapes().get_Item(2);
    IShape shape3 = slide.getShapes().get_Item(4);
    SlideUtil.alignShapes(ShapesAlignmentType.AlignTop, true, pres.getSlides().get_Item(0), new int[]
      {
        slide.getShapes().indexOf(shape1),
        slide.getShapes().indexOf(shape2),
        slide.getShapes().indexOf(shape3)
      });
} finally {
    if (pres != null) pres.dispose();
}

Presentation pres = new Presentation("example.pptx");
try {
    SlideUtil.alignShapes(ShapesAlignmentType.AlignBottom, false, pres.getSlides().get_Item(0).getShapes());
} finally {
    if (pres != null) pres.dispose();
}