Aspose.Slides for Java 24.11 Release Notes

/**
 * <p>
 * Returns or sets the grid spacing that should be used for the grid underlying the presentation document, in points. 
 * Read/write float.
 * </p>
 * The following sample code shows how to change the grid spacing in a PowerPoint presentation.
 * <pre>
 * Presentation pres = new Presentation();
 * try {
 *     pres.getViewProperties().setGridSpacing(72f);
 *     pres.save("GridSpacing.pptx", SaveFormat.Pptx);
 * } finally {
 *     if (pres != null) pres.dispose();
 * }
 * </pre>
 * The grid spacing value must be a positive number.
 * The typical value range is from 1 mm (2.8349607 points) to 2 inches (144 points).
 */
public float getGridSpacing();

/**
 * <p>
 * Represents an adjustable drawing guide.
 * </p>
 */
public interface IDrawingGuide
{
    /**
     * <p>
     * Returns or sets orientation of the drawing guide.
     * Read/write {@link Orientation}.
     * </p>
     */
    public byte getOrientation();
    public void setOrientation(byte value);

    /**
     * <p>
     * Returns or sets position of the drawing guide in points from the top, left corner of the slide.
     * Read/write float.
     * </p><p>
     * The typical value range is from zero to slide height for a horizontal guide and from zero to slide width for a vertical guide.
     * </p>
     */
    public float getPosition();
    public void setPosition(float value);
}

/**
 * <p>
 * Represents a collection of the adjustable drawing guides.
 * </p>
 */
public interface IDrawingGuidesCollection extends IGenericEnumerable<IDrawingGuide>
{
    /**
     * <p>
     * Returns the drawing guide by index.
     * Read-only {@link IDrawingGuide}.
     * </p>
     */
    public IDrawingGuide get_Item(int index);

    /**
     * <p>
     * Adds the drawing guide at the end of the collection.
     * </p>
     * @param orientation Orientation of the drawing guide.
     * @param position Position of the the drawing guide in points.
     */
    public IDrawingGuide add(byte orientation, float position);

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

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

    /**
     * <p>
     * Gets the number of all elements in the collection.
     * Read-only int.
     * </p>
     */
    public int getCount();
}

/**
 * <p>
 * Returns the collection of the drawing guides.
 * Read-only {@link IDrawingGuidesCollection}
 * </p>
 * The following sample code shows how to add the new drawing guides in a PowerPoint presentation.
 * <pre>
 * Presentation pres = new Presentation();
 * try {
 *     Dimension2D slideSize = pres.getSlideSize().getSize();
 *
 *     IDrawingGuidesCollection guides = pres.getViewProperties().getSlideViewProperties().getDrawingGuides();
 *     // Adding the new vertical drawing guide to the right of the slide center
 *     guides.add(Orientation.Vertical, (float)(slideSize.getWidth() / 2) + 12.5f);
 *     // Adding the new horizontal drawing guide below the slide center
 *     guides.add(Orientation.Horizontal, (float)(slideSize.getHeight() / 2) + 12.5f);
 *
 *     pres.save("DrawingGuides_out.pptx", SaveFormat.Pptx);
 * } finally {
 *     if (pres != null) pres.dispose();
 * }
 * </pre>
 */
public IDrawingGuidesCollection getDrawingGuides();

Presentation pres = new Presentation();
try {
    pres.getViewProperties().setGridSpacing(72f);
    pres.save("GridSpacing_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Presentation pres = new Presentation();
try {
    Dimension2D slideSize = pres.getSlideSize().getSize();

    IDrawingGuidesCollection guides = pres.getViewProperties().getSlideViewProperties().getDrawingGuides();
    // Adding the new vertical drawing guide to the right of the slide center
    guides.add(Orientation.Vertical, (float)(slideSize.getWidth() / 2) + 12.5f);
    // Adding the new horizontal drawing guide below the slide center
    guides.add(Orientation.Horizontal, (float)(slideSize.getHeight() / 2) + 12.5f);

    pres.save("DrawingGuides_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}